@midscene/test 1.15.3 → 1.15.4-beta-20261013083552.0

package/dist/es/cli/index.mjs

@@ -1,292 +1,467 @@
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { pathToFileURL } from "node:url";
-import { require as api_require } from "tsx/cjs/api";
+import { z } from "zod/v4";
+import { appendFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve as external_node_path_resolve, sep } from "node:path";
 import { NodeRegistry, WorkflowError, WorkflowExecutionFailure, WorkflowParseError, WorkflowPublicationError, asExecutionError, buildTestRunReportDump, buildTestRunReportPlan, classifyWorkflowDocumentFormat, collectTestRunReportSources, createProjectRuntime, decideRetry, isFatalDeviceError, isReportSecretKey, isResourceRecoveryError, normalizeSteps, observeResourceOperations, runConcurrentJobs, runDocumentAttempts, runWorkflowDocument, sanitizeReportError, sanitizeReportText } from "@midscene/core/internal/test-runner";
-import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { globSync } from "tinyglobby";
 import { createHash, randomUUID } from "node:crypto";
 import { JSON_SCHEMA, load } from "js-yaml";
 import { mkdir, writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { require as api_require } from "tsx/cjs/api";
 import { setMaxListeners } from "node:events";
 import { TestRunReportAssembler, calculateTestRunHealth } from "@midscene/core/report";
 import { getDebug } from "@midscene/shared/logger";
-const registry_NodeRegistry = NodeRegistry;
-const projectIdFromIndex = (index)=>`project-${index}`;
-const defineTestProject = (definition)=>definition;
-const defineProjectSetup = (definition)=>definition;
-const getDefaultExport = (loaded, absolutePath)=>{
-    if ('object' == typeof loaded && null !== loaded && 'default' in loaded) {
-        const defaultExport = loaded.default;
-        if ('object' == typeof defaultExport && null !== defaultExport && '__esModule' in defaultExport) {
-            if ('default' in defaultExport) return defaultExport.default;
-            throw new TypeError(`Midscene config "${absolutePath}" must have a default export.`);
-        }
-        return defaultExport;
-    }
-    throw new TypeError(`Midscene config "${absolutePath}" must have a default export.`);
-};
-const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
-const rejectUnknownKeys = (value, allowedKeys, label)=>{
-    const allowed = new Set(allowedKeys);
-    const unknown = Object.keys(value).find((key)=>!allowed.has(key));
-    if (unknown) throw new TypeError(`Midscene config ${label}.${unknown} is not supported.`);
-};
-const isAbsolutePattern = (pattern)=>isAbsolute(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith('\\\\');
-const validatePatterns = (value, field, label = 'files', allowEmptyInclude = false)=>{
-    if (!Array.isArray(value)) throw new TypeError(`Midscene config ${label}.${field} must be an array.`);
-    if ('include' === field && 0 === value.length && !allowEmptyInclude) throw new TypeError(`Midscene config ${label}.include must be a non-empty array.`);
-    return value.map((pattern, index)=>{
-        if ('string' != typeof pattern || 0 === pattern.trim().length) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be a non-empty string.`);
-        if (isAbsolutePattern(pattern)) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be relative to the project root.`);
-        if (pattern.split(/[\\/]/).includes('..')) throw new TypeError(`Midscene config ${label}.${field}[${index}] must not contain a ".." path segment.`);
-        if (pattern.includes('\\')) throw new TypeError(`Midscene config ${label}.${field}[${index}] must use POSIX path separators (/).`);
-        if (pattern.startsWith('!')) {
-            if ('include' === field) throw new TypeError(`Midscene config ${label}.include[${index}] must not be a negated pattern. Use files.exclude instead.`);
-            throw new TypeError(`Midscene config ${label}.exclude[${index}] must not be a negated pattern.`);
-        }
-        return pattern;
-    });
-};
-const validateTestFileSelection = (value, label = 'files')=>{
-    if (void 0 === value) return;
-    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
-    rejectUnknownKeys(value, [
-        'include',
-        'exclude'
-    ], label);
-    const include = validatePatterns(value.include, 'include', label);
-    const exclude = void 0 === value.exclude ? void 0 : validatePatterns(value.exclude, 'exclude', label);
-    return Object.freeze({
-        include: Object.freeze(include),
-        ...exclude ? {
-            exclude: Object.freeze(exclude)
-        } : {}
-    });
-};
-const validateTagList = (value, field, label)=>{
-    if (void 0 === value) return [];
-    if (!Array.isArray(value)) throw new TypeError(`Midscene config ${label}.${field} must be an array.`);
-    return value.map((tag, index)=>{
-        if ('string' != typeof tag || 0 === tag.trim().length) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be a non-empty string.`);
-        return tag;
-    });
-};
-const validateTagSelection = (value, label)=>{
-    if (void 0 === value) return Object.freeze({
-        include: [],
-        exclude: []
-    });
-    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
-    return Object.freeze({
-        include: Object.freeze(validateTagList(value.include, 'include', label)),
-        exclude: Object.freeze(validateTagList(value.exclude, 'exclude', label))
-    });
-};
-function assertJsonValue(value, path, seen) {
-    if (null === value || 'string' == typeof value || 'boolean' == typeof value) return;
-    if ('number' == typeof value) {
-        if (Number.isFinite(value)) return;
-        throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
-    }
-    if ('object' != typeof value || void 0 === value) throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
-    if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && null !== Object.getPrototypeOf(value)) throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
-    if (seen.has(value)) throw new TypeError(`Midscene config ${path} must not contain cycles.`);
-    seen.add(value);
-    if (Array.isArray(value)) value.forEach((item, index)=>assertJsonValue(item, `${path}[${index}]`, seen));
-    else for (const [key, child] of Object.entries(value))assertJsonValue(child, `${path}.${key}`, seen);
-    seen.delete(value);
-}
-const deepFreezeJson = (value)=>{
-    if ('object' == typeof value && null !== value) {
-        for (const child of Object.values(value))deepFreezeJson(child);
-        Object.freeze(value);
-    }
-    return value;
-};
-const validateVariables = (value, label)=>{
-    if (void 0 === value) return Object.freeze({});
-    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
-    assertJsonValue(value, label, new Set());
-    return deepFreezeJson(value);
-};
-const validateSetup = (value, label)=>{
-    if (void 0 === value) return;
-    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
-    rejectUnknownKeys(value, [
-        'name',
-        'setup'
-    ], label);
-    if ('string' != typeof value.name || 0 === value.name.trim().length) throw new TypeError(`Midscene config ${label}.name must be non-empty.`);
-    if ('function' != typeof value.setup) throw new TypeError(`Midscene config ${label}.setup must be a function.`);
-    return value;
-};
-const validatePositiveInteger = (value, fallback, label)=>{
-    if (void 0 === value) return fallback;
-    if (!Number.isInteger(value) || value <= 0) throw new TypeError(`Midscene config ${label} must be a positive integer.`);
-    return value;
-};
-const validateNonNegativeInteger = (value, fallback, label)=>{
-    if (void 0 === value) return fallback;
-    if (!Number.isInteger(value) || value < 0) throw new TypeError(`Midscene config ${label} must be a non-negative integer.`);
-    return value;
-};
-const validateExecutionProjects = (value, defaultSetup, globalNodes)=>{
-    if (void 0 === value) {
-        const setup = validateSetup(defaultSetup, 'setup');
-        return {
-            hasExplicitProjects: false,
-            projects: Object.freeze([
-                Object.freeze({
-                    projectId: projectIdFromIndex(0),
-                    name: 'default',
-                    ...setup ? {
-                        setup
-                    } : {},
-                    tags: Object.freeze({
-                        include: [],
-                        exclude: []
-                    }),
-                    retry: 0,
-                    variables: Object.freeze({}),
-                    nodes: new registry_NodeRegistry(globalNodes.definitions())
-                })
-            ])
-        };
-    }
-    if (void 0 !== defaultSetup) throw new TypeError('Midscene config setup cannot be used together with projects. Move setup to projects[].setup.');
-    if (!Array.isArray(value) || 0 === value.length) throw new TypeError('Midscene config projects must be a non-empty array when declared.');
-    const names = new Set();
-    const projects = value.map((candidate, index)=>{
-        const label = `projects[${index}]`;
-        if (!isRecord(candidate)) throw new TypeError(`Midscene config ${label} must be an object.`);
-        rejectUnknownKeys(candidate, [
-            'name',
-            'setup',
-            'nodes',
-            'files',
-            'tags',
+const isSafeResultPathSegment = (value)=>'string' == typeof value && /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(value);
+const json = z.lazy(()=>z.union([
+        z["null"](),
+        z.string(),
+        z.number().finite(),
+        z.boolean(),
+        z.array(json),
+        z.record(z.string(), json)
+    ]));
+const time = z.string().refine((value)=>Number.isFinite(Date.parse(value)));
+const executor_runtime_schema_count = z.number().int().nonnegative();
+const executor_runtime_schema_value = z.strictObject({
+    value: json,
+    truncatedPaths: z.array(z.string()).optional(),
+    redactedPaths: z.array(z.string()).optional()
+});
+const reportErrorSchema = z.lazy(()=>z.strictObject({
+        format: z.literal('midscene-error').optional(),
+        name: z.string(),
+        message: z.string(),
+        code: z.string().optional(),
+        details: executor_runtime_schema_value.optional(),
+        cause: reportErrorSchema.optional(),
+        errors: z.array(reportErrorSchema).optional(),
+        truncated: z.boolean().optional()
+    }));
+const executor_runtime_schema_operation = z.strictObject({
+    operationId: z.string().min(1),
+    scopeId: z.string().optional(),
+    stepId: z.string().optional(),
+    node: z.string().optional()
+});
+const cleanupSchema = z.strictObject({
+    status: z["enum"]([
+        'not-required',
+        'completed',
+        'pending',
+        'failed'
+    ]),
+    capturedAt: time,
+    operationId: z.string().optional(),
+    blockingOperations: z.array(executor_runtime_schema_operation).optional(),
+    error: reportErrorSchema.optional()
+});
+const pendingOperationsSchema = z.array(executor_runtime_schema_operation);
+const collectionStatus = z["enum"]([
+    'complete',
+    'partial',
+    'unknown'
+]);
+const metricsSchema = z.strictObject({
+    modelCallCount: executor_runtime_schema_count,
+    modelTimeMs: z.number().finite().nonnegative(),
+    promptTokens: executor_runtime_schema_count,
+    cachedInputTokens: executor_runtime_schema_count,
+    completionTokens: executor_runtime_schema_count,
+    totalTokens: executor_runtime_schema_count,
+    collection: z.strictObject({
+        status: collectionStatus,
+        expectedExecutionCount: executor_runtime_schema_count,
+        capturedExecutionCount: executor_runtime_schema_count,
+        reasons: z.array(z.string()),
+        fields: z.strictObject({
+            modelCallCount: collectionStatus,
+            modelTimeMs: collectionStatus,
+            totalTokens: collectionStatus
+        }).optional()
+    }).optional()
+});
+const operationsSchema = z.strictObject({
+    capturedAt: time,
+    events: z.array(z.strictObject({
+        operationId: z.string().min(1),
+        operationKind: z["enum"]([
+            'node',
+            'resource',
+            'acquisition',
+            'cleanup',
+            'readiness'
+        ]),
+        kind: z["enum"]([
+            'started',
+            'cancel-requested',
+            'settled',
+            'runner-returned',
+            'cleanup-deferred'
+        ]),
+        at: time,
+        stepId: z.string().optional(),
+        scopeId: z.string().optional(),
+        node: z.string().optional(),
+        status: z["enum"]([
+            'success',
+            'failed',
+            'not-run'
+        ]).optional(),
+        pending: z.boolean().optional(),
+        error: reportErrorSchema.optional(),
+        blockingOperations: z.array(executor_runtime_schema_operation).optional()
+    }))
+});
+const runtimeResultFields = {
+    executionStatus: z["enum"]([
+        'success',
+        'failed',
+        'not-run'
+    ]).optional(),
+    phases: z.partialRecord(z["enum"]([
+        'beforeAll',
+        'beforeEach',
+        'steps',
+        'afterEach',
+        'afterAll'
+    ]), z.strictObject({
+        status: z["enum"]([
+            'success',
+            'failed',
+            'not-run',
+            'not-required'
+        ]),
+        plannedStepCount: executor_runtime_schema_count,
+        executedStepCount: executor_runtime_schema_count
+    })).optional(),
+    cleanup: cleanupSchema.optional(),
+    pendingOperations: pendingOperationsSchema.optional(),
+    retryDecision: z.strictObject({
+        scope: z["enum"]([
+            'case',
+            'document'
+        ]),
+        retryCount: executor_runtime_schema_count,
+        attemptIndex: executor_runtime_schema_count,
+        decision: z["enum"]([
             'retry',
-            'variables'
-        ], label);
-        if ('string' != typeof candidate.name || 0 === candidate.name.trim().length) throw new TypeError(`Midscene config ${label}.name must be non-empty.`);
-        if (names.has(candidate.name)) throw new TypeError(`Midscene config project name "${candidate.name}" must be unique.`);
-        names.add(candidate.name);
-        const files = validateTestFileSelection(candidate.files, `${label}.files`);
-        if (void 0 !== candidate.nodes && !Array.isArray(candidate.nodes)) throw new TypeError(`Midscene config ${label}.nodes must be an array.`);
-        const localNodes = new registry_NodeRegistry(candidate.nodes);
-        const nodes = new registry_NodeRegistry([
-            ...globalNodes.definitions().filter((node)=>!localNodes.has(node.name)),
-            ...localNodes.definitions()
-        ]);
-        return Object.freeze({
-            projectId: projectIdFromIndex(index),
-            name: candidate.name,
-            nodes,
-            ...files ? {
-                files
-            } : {},
-            tags: validateTagSelection(candidate.tags, `${label}.tags`),
-            retry: validateNonNegativeInteger(candidate.retry, 0, `${label}.retry`),
-            variables: validateVariables(candidate.variables, `${label}.variables`),
-            ...void 0 === candidate.setup ? {} : {
-                setup: validateSetup(candidate.setup, `${label}.setup`)
-            }
-        });
-    });
-    return {
-        projects: Object.freeze(projects),
-        hasExplicitProjects: true
-    };
-};
-const validateTestOptions = (value)=>{
-    if (void 0 !== value && !isRecord(value)) throw new TypeError('Midscene config test must be an object.');
-    const candidate = value ?? {};
-    return Object.freeze({
-        maxConcurrency: validatePositiveInteger(candidate.maxConcurrency, 1, 'test.maxConcurrency'),
-        bail: validateNonNegativeInteger(candidate.bail, 0, 'test.bail'),
-        testTimeout: validatePositiveInteger(candidate.testTimeout, 120000, 'test.testTimeout')
-    });
+            'stop'
+        ]),
+        reason: z["enum"]([
+            'passed',
+            'attempt-failed',
+            'budget-exhausted',
+            'cleanup-pending',
+            'cleanup-failed',
+            'operation-pending',
+            'fatal-error',
+            'interrupted',
+            'bail',
+            'infrastructure-error'
+        ])
+    }).optional()
 };
-const validateOutputPath = (value, fallback, label)=>{
-    if (void 0 === value) return fallback;
-    if ('string' != typeof value || 0 === value.trim().length) throw new TypeError(`Midscene config ${label} must be non-empty.`);
-    return value;
-};
-const validateOutput = (value)=>{
-    if (void 0 !== value && !isRecord(value)) throw new TypeError('Midscene config output must be an object.');
-    const candidate = value ?? {};
-    rejectUnknownKeys(candidate, [
-        'reportDir'
-    ], 'output');
-    return Object.freeze({
-        reportDir: validateOutputPath(candidate.reportDir, './midscene_run/report', 'output.reportDir')
+const plannedStep = z.strictObject({
+    id: z.string(),
+    phase: z["enum"]([
+        'beforeAll',
+        'beforeEach',
+        'steps',
+        'afterEach',
+        'afterAll'
+    ]),
+    stepIndex: executor_runtime_schema_count,
+    node: z.string(),
+    title: z.string().optional(),
+    input: executor_runtime_schema_value,
+    inputMode: z["enum"]([
+        'template',
+        'resolved'
+    ]),
+    timeoutMs: z.number().positive().optional(),
+    continueOnError: z.boolean()
+});
+const documentPlanSchema = z.strictObject({
+    documentId: z.string(),
+    sourcePath: z.string(),
+    sourceYaml: executor_runtime_schema_value.optional(),
+    retry: z.strictObject({
+        scope: z["enum"]([
+            'case',
+            'document'
+        ]),
+        count: executor_runtime_schema_count
+    }),
+    beforeAll: z.array(plannedStep),
+    afterAll: z.array(plannedStep),
+    cases: z.array(z.strictObject({
+        caseId: z.string(),
+        name: z.string(),
+        caseIndex: executor_runtime_schema_count,
+        selected: z.boolean(),
+        tags: z.array(z.string()),
+        onFailure: z["enum"]([
+            'continue',
+            'stop-document'
+        ]).optional(),
+        beforeEach: z.array(plannedStep),
+        steps: z.array(plannedStep),
+        afterEach: z.array(plannedStep)
+    }))
+});
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
     });
-};
-const validateTestProjectDefinition = (definition)=>{
-    if (!isRecord(definition)) throw new TypeError('Midscene config must default export an object.');
-    if (void 0 !== definition.nodes && !Array.isArray(definition.nodes)) throw new TypeError('Midscene config nodes must be an array.');
-    if ('setupWorkflow' in definition) throw new TypeError('Midscene config setupWorkflow is no longer supported. Use setup or projects[].setup instead.');
-    if ('setupDocument' in definition) throw new TypeError('Midscene config setupDocument is not supported. Use setup or projects[].setup for resources, and beforeAll/afterAll for document lifecycle steps.');
-    if ('root' in definition) throw new TypeError('Midscene config root is not supported. Pass the Test Project directory to midscene-test instead.');
-    if ('files' in definition) throw new TypeError('Midscene config files is not supported at the root. Move it to projects[].files.');
-    if ('testRunner' in definition) throw new TypeError('Midscene config testRunner is not supported. Rename it to test.');
-    rejectUnknownKeys(definition, [
-        'setup',
-        'projects',
-        'test',
-        'output',
-        'nodes'
-    ], 'root');
-    const nodes = new registry_NodeRegistry(definition.nodes);
-    const resolvedProjects = validateExecutionProjects(definition.projects, definition.setup, nodes);
-    return {
-        ...resolvedProjects,
-        test: validateTestOptions(definition.test),
-        output: validateOutput(definition.output),
-        nodes,
-        resolveNode: (name)=>nodes.get(name)
-    };
-};
-const assertSupportedConfig = (absolutePath)=>{
-    if (!absolutePath.endsWith('.ts') && !absolutePath.endsWith('.mjs')) {
-        const extension = absolutePath.match(/(\.[^./\\]+)$/)?.[1] ?? '(none)';
-        throw new TypeError(`Unsupported Midscene config extension: ${extension}. Supported extensions: .ts, .mjs.`);
+    else obj[key] = value;
+    return obj;
+}
+class TestExecutorError extends Error {
+    constructor(message, options = {}){
+        super(message, {
+            cause: options.cause
+        }), _define_property(this, "kind", void 0), _define_property(this, "retryable", void 0);
+        this.name = 'TestExecutorError';
+        this.kind = options.kind ?? 'unknown';
+        this.retryable = options.retryable ?? false;
     }
-    return absolutePath.endsWith('.mjs') ? '.mjs' : '.ts';
-};
-const canRetryWithCjsLoader = (error)=>{
-    if (!(error instanceof Error)) return false;
-    const errorCode = error.code;
-    return error instanceof SyntaxError && /^Unexpected (?:identifier|reserved word|token)/.test(error.message) || 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX' === errorCode || 'ERR_UNKNOWN_FILE_EXTENSION' === errorCode && /^Unknown file extension\b/.test(error.message);
-};
-async function loadTestProject(configPath) {
-    if (!configPath) return validateTestProjectDefinition({
-        nodes: []
-    });
-    const absolutePath = resolve(configPath);
-    const extension = assertSupportedConfig(absolutePath);
-    let loaded;
-    try {
-        if ('.mjs' === extension) loaded = await import(pathToFileURL(absolutePath).href);
-        else {
-            const { tsImport } = await import("tsx/esm/api");
-            loaded = await tsImport(pathToFileURL(absolutePath).href, {
-                parentURL: pathToFileURL(`${dirname(absolutePath)}${sep}`).href,
-                tsconfig: false
-            });
-        }
-    } catch (error) {
-        try {
-            if ('.mjs' === extension || !canRetryWithCjsLoader(error)) throw error;
-            loaded = api_require(absolutePath, pathToFileURL(absolutePath));
-        } catch (fallbackError) {
-            const message = fallbackError instanceof Error ? `: ${fallbackError.message}` : '';
-            throw new Error(`Failed to load Midscene config "${absolutePath}"${message}`, {
-                cause: fallbackError
-            });
-        }
+}
+const defineTestExecutor = (executor)=>executor;
+const localTestExecutor = Object.freeze({
+    name: 'local',
+    execute: (_task, context)=>context.runLocal()
+});
+const jsonValueSchema = z.lazy(()=>z.union([
+        z["null"](),
+        z.string(),
+        z.number().finite(),
+        z.boolean(),
+        z.array(jsonValueSchema),
+        z.record(z.string(), jsonValueSchema)
+    ]));
+const timestampSchema = z.string().refine((value)=>Number.isFinite(Date.parse(value)), {
+    message: 'Expected an ISO-compatible timestamp.'
+});
+const errorSchema = z.strictObject({
+    format: z.literal('midscene-error').optional(),
+    cause: reportErrorSchema.optional(),
+    name: z.string().min(1),
+    message: z.string(),
+    code: z.string().min(1),
+    details: jsonValueSchema.optional()
+});
+const stepBaseSchema = z.strictObject({
+    phase: z["enum"]([
+        'beforeAll',
+        'beforeEach',
+        'steps',
+        'afterEach',
+        'afterAll'
+    ]),
+    stepIndex: z.number().int().nonnegative(),
+    node: z.string().min(1),
+    input: jsonValueSchema,
+    meta: z.strictObject({
+        timeoutMs: z.number().positive().finite().optional(),
+        continueOnError: z.boolean()
+    }),
+    continuedAfterError: z.boolean(),
+    waitForPreviousOperationMs: z.number().nonnegative().finite().optional(),
+    operations: operationsSchema.optional(),
+    output: z.strictObject({
+        summary: z.string().optional(),
+        data: jsonValueSchema.optional()
+    }).optional(),
+    error: errorSchema.optional(),
+    report: z.strictObject({
+        traces: z.array(z.strictObject({
+            type: z.literal('midscene-execution'),
+            executionId: z.string().min(1),
+            metrics: metricsSchema.optional()
+        })),
+        collectionErrors: z.array(errorSchema).optional()
+    }).optional()
+});
+const stepSchema = z.discriminatedUnion('status', [
+    stepBaseSchema.extend({
+        status: z["enum"]([
+            'success',
+            'failed'
+        ]),
+        startedAt: timestampSchema,
+        endedAt: timestampSchema,
+        durationMs: z.number().nonnegative().finite()
+    }),
+    stepBaseSchema.extend({
+        status: z.literal('not-run'),
+        notRunReason: z.string().min(1),
+        blockedBy: z.string().optional()
+    })
+]);
+const validatedStepSchema = stepSchema.superRefine((step, context)=>{
+    if ('success' === step.status && (step.error || step.continuedAfterError)) context.addIssue({
+        code: 'custom',
+        message: 'Successful steps cannot contain failure evidence.'
+    });
+    if (step.continuedAfterError && !step.meta.continueOnError) context.addIssue({
+        code: 'custom',
+        message: 'Continuation requires continueOnError.'
+    });
+});
+const attemptSchema = z.strictObject({
+    ...runtimeResultFields,
+    caseId: z.string().min(1),
+    runId: z.string().min(1),
+    projectName: z.string().min(1),
+    attemptIndex: z.number().int().nonnegative(),
+    name: z.string(),
+    sourcePath: z.string().min(1),
+    caseIndex: z.number().int().nonnegative(),
+    status: z["enum"]([
+        'success',
+        'failed'
+    ]),
+    beforeEach: z.array(validatedStepSchema),
+    steps: z.array(validatedStepSchema),
+    afterEach: z.array(validatedStepSchema),
+    executionErrors: z.array(errorSchema).optional(),
+    teardownErrors: z.array(errorSchema).optional(),
+    reportRefs: z.array(z.string().min(1)).optional(),
+    startedAt: timestampSchema,
+    endedAt: timestampSchema,
+    durationMs: z.number().nonnegative().finite()
+});
+const notRunReasonSchema = z["enum"]([
+    'document-start-failed',
+    'project-preflight-failed',
+    'project-setup-failed',
+    'interrupted',
+    'bail',
+    'fatal-error',
+    'executor-failed',
+    'cleanup-pending',
+    'cleanup-failed',
+    'operation-pending'
+]);
+const resultSchema = z.strictObject({
+    case: z.strictObject({
+        documentId: z.string().min(1),
+        caseId: z.string().min(1),
+        projectName: z.string().min(1),
+        name: z.string(),
+        sourcePath: z.string().min(1),
+        caseIndex: z.number().int().nonnegative(),
+        status: z["enum"]([
+            'success',
+            'failed',
+            'not-run'
+        ]),
+        run: attemptSchema.optional(),
+        attempts: z.array(attemptSchema).optional(),
+        notRunReason: notRunReasonSchema.optional()
+    }),
+    document: z.strictObject({
+        ...runtimeResultFields,
+        plan: documentPlanSchema.optional(),
+        attemptIndex: z.number().int().nonnegative().optional(),
+        hostErrors: z.array(z.strictObject({
+            phase: z["enum"]([
+                'setup',
+                'execution',
+                'cleanup',
+                'report',
+                'publication',
+                'observer'
+            ]),
+            error: reportErrorSchema
+        })).optional(),
+        documentId: z.string().min(1),
+        documentRunId: z.string().min(1),
+        projectId: z.string().min(1),
+        projectName: z.string().min(1),
+        sourcePath: z.string().min(1),
+        status: z["enum"]([
+            'success',
+            'failed'
+        ]),
+        startedAt: timestampSchema,
+        endedAt: timestampSchema,
+        durationMs: z.number().nonnegative().finite(),
+        beforeAll: z.array(validatedStepSchema),
+        afterAll: z.array(validatedStepSchema),
+        executionErrors: z.array(errorSchema).optional(),
+        teardownErrors: z.array(errorSchema).optional(),
+        reportRefs: z.array(z.string().min(1)).optional()
+    }).optional(),
+    lifecycle: z.strictObject({
+        cleanup: cleanupSchema.optional(),
+        pendingOperations: pendingOperationsSchema.optional(),
+        projectName: z.string().min(1),
+        status: z["enum"]([
+            'success',
+            'failed'
+        ]),
+        setupError: errorSchema.optional(),
+        teardownErrors: z.array(errorSchema).optional(),
+        startedAt: timestampSchema,
+        endedAt: timestampSchema,
+        durationMs: z.number().nonnegative().finite()
+    }).optional(),
+    artifacts: z.array(z.strictObject({
+        name: z.string().min(1),
+        uri: z.string().min(1),
+        mediaType: z.string().min(1).optional()
+    })).optional(),
+    metadata: z.record(z.string(), z.union([
+        z.string(),
+        z.number().finite(),
+        z.boolean(),
+        z["null"]()
+    ])).optional()
+});
+const attemptMatchesTask = (task, attempt)=>attempt.caseId === task.caseId && attempt.projectName === task.projectName && attempt.name === task.caseName && attempt.sourcePath === task.sourcePath && attempt.caseIndex === task.caseIndex && isSafeResultPathSegment(attempt.runId);
+const hasUnfinishedWork = (result)=>void 0 !== result.executionStatus && 'success' !== result.executionStatus || void 0 !== result.cleanup && ![
+        'completed',
+        'not-required'
+    ].includes(result.cleanup.status) || (result.pendingOperations?.length ?? 0) > 0;
+function assertTestCaseTaskRunResult(task, value) {
+    const parsed = resultSchema.safeParse(value);
+    if (!parsed.success) throw new TypeError(`Executor returned invalid transport data for ${task.caseId}: ${z.prettifyError(parsed.error)}`);
+    const outcome = parsed.data.case;
+    if (outcome.caseId !== task.caseId || outcome.documentId !== task.documentId || outcome.projectName !== task.projectName || outcome.name !== task.caseName || outcome.sourcePath !== task.sourcePath || outcome.caseIndex !== task.caseIndex) throw new Error(`Executor returned a result that does not match task ${task.caseId}.`);
+    const attempts = outcome.attempts ?? [];
+    for (const attempt of attempts){
+        const steps = [
+            ...attempt.beforeEach,
+            ...attempt.steps,
+            ...attempt.afterEach
+        ];
+        if ('success' === attempt.status && (0 === attempt.steps.length || (attempt.executionErrors?.length ?? 0) > 0 || steps.some((step)=>'success' !== step.status) || hasUnfinishedWork(attempt) || (attempt.teardownErrors?.length ?? 0) > 0)) throw new TypeError(`Executor returned an inconsistent successful attempt for ${task.caseId}.`);
     }
-    return validateTestProjectDefinition(getDefaultExport(loaded, absolutePath));
+    if (new Set(attempts.map((attempt)=>attempt.runId)).size !== attempts.length) throw new TypeError(`Executor returned duplicate attempt IDs for ${task.caseId}.`);
+    if (attempts.some((attempt)=>!attemptMatchesTask(task, attempt))) throw new TypeError(`Executor returned invalid attempts for ${task.caseId}.`);
+    if (attempts.some((attempt, index)=>attempt.attemptIndex !== index) || attempts.length > task.retry + 1) throw new TypeError(`Executor returned a non-sequential attempt history for ${task.caseId}.`);
+    const finalAttempt = attempts.at(-1);
+    if ('not-run' === outcome.status) {
+        if (outcome.run || attempts.length || !outcome.notRunReason) throw new TypeError(`Executor returned an inconsistent not-run result for ${task.caseId}.`);
+    } else if (void 0 !== outcome.notRunReason || !outcome.run || !finalAttempt || finalAttempt.status !== outcome.status || outcome.run.runId !== finalAttempt.runId || JSON.stringify(outcome.run) !== JSON.stringify(finalAttempt) || attempts.slice(0, -1).some((attempt)=>'failed' !== attempt.status)) throw new TypeError(`Executor returned an inconsistent ${outcome.status} result for ${task.caseId}.`);
+    const reportRefs = [
+        ...attempts.flatMap((attempt)=>attempt.reportRefs ?? []),
+        ...parsed.data.document?.reportRefs ?? []
+    ];
+    if (reportRefs.some((reference)=>!isSafeResultPathSegment(reference))) throw new TypeError(`Executor returned an invalid report reference for ${task.caseId}.`);
+    const document = parsed.data.document;
+    if (document?.status === 'success' && (hasUnfinishedWork(document) || (document.hostErrors?.length ?? 0) > 0 || (document.executionErrors?.length ?? 0) > 0 || [
+        ...document.beforeAll,
+        ...document.afterAll
+    ].some((step)=>'success' !== step.status) || (document.teardownErrors?.length ?? 0) > 0)) throw new TypeError(`Executor returned an inconsistent successful document for ${task.caseId}.`);
+    const lifecycle = parsed.data.lifecycle;
+    if (lifecycle?.status === 'success' && (hasUnfinishedWork(lifecycle) || lifecycle.setupError || (lifecycle.teardownErrors?.length ?? 0) > 0)) throw new TypeError(`Executor returned an inconsistent successful lifecycle for ${task.caseId}.`);
+    if (document && (document.documentId !== task.documentId || document.projectId !== task.projectId || document.projectName !== task.projectName || document.sourcePath !== task.sourcePath || !isSafeResultPathSegment(document.documentRunId))) throw new Error(`Executor returned a document that does not match task ${task.caseId}.`);
+    if (parsed.data.lifecycle && parsed.data.lifecycle.projectName !== task.projectName) throw new Error(`Executor returned a lifecycle that does not match task ${task.caseId}.`);
 }
 const createCaseInvocationId = (projectId, sourcePath, caseIndex, invocationIndex = 0)=>createHash('sha256').update(JSON.stringify([
         projectId,
@@ -410,7 +585,7 @@ const resolveWorkflowVariables = (value, options)=>{
         ]));
     return value;
 };
-function _define_property(obj, key, value) {
+function collect_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
         enumerable: true,
@@ -427,11 +602,11 @@ class NativeWorkflowFormatError extends WorkflowParseError {
             sourcePath,
             actualFormat,
             expectedFormat: 'native'
-        }), _define_property(this, "actualFormat", void 0);
+        }), collect_define_property(this, "actualFormat", void 0);
         this.actualFormat = actualFormat;
     }
 }
-const collect_rejectUnknownKeys = (value, allowed, label)=>{
+const rejectUnknownKeys = (value, allowed, label)=>{
     const allowedSet = new Set(allowed);
     const unknown = Object.keys(value).filter((key)=>!allowedSet.has(key));
     if (unknown.length) throw new WorkflowParseError(`${label} has unsupported field "${unknown[0]}".`, {
@@ -453,7 +628,7 @@ function collectWorkflowDocument(source, options) {
     if (!isMapping(parsed)) throw new WorkflowParseError('Workflow document must be a mapping.');
     const format = classifyWorkflowDocumentFormat(parsed);
     if ('legacy' === format || 'legacy-batch' === format || 'mixed' === format) throw new NativeWorkflowFormatError(format, source.sourcePath);
-    collect_rejectUnknownKeys(parsed, [
+    rejectUnknownKeys(parsed, [
         'beforeAll',
         'beforeEach',
         'cases',
@@ -506,11 +681,16 @@ function collectWorkflowDocument(source, options) {
         if (!isMapping(definition)) throw new WorkflowParseError(`Case ${caseIndex + 1} must be a mapping.`, {
             caseIndex
         });
-        collect_rejectUnknownKeys(definition, [
+        rejectUnknownKeys(definition, [
+            'id',
             'name',
             'tags',
+            'resources',
             'steps'
         ], `Case ${caseIndex + 1}`);
+        if (void 0 !== definition.id && !isSafeResultPathSegment(definition.id)) throw new WorkflowParseError(`Case ${caseIndex + 1} id must start with an ASCII letter or number, contain only letters, numbers, dots, underscores, or hyphens, and be at most 128 characters.`, {
+            caseIndex
+        });
         if ('string' != typeof definition.name || 0 === definition.name.trim().length) throw new WorkflowParseError(`Case ${caseIndex + 1} name must be a non-empty string.`, {
             caseIndex
         });
@@ -521,6 +701,13 @@ function collectWorkflowDocument(source, options) {
         if (!Array.isArray(tags) || tags.some((tag)=>'string' != typeof tag || 0 === tag.trim().length)) throw new WorkflowParseError(`Case ${caseIndex + 1} tags must be an array of non-empty strings.`, {
             caseIndex
         });
+        const resources = definition.resources ?? [];
+        if (!Array.isArray(resources) || resources.some((resource)=>'string' != typeof resource || 0 === resource.trim().length)) throw new WorkflowParseError(`Case ${caseIndex + 1} resources must be an array of non-empty strings.`, {
+            caseIndex
+        });
+        if (new Set(resources).size !== resources.length) throw new WorkflowParseError(`Case ${caseIndex + 1} resources must not contain duplicates.`, {
+            caseIndex
+        });
         const steps = normalize_normalizeSteps(definition.steps, options.resolveNode).map((normalized, stepIndex)=>{
             if (!options.resolveNode(normalized.node)) throw new WorkflowParseError(`Case ${caseIndex + 1} step ${stepIndex + 1} references unknown node "${normalized.node}".`, {
                 caseIndex,
@@ -529,7 +716,7 @@ function collectWorkflowDocument(source, options) {
             });
             return resolveStepVariables(normalized, 'steps', stepIndex, caseIndex);
         });
-        const caseId = createCaseId(source.projectId, sourcePath, caseIndex);
+        const caseId = 'string' == typeof definition.id ? definition.id : createCaseId(source.projectId, sourcePath, caseIndex);
         if (ids.has(caseId)) throw new WorkflowParseError(`Case id collision: ${caseId}.`, {
             caseId
         });
@@ -540,8 +727,14 @@ function collectWorkflowDocument(source, options) {
             sourcePath,
             caseIndex,
             definition: {
+                ...'string' == typeof definition.id ? {
+                    id: definition.id
+                } : {},
                 name: definition.name,
                 tags: tags,
+                ...resources.length > 0 ? {
+                    resources: resources
+                } : {},
                 steps
             }
         };
@@ -681,6 +874,38 @@ const writeTestProjectRunResult = (options)=>{
                         ...outcome.notRunReason ? {
                             notRunReason: outcome.notRunReason
                         } : {},
+                        ...outcome.execution ? {
+                            execution: {
+                                executor: outcome.execution.executor,
+                                resources: outcome.execution.resources,
+                                ...void 0 === outcome.execution.attempts ? {} : {
+                                    attempts: outcome.execution.attempts
+                                },
+                                ...outcome.execution.failure ? {
+                                    failure: outcome.execution.failure
+                                } : {},
+                                ...outcome.execution.artifacts ? {
+                                    artifacts: outcome.execution.artifacts
+                                } : {},
+                                ...outcome.execution.metadata ? {
+                                    metadata: outcome.execution.metadata
+                                } : {},
+                                ...outcome.execution.lifecycle ? {
+                                    lifecycle: {
+                                        status: outcome.execution.lifecycle.status,
+                                        startedAt: outcome.execution.lifecycle.startedAt,
+                                        endedAt: outcome.execution.lifecycle.endedAt,
+                                        durationMs: outcome.execution.lifecycle.durationMs,
+                                        ...outcome.execution.lifecycle.setupError ? {
+                                            setupError: errorJson(outcome.execution.lifecycle.setupError)
+                                        } : {},
+                                        ...outcome.execution.lifecycle.teardownErrors ? {
+                                            teardownErrors: outcome.execution.lifecycle.teardownErrors.map(errorJson)
+                                        } : {}
+                                    }
+                                } : {}
+                            }
+                        } : {},
                         ...outcome.attempts ? {
                             attempts: outcome.attempts.map((attempt)=>({
                                     attemptId: attempt.runId,
@@ -737,6 +962,306 @@ const writeTestProjectRunResult = (options)=>{
             }))
     });
 };
+const registry_NodeRegistry = NodeRegistry;
+const projectIdFromIndex = (index)=>`project-${index}`;
+const defineTestProject = (definition)=>definition;
+const defineProjectSetup = (definition)=>definition;
+const getDefaultExport = (loaded, absolutePath)=>{
+    if ('object' == typeof loaded && null !== loaded && 'default' in loaded) {
+        const defaultExport = loaded.default;
+        if ('object' == typeof defaultExport && null !== defaultExport && '__esModule' in defaultExport) {
+            if ('default' in defaultExport) return defaultExport.default;
+            throw new TypeError(`Midscene config "${absolutePath}" must have a default export.`);
+        }
+        return defaultExport;
+    }
+    throw new TypeError(`Midscene config "${absolutePath}" must have a default export.`);
+};
+const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const test_project_rejectUnknownKeys = (value, allowedKeys, label)=>{
+    const allowed = new Set(allowedKeys);
+    const unknown = Object.keys(value).find((key)=>!allowed.has(key));
+    if (unknown) throw new TypeError(`Midscene config ${label}.${unknown} is not supported.`);
+};
+const isAbsolutePattern = (pattern)=>isAbsolute(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith('\\\\');
+const validatePatterns = (value, field, label = 'files', allowEmptyInclude = false)=>{
+    if (!Array.isArray(value)) throw new TypeError(`Midscene config ${label}.${field} must be an array.`);
+    if ('include' === field && 0 === value.length && !allowEmptyInclude) throw new TypeError(`Midscene config ${label}.include must be a non-empty array.`);
+    return value.map((pattern, index)=>{
+        if ('string' != typeof pattern || 0 === pattern.trim().length) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be a non-empty string.`);
+        if (isAbsolutePattern(pattern)) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be relative to the project root.`);
+        if (pattern.split(/[\\/]/).includes('..')) throw new TypeError(`Midscene config ${label}.${field}[${index}] must not contain a ".." path segment.`);
+        if (pattern.includes('\\')) throw new TypeError(`Midscene config ${label}.${field}[${index}] must use POSIX path separators (/).`);
+        if (pattern.startsWith('!')) {
+            if ('include' === field) throw new TypeError(`Midscene config ${label}.include[${index}] must not be a negated pattern. Use files.exclude instead.`);
+            throw new TypeError(`Midscene config ${label}.exclude[${index}] must not be a negated pattern.`);
+        }
+        return pattern;
+    });
+};
+const validateTestFileSelection = (value, label = 'files')=>{
+    if (void 0 === value) return;
+    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
+    test_project_rejectUnknownKeys(value, [
+        'include',
+        'exclude'
+    ], label);
+    const include = validatePatterns(value.include, 'include', label);
+    const exclude = void 0 === value.exclude ? void 0 : validatePatterns(value.exclude, 'exclude', label);
+    return Object.freeze({
+        include: Object.freeze(include),
+        ...exclude ? {
+            exclude: Object.freeze(exclude)
+        } : {}
+    });
+};
+const validateTagList = (value, field, label)=>{
+    if (void 0 === value) return [];
+    if (!Array.isArray(value)) throw new TypeError(`Midscene config ${label}.${field} must be an array.`);
+    return value.map((tag, index)=>{
+        if ('string' != typeof tag || 0 === tag.trim().length) throw new TypeError(`Midscene config ${label}.${field}[${index}] must be a non-empty string.`);
+        return tag;
+    });
+};
+const validateTagSelection = (value, label)=>{
+    if (void 0 === value) return Object.freeze({
+        include: [],
+        exclude: []
+    });
+    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
+    return Object.freeze({
+        include: Object.freeze(validateTagList(value.include, 'include', label)),
+        exclude: Object.freeze(validateTagList(value.exclude, 'exclude', label))
+    });
+};
+function assertJsonValue(value, path, seen) {
+    if (null === value || 'string' == typeof value || 'boolean' == typeof value) return;
+    if ('number' == typeof value) {
+        if (Number.isFinite(value)) return;
+        throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
+    }
+    if ('object' != typeof value || void 0 === value) throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
+    if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && null !== Object.getPrototypeOf(value)) throw new TypeError(`Midscene config ${path} must be JSON-compatible.`);
+    if (seen.has(value)) throw new TypeError(`Midscene config ${path} must not contain cycles.`);
+    seen.add(value);
+    if (Array.isArray(value)) value.forEach((item, index)=>assertJsonValue(item, `${path}[${index}]`, seen));
+    else for (const [key, child] of Object.entries(value))assertJsonValue(child, `${path}.${key}`, seen);
+    seen.delete(value);
+}
+const deepFreezeJson = (value)=>{
+    if ('object' == typeof value && null !== value) {
+        for (const child of Object.values(value))deepFreezeJson(child);
+        Object.freeze(value);
+    }
+    return value;
+};
+const validateVariables = (value, label)=>{
+    if (void 0 === value) return Object.freeze({});
+    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
+    assertJsonValue(value, label, new Set());
+    return deepFreezeJson(value);
+};
+const validateSetup = (value, label)=>{
+    if (void 0 === value) return;
+    if (!isRecord(value)) throw new TypeError(`Midscene config ${label} must be an object.`);
+    test_project_rejectUnknownKeys(value, [
+        'name',
+        'setup'
+    ], label);
+    if ('string' != typeof value.name || 0 === value.name.trim().length) throw new TypeError(`Midscene config ${label}.name must be non-empty.`);
+    if ('function' != typeof value.setup) throw new TypeError(`Midscene config ${label}.setup must be a function.`);
+    return value;
+};
+const validatePositiveInteger = (value, fallback, label)=>{
+    if (void 0 === value) return fallback;
+    if (!Number.isInteger(value) || value <= 0) throw new TypeError(`Midscene config ${label} must be a positive integer.`);
+    return value;
+};
+const validateNonNegativeInteger = (value, fallback, label)=>{
+    if (void 0 === value) return fallback;
+    if (!Number.isInteger(value) || value < 0) throw new TypeError(`Midscene config ${label} must be a non-negative integer.`);
+    return value;
+};
+const validateExecutionProjects = (value, defaultSetup, globalNodes)=>{
+    if (void 0 === value) {
+        const setup = validateSetup(defaultSetup, 'setup');
+        return {
+            hasExplicitProjects: false,
+            projects: Object.freeze([
+                Object.freeze({
+                    projectId: projectIdFromIndex(0),
+                    name: 'default',
+                    ...setup ? {
+                        setup
+                    } : {},
+                    tags: Object.freeze({
+                        include: [],
+                        exclude: []
+                    }),
+                    retry: 0,
+                    variables: Object.freeze({}),
+                    nodes: new registry_NodeRegistry(globalNodes.definitions())
+                })
+            ])
+        };
+    }
+    if (void 0 !== defaultSetup) throw new TypeError('Midscene config setup cannot be used together with projects. Move setup to projects[].setup.');
+    if (!Array.isArray(value) || 0 === value.length) throw new TypeError('Midscene config projects must be a non-empty array when declared.');
+    const names = new Set();
+    const projects = value.map((candidate, index)=>{
+        const label = `projects[${index}]`;
+        if (!isRecord(candidate)) throw new TypeError(`Midscene config ${label} must be an object.`);
+        test_project_rejectUnknownKeys(candidate, [
+            'name',
+            'setup',
+            'nodes',
+            'files',
+            'tags',
+            'retry',
+            'variables'
+        ], label);
+        if ('string' != typeof candidate.name || 0 === candidate.name.trim().length) throw new TypeError(`Midscene config ${label}.name must be non-empty.`);
+        if (names.has(candidate.name)) throw new TypeError(`Midscene config project name "${candidate.name}" must be unique.`);
+        names.add(candidate.name);
+        const files = validateTestFileSelection(candidate.files, `${label}.files`);
+        if (void 0 !== candidate.nodes && !Array.isArray(candidate.nodes)) throw new TypeError(`Midscene config ${label}.nodes must be an array.`);
+        const localNodes = new registry_NodeRegistry(candidate.nodes);
+        const nodes = new registry_NodeRegistry([
+            ...globalNodes.definitions().filter((node)=>!localNodes.has(node.name)),
+            ...localNodes.definitions()
+        ]);
+        return Object.freeze({
+            projectId: projectIdFromIndex(index),
+            name: candidate.name,
+            nodes,
+            ...files ? {
+                files
+            } : {},
+            tags: validateTagSelection(candidate.tags, `${label}.tags`),
+            retry: validateNonNegativeInteger(candidate.retry, 0, `${label}.retry`),
+            variables: validateVariables(candidate.variables, `${label}.variables`),
+            ...void 0 === candidate.setup ? {} : {
+                setup: validateSetup(candidate.setup, `${label}.setup`)
+            }
+        });
+    });
+    return {
+        projects: Object.freeze(projects),
+        hasExplicitProjects: true
+    };
+};
+const validateTestOptions = (value)=>{
+    if (void 0 !== value && !isRecord(value)) throw new TypeError('Midscene config test must be an object.');
+    const candidate = value ?? {};
+    const executionUnit = candidate.executionUnit ?? 'project';
+    if ('project' !== executionUnit && 'case' !== executionUnit) throw new TypeError('Midscene config test.executionUnit must be "project" or "case".');
+    return Object.freeze({
+        maxConcurrency: validatePositiveInteger(candidate.maxConcurrency, 1, 'test.maxConcurrency'),
+        bail: validateNonNegativeInteger(candidate.bail, 0, 'test.bail'),
+        testTimeout: validatePositiveInteger(candidate.testTimeout, 120000, 'test.testTimeout'),
+        executionUnit,
+        executorRetry: validateNonNegativeInteger(candidate.executorRetry, 0, 'test.executorRetry')
+    });
+};
+const validateTestExecutor = (value)=>{
+    if (void 0 === value) return;
+    if (!isRecord(value)) throw new TypeError('Midscene config executor must be an object.');
+    test_project_rejectUnknownKeys(value, [
+        'name',
+        'execute'
+    ], 'executor');
+    if ('string' != typeof value.name || 0 === value.name.trim().length) throw new TypeError('Midscene config executor.name must be non-empty.');
+    if ('function' != typeof value.execute) throw new TypeError('Midscene config executor.execute must be a function.');
+    return Object.freeze(value);
+};
+const validateOutputPath = (value, fallback, label)=>{
+    if (void 0 === value) return fallback;
+    if ('string' != typeof value || 0 === value.trim().length) throw new TypeError(`Midscene config ${label} must be non-empty.`);
+    return value;
+};
+const validateOutput = (value)=>{
+    if (void 0 !== value && !isRecord(value)) throw new TypeError('Midscene config output must be an object.');
+    const candidate = value ?? {};
+    test_project_rejectUnknownKeys(candidate, [
+        'reportDir'
+    ], 'output');
+    return Object.freeze({
+        reportDir: validateOutputPath(candidate.reportDir, './midscene_run/report', 'output.reportDir')
+    });
+};
+const validateTestProjectDefinition = (definition)=>{
+    if (!isRecord(definition)) throw new TypeError('Midscene config must default export an object.');
+    if (void 0 !== definition.nodes && !Array.isArray(definition.nodes)) throw new TypeError('Midscene config nodes must be an array.');
+    if ('setupWorkflow' in definition) throw new TypeError('Midscene config setupWorkflow is no longer supported. Use setup or projects[].setup instead.');
+    if ('setupDocument' in definition) throw new TypeError('Midscene config setupDocument is not supported. Use setup or projects[].setup for resources, and beforeAll/afterAll for document lifecycle steps.');
+    if ('root' in definition) throw new TypeError('Midscene config root is not supported. Pass the Test Project directory to midscene-test instead.');
+    if ('files' in definition) throw new TypeError('Midscene config files is not supported at the root. Move it to projects[].files.');
+    if ('testRunner' in definition) throw new TypeError('Midscene config testRunner is not supported. Rename it to test.');
+    test_project_rejectUnknownKeys(definition, [
+        'setup',
+        'projects',
+        'test',
+        'output',
+        'nodes',
+        'executor'
+    ], 'root');
+    const nodes = new registry_NodeRegistry(definition.nodes);
+    const resolvedProjects = validateExecutionProjects(definition.projects, definition.setup, nodes);
+    const test = validateTestOptions(definition.test);
+    const executor = validateTestExecutor(definition.executor);
+    if (executor && 'case' !== test.executionUnit) throw new TypeError('Midscene config executor requires test.executionUnit to be "case".');
+    return {
+        ...resolvedProjects,
+        test,
+        output: validateOutput(definition.output),
+        nodes,
+        ...executor ? {
+            executor
+        } : {},
+        resolveNode: (name)=>nodes.get(name)
+    };
+};
+const assertSupportedConfig = (absolutePath)=>{
+    if (!absolutePath.endsWith('.ts') && !absolutePath.endsWith('.mjs')) {
+        const extension = absolutePath.match(/(\.[^./\\]+)$/)?.[1] ?? '(none)';
+        throw new TypeError(`Unsupported Midscene config extension: ${extension}. Supported extensions: .ts, .mjs.`);
+    }
+    return absolutePath.endsWith('.mjs') ? '.mjs' : '.ts';
+};
+const canRetryWithCjsLoader = (error)=>{
+    if (!(error instanceof Error)) return false;
+    const errorCode = error.code;
+    return error instanceof SyntaxError && /^Unexpected (?:identifier|reserved word|token)/.test(error.message) || 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX' === errorCode || 'ERR_UNKNOWN_FILE_EXTENSION' === errorCode && /^Unknown file extension\b/.test(error.message);
+};
+async function loadTestProject(configPath) {
+    if (!configPath) return validateTestProjectDefinition({
+        nodes: []
+    });
+    const absolutePath = external_node_path_resolve(configPath);
+    const extension = assertSupportedConfig(absolutePath);
+    let loaded;
+    try {
+        if ('.mjs' === extension) loaded = await import(pathToFileURL(absolutePath).href);
+        else {
+            const { tsImport } = await import("tsx/esm/api");
+            loaded = await tsImport(pathToFileURL(absolutePath).href, {
+                parentURL: pathToFileURL(`${dirname(absolutePath)}${sep}`).href,
+                tsconfig: false
+            });
+        }
+    } catch (error) {
+        try {
+            if ('.mjs' === extension || !canRetryWithCjsLoader(error)) throw error;
+            loaded = api_require(absolutePath, pathToFileURL(absolutePath));
+        } catch (fallbackError) {
+            const message = fallbackError instanceof Error ? `: ${fallbackError.message}` : '';
+            throw new Error(`Failed to load Midscene config "${absolutePath}"${message}`, {
+                cause: fallbackError
+            });
+        }
+    }
+    return validateTestProjectDefinition(getDefaultExport(loaded, absolutePath));
+}
 const CONFIG_NAMES = [
     'midscene.config.ts',
     'midscene.config.mjs'
@@ -758,8 +1283,29 @@ const DEFAULT_TEST_FILE_SELECTION = {
     ]
 };
 const project_preparation_toPosix = (value)=>value.split(sep).join('/');
+const discoverSelectedTestFiles = (projectRoot, paths)=>{
+    const root = external_node_path_resolve(projectRoot);
+    const files = new Set();
+    for (const requestedPath of paths){
+        if ('string' != typeof requestedPath || 0 === requestedPath.trim().length) throw new TypeError('Test selection paths must be non-empty strings.');
+        const absolutePath = external_node_path_resolve(root, requestedPath);
+        const relativePath = relative(root, absolutePath);
+        if ('..' === relativePath || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath)) throw new Error(`Test selection path is outside the project: ${requestedPath}`);
+        if (!existsSync(absolutePath)) throw new Error(`Test selection path does not exist: ${requestedPath}`);
+        if (statSync(absolutePath).isDirectory()) for (const file of discoverTestFiles(absolutePath))files.add(file);
+        else if (/\.ya?ml$/i.test(absolutePath)) files.add(absolutePath);
+        else throw new Error(`Test selection file must be YAML: ${requestedPath}`);
+    }
+    return [
+        ...files
+    ].sort((a, b)=>{
+        const relativeA = project_preparation_toPosix(relative(root, a));
+        const relativeB = project_preparation_toPosix(relative(root, b));
+        return relativeA < relativeB ? -1 : relativeA > relativeB ? 1 : 0;
+    });
+};
 const discoverResolvedTestFiles = (projectRoot, selection)=>{
-    const root = resolve(projectRoot);
+    const root = external_node_path_resolve(projectRoot);
     const match = (patterns)=>globSync(patterns, {
             absolute: true,
             caseSensitiveMatch: false,
@@ -775,7 +1321,7 @@ const discoverResolvedTestFiles = (projectRoot, selection)=>{
         }).filter((file)=>/\.ya?ml$/i.test(file));
     const files = match(selection.include);
     return [
-        ...new Set(files.map((file)=>resolve(file)))
+        ...new Set(files.map((file)=>external_node_path_resolve(file)))
     ].sort((a, b)=>{
         const relativeA = project_preparation_toPosix(relative(root, a));
         const relativeB = project_preparation_toPosix(relative(root, b));
@@ -788,7 +1334,7 @@ const discoverTestFiles = (projectRoot, selection = DEFAULT_TEST_FILE_SELECTION)
     return discoverResolvedTestFiles(projectRoot, normalized);
 };
 const discoverTestConfig = (projectRoot)=>{
-    const root = resolve(projectRoot);
+    const root = external_node_path_resolve(projectRoot);
     const candidates = readdirSync(root).filter((name)=>name.startsWith(CONFIG_PREFIX)).sort();
     const supported = candidates.filter((name)=>CONFIG_NAMES.includes(name));
     const unsupported = candidates.filter((name)=>!CONFIG_NAMES.includes(name));
@@ -817,8 +1363,14 @@ const matchesTags = (tags, selection)=>{
     if (selection.exclude.some((tag)=>tags.includes(tag))) return false;
     return 0 === selection.include.length || selection.include.some((tag)=>tags.includes(tag));
 };
-const filterDocumentCases = (document, project)=>{
-    const cases = document.cases.filter((item)=>matchesTags(item.definition.tags ?? [], project.tags));
+const filterDocumentCases = (document, project, selection)=>{
+    const cases = document.cases.filter((item)=>{
+        const tags = item.definition.tags ?? [];
+        return matchesTags(tags, project.tags) && matchesTags(tags, {
+            include: selection?.tags?.include ?? [],
+            exclude: selection?.tags?.exclude ?? []
+        }) && (!selection?.caseIds?.length || selection.caseIds.includes(item.caseId));
+    });
     const filtered = document.cases.length - cases.length;
     return 0 === cases.length ? {
         filtered
@@ -842,8 +1394,10 @@ const selectProjects = (projects, names)=>{
 async function prepareProject(project, projectRoot, runDir, defaultTimeoutMs, options = {}) {
     const platform = options.platform?.trim();
     const fileSelection = project.files ?? DEFAULT_TEST_FILE_SELECTION;
-    const prerequisiteFile = options.prerequisiteFile ? resolve(options.prerequisiteFile) : void 0;
-    const mainFiles = options.files ?? discoverResolvedTestFiles(projectRoot, fileSelection);
+    const prerequisiteFile = options.prerequisiteFile ? external_node_path_resolve(options.prerequisiteFile) : void 0;
+    const projectFiles = options.files ?? discoverResolvedTestFiles(projectRoot, fileSelection);
+    const selectedFiles = options.selection?.paths?.length ? new Set(discoverSelectedTestFiles(projectRoot, options.selection.paths)) : void 0;
+    const mainFiles = selectedFiles ? projectFiles.filter((file)=>selectedFiles.has(file)) : projectFiles;
     const files = [
         ...prerequisiteFile ? [
             prerequisiteFile
@@ -866,6 +1420,7 @@ async function prepareProject(project, projectRoot, runDir, defaultTimeoutMs, op
     const invocations = [];
     const plans = [];
     let filteredCaseCount = 0;
+    const availableCaseIds = new Set();
     if (0 === sources.length) {
         const error = asCollectionError(project.projectId, project.name, '<project>', new WorkflowParseError(`No workflow YAML files found for project "${project.name}" in ${projectRoot}.`, {
             projectName: project.name,
@@ -896,10 +1451,16 @@ async function prepareProject(project, projectRoot, runDir, defaultTimeoutMs, op
             variables: project.variables,
             env: process.env
         });
+        const duplicate = document.cases.find((item)=>availableCaseIds.has(item.caseId));
+        if (duplicate) throw new WorkflowParseError(`Case id collision in project "${project.name}": ${duplicate.caseId}.`, {
+            caseId: duplicate.caseId,
+            projectName: project.name
+        });
+        for (const item of document.cases)availableCaseIds.add(item.caseId);
         const filtered = source.absolutePath === prerequisiteFile ? {
             document,
             filtered: 0
-        } : filterDocumentCases(document, project);
+        } : filterDocumentCases(document, project, options.selection);
         const plan = buildTestRunReportPlan(document, {
             selectedCaseIds: filtered.document?.cases.map((item)=>item.caseId) ?? [],
             defaultTimeoutMs,
@@ -947,9 +1508,42 @@ async function prepareProject(project, projectRoot, runDir, defaultTimeoutMs, op
         plans,
         collectionErrors,
         selectedCaseCount: documents.reduce((total, document)=>total + document.cases.length, 0),
-        filteredCaseCount
+        filteredCaseCount,
+        availableCaseIds: [
+            ...availableCaseIds
+        ]
     };
 }
+const validateUniqueStrings = (values, label)=>{
+    if (void 0 === values) return;
+    if (!Array.isArray(values) || values.some((value)=>'string' != typeof value || 0 === value.trim().length)) throw new TypeError(`${label} must be an array of non-empty strings.`);
+    if (new Set(values).size !== values.length) throw new TypeError(`${label} must not contain duplicates.`);
+    return values;
+};
+const validateRunSelection = (options)=>{
+    const paths = validateUniqueStrings(options.paths, 'Test selection paths');
+    const caseIds = validateUniqueStrings(options.caseIds, 'Test selection caseIds');
+    const include = validateUniqueStrings(options.tags?.include, 'Test selection tags.include');
+    const exclude = validateUniqueStrings(options.tags?.exclude, 'Test selection tags.exclude');
+    return {
+        ...paths ? {
+            paths
+        } : {},
+        ...caseIds ? {
+            caseIds
+        } : {},
+        ...include || exclude ? {
+            tags: {
+                ...include ? {
+                    include
+                } : {},
+                ...exclude ? {
+                    exclude
+                } : {}
+            }
+        } : {}
+    };
+};
 const padDatePart = (value)=>String(value).padStart(2, '0');
 const createTestRunId = (date = new Date(), uuid = randomUUID())=>{
     const timestamp = [
@@ -966,9 +1560,9 @@ const assertDirectory = (path, label)=>{
     if (!existsSync(path) || !statSync(path).isDirectory()) throw new Error(`${label} does not exist or is not a directory: ${path}`);
 };
 const resolveRunInput = (options)=>{
-    const cwd = resolve(options.cwd ?? process.cwd());
+    const cwd = external_node_path_resolve(options.cwd ?? process.cwd());
     assertDirectory(cwd, 'Test working directory');
-    const inputPath = options.projectRoot ? resolve(cwd, options.projectRoot) : void 0;
+    const inputPath = options.projectRoot ? external_node_path_resolve(cwd, options.projectRoot) : void 0;
     const singleFile = inputPath && existsSync(inputPath) && statSync(inputPath).isFile() ? inputPath : void 0;
     if (singleFile && !/\.ya?ml$/i.test(singleFile)) throw new Error(`Test input must be a YAML file or project directory: ${singleFile}`);
     const cliProjectRoot = singleFile ? dirname(singleFile) : inputPath;
@@ -987,24 +1581,34 @@ async function prepareTestRun(options) {
     const startedAt = new Date();
     const runId = createTestRunId(startedAt);
     const input = resolveRunInput(options);
-    const configPath = options.configPath ? resolve(input.configSearchRoot, options.configPath) : discoverTestConfig(input.configSearchRoot);
+    const selection = validateRunSelection(options);
+    const configPath = options.configPath ? external_node_path_resolve(input.configSearchRoot, options.configPath) : discoverTestConfig(input.configSearchRoot);
     if (options.configPath && /\.ya?ml$/i.test(configPath)) throw new Error(`midscene-test --config only accepts a native TypeScript or JavaScript project config: ${configPath}. Run legacy batch YAML with \`midscene --config ${options.configPath}\`.`);
     if (options.configPath && !existsSync(configPath)) throw new Error(`Midscene config does not exist: ${configPath}`);
     const definition = await loadTestProject(configPath);
-    const resultDir = options.resultDir ? resolve(input.cwd, options.resultDir) : join(input.projectRoot, '.midscene', 'test-results');
+    const resultDir = options.resultDir ? external_node_path_resolve(input.cwd, options.resultDir) : join(input.projectRoot, '.midscene', 'test-results');
     const runDir = join(resultDir, runId);
     const summaryPath = join(runDir, 'summary.json');
-    const reportDir = resolve(input.projectRoot, definition.output.reportDir);
+    const reportDir = external_node_path_resolve(input.projectRoot, definition.output.reportDir);
     mkdirSync(resultDir, {
         recursive: true
     });
     mkdirSync(runDir);
     const projects = [];
-    for (const project of selectProjects(definition.projects, options.projectNames))projects.push(await prepareProject(project, input.projectRoot, runDir, definition.test.testTimeout, input.singleFile ? {
-        files: [
-            input.singleFile
-        ]
-    } : void 0));
+    for (const project of selectProjects(definition.projects, options.projectNames))projects.push(await prepareProject(project, input.projectRoot, runDir, definition.test.testTimeout, {
+        selection,
+        ...input.singleFile ? {
+            files: [
+                input.singleFile
+            ]
+        } : {}
+    }));
+    if (selection.caseIds?.length) {
+        const availableCaseIds = new Set(projects.flatMap((project)=>project.availableCaseIds ?? []));
+        const unknown = selection.caseIds.find((id)=>!availableCaseIds.has(id));
+        if (unknown) throw new Error(`Unknown Midscene case id: ${unknown}`);
+    }
+    if ((selection.paths?.length || selection.caseIds?.length || selection.tags?.include?.length || selection.tags?.exclude?.length) && projects.every((project)=>0 === project.selectedCaseCount && 0 === project.collectionErrors.length)) throw new Error('No Midscene cases matched the requested selection.');
     const hasFormatMismatch = projects.some((project)=>project.collectionErrors.some(({ error })=>error instanceof NativeWorkflowFormatError));
     return {
         startedAt,
@@ -1100,20 +1704,601 @@ async function writeTestResultMarkdown(result, index = emptyIndex()) {
     }));
     return output;
 }
-const stepPosition = (info)=>'case' === info.scope ? info.case : info.document;
+const asNotRun = (documentId, collectedCase, projectName, reason)=>({
+        documentId,
+        caseId: collectedCase.caseId,
+        projectName,
+        name: collectedCase.definition.name,
+        sourcePath: collectedCase.sourcePath,
+        caseIndex: collectedCase.caseIndex,
+        status: 'not-run',
+        notRunReason: reason
+    });
 const formatStep = (info)=>{
-    const position = stepPosition(info);
+    const position = 'case' === info.scope ? info.case : info.document;
     const phase = 'steps' === position.phase ? 'step' : position.phase;
     return `${phase} ${position.stepIndex + 1}/${info.stepCount}: ${info.node}`;
 };
-const formatStepResult = (info, result)=>{
-    const indent = 'case' === info.scope ? '      ' : '    ';
+const formatStepResult = (info, result, indent = '')=>{
     if ('not-run' === result.status) return `${indent}– ${formatStep(info)} (not run: ${result.notRunReason})`;
     const symbol = 'success' === result.status ? '✓' : '✗';
     const error = result.error ? ` — ${result.error.message}` : '';
     const continuation = result.continuedAfterError ? '; continuing' : '';
     return `${indent}${symbol} ${formatStep(info)} (${result.durationMs} ms)${error}${continuation}`;
 };
+const latestById = (items, id)=>[
+        ...new Map(items.map((item)=>[
+                id(item),
+                item
+            ])).values()
+    ];
+const buildProjectResult = (prepared, cases, documents, lifecycle)=>{
+    const { project } = prepared;
+    const projectFailed = prepared.collectionErrors.length > 0 || latestById(cases, (item)=>item.caseId).some((item)=>'success' !== item.status || item.execution?.lifecycle?.status === 'failed') || latestById(documents, (item)=>item.documentId).some((item)=>'failed' === item.status) || lifecycle?.status === 'failed';
+    return {
+        projectId: project.projectId,
+        name: project.name,
+        ...prepared.platform ? {
+            platform: prepared.platform
+        } : {},
+        status: projectFailed ? 'failed' : 'success',
+        retry: project.retry,
+        fileSelection: prepared.fileSelection,
+        tagSelection: project.tags,
+        sourceCount: prepared.sources.length,
+        selectedCaseCount: prepared.selectedCaseCount,
+        filteredCaseCount: prepared.filteredCaseCount,
+        ...lifecycle ? {
+            lifecycle
+        } : {},
+        cases,
+        plans: prepared.plans,
+        documents,
+        collectionErrors: prepared.collectionErrors
+    };
+};
+function createExecutorReports(outputDir) {
+    const paths = new Map();
+    const sources = new Map();
+    return {
+        materializeSource (source) {
+            if (!source.dumpPath) {
+                const reference = this.materialize(source.sourcePath);
+                sources.set(reference, {
+                    sourcePath: this.resolve(reference),
+                    collection: source.collection
+                });
+                return reference;
+            }
+            const dump = realpathSync(source.dumpPath);
+            const reference = randomUUID();
+            const destination = join(outputDir, 'reports', reference);
+            mkdirSync(destination, {
+                recursive: true
+            });
+            const dumpPath = join(destination, 'snapshot.json');
+            cpSync(dump, dumpPath);
+            const screenshots = join(dirname(dump), 'screenshots');
+            if (existsSync(screenshots)) cpSync(screenshots, join(destination, 'screenshots'), {
+                recursive: true,
+                dereference: true
+            });
+            const sourcePath = join(destination, 'index.html');
+            sources.set(reference, {
+                sourcePath,
+                dumpPath,
+                collection: source.collection
+            });
+            paths.set(reference, sourcePath);
+            return reference;
+        },
+        resolveSource (reference) {
+            return sources.get(reference);
+        },
+        materialize (sourcePath) {
+            const source = realpathSync(sourcePath);
+            const entry = statSync(source).isDirectory() ? join(source, 'index.html') : source;
+            if (!statSync(entry).isFile()) throw new TestExecutorError(`Executor report must have a regular HTML entry: ${sourcePath}`, {
+                kind: 'report'
+            });
+            const reference = randomUUID();
+            const destination = join(outputDir, 'reports', reference);
+            mkdirSync(destination, {
+                recursive: true
+            });
+            const isDirectoryReport = 'index.html' === basename(entry);
+            const reportPath = join(destination, isDirectoryReport ? 'index.html' : 'report.html');
+            cpSync(isDirectoryReport ? dirname(entry) : entry, isDirectoryReport ? destination : reportPath, {
+                recursive: isDirectoryReport,
+                dereference: true
+            });
+            if (!isDirectoryReport) {
+                const screenshots = join(dirname(entry), 'screenshots');
+                if (existsSync(screenshots)) cpSync(screenshots, join(destination, 'screenshots'), {
+                    recursive: true,
+                    dereference: true
+                });
+            }
+            paths.set(reference, reportPath);
+            return reference;
+        },
+        resolve (reference) {
+            const reportPath = paths.get(reference);
+            if (!reportPath) throw new TestExecutorError(`Executor returned unknown report reference ${reference}.`, {
+                kind: 'report'
+            });
+            return reportPath;
+        }
+    };
+}
+async function runTaskPool(options) {
+    if (!Number.isInteger(options.maxConcurrency) || options.maxConcurrency <= 0) throw new TypeError('Task scheduler maxConcurrency must be a positive integer.');
+    const pending = options.tasks.map((_, index)=>index);
+    const results = new Array(options.tasks.length);
+    const activeResources = new Set();
+    let active = 0;
+    let firstError;
+    let hasError = false;
+    return await new Promise((resolve, reject)=>{
+        let settled = false;
+        const stopRequested = ()=>hasError || options.signal?.aborted === true || options.shouldStop?.() === true;
+        const finish = ()=>{
+            if (settled) return;
+            settled = true;
+            options.signal?.removeEventListener('abort', pump);
+            if (hasError) reject(firstError);
+            else resolve(results);
+        };
+        const release = (resources)=>{
+            for (const resource of resources)activeResources.delete(resource);
+        };
+        const claimRunnable = ()=>{
+            const pendingIndex = pending.findIndex((taskIndex)=>options.tasks[taskIndex].resources.every((resource)=>!activeResources.has(resource)));
+            if (pendingIndex < 0) return;
+            const [taskIndex] = pending.splice(pendingIndex, 1);
+            return taskIndex;
+        };
+        function pump() {
+            if (settled) return;
+            while(active < options.maxConcurrency && !stopRequested()){
+                const taskIndex = claimRunnable();
+                if (void 0 === taskIndex) break;
+                const task = options.tasks[taskIndex];
+                for (const resource of task.resources)activeResources.add(resource);
+                active += 1;
+                Promise.resolve().then(()=>options.run(task, taskIndex)).then((result)=>{
+                    results[taskIndex] = result;
+                }).catch((error)=>{
+                    if (!hasError) {
+                        hasError = true;
+                        firstError = error;
+                    }
+                }).finally(()=>{
+                    release(task.resources);
+                    active -= 1;
+                    pump();
+                });
+            }
+            if (0 === active && (0 === pending.length || stopRequested())) finish();
+        }
+        options.signal?.addEventListener('abort', pump, {
+            once: true
+        });
+        pump();
+    });
+}
+const isolatedDocumentId = (document, collectedCase)=>`${document.documentId}-case-${collectedCase.caseIndex}`;
+const prepareCaseTasks = (projects)=>projects.flatMap((prepared, projectIndex)=>prepared.documents.flatMap((document)=>document.cases.map((collectedCase)=>{
+                const documentId = isolatedDocumentId(document, collectedCase);
+                return {
+                    projectIndex,
+                    prepared,
+                    document,
+                    collectedCase,
+                    task: Object.freeze({
+                        taskId: `${prepared.project.projectId}:${collectedCase.caseId}`,
+                        projectId: prepared.project.projectId,
+                        projectName: prepared.project.name,
+                        documentId,
+                        sourcePath: collectedCase.sourcePath,
+                        caseId: collectedCase.caseId,
+                        caseName: collectedCase.definition.name,
+                        caseIndex: collectedCase.caseIndex,
+                        tags: Object.freeze([
+                            ...collectedCase.definition.tags ?? []
+                        ]),
+                        resources: Object.freeze([
+                            ...collectedCase.definition.resources ?? []
+                        ]),
+                        retry: prepared.project.retry
+                    })
+                };
+            })));
+const reviveError = (error)=>{
+    const revived = new WorkflowError(error.message, {
+        code: error.code,
+        details: error.details,
+        cause: error.cause
+    });
+    revived.name = error.name;
+    return revived;
+};
+const reviveStep = (step)=>{
+    const { error, output, report, ...base } = step;
+    return {
+        ...base,
+        input: step.input,
+        meta: {
+            ...step.meta
+        },
+        ...output ? {
+            output: {
+                ...output
+            }
+        } : {},
+        ...error ? {
+            error: reviveError(error)
+        } : {},
+        ...report ? {
+            report: {
+                traces: report.traces.map((trace)=>({
+                        ...trace
+                    })),
+                ...report.collectionErrors ? {
+                    collectionErrors: report.collectionErrors.map(reviveError)
+                } : {}
+            }
+        } : {}
+    };
+};
+const reviveAttempt = (attempt)=>{
+    const { executionErrors, teardownErrors, reportRefs, beforeEach, steps, afterEach, ...base } = attempt;
+    return {
+        ...base,
+        beforeEach: beforeEach.map(reviveStep),
+        steps: steps.map(reviveStep),
+        afterEach: afterEach.map(reviveStep),
+        ...executionErrors ? {
+            executionErrors: executionErrors.map(reviveError)
+        } : {},
+        ...teardownErrors ? {
+            teardownErrors: teardownErrors.map(reviveError)
+        } : {}
+    };
+};
+const reviveDocument = (document)=>{
+    const { executionErrors, teardownErrors, reportRefs, beforeAll, afterAll, hostErrors, ...base } = document;
+    return {
+        ...base,
+        ...hostErrors ? {
+            hostErrors: hostErrors.map((error)=>({
+                    ...error
+                }))
+        } : {},
+        beforeAll: beforeAll.map(reviveStep),
+        afterAll: afterAll.map(reviveStep),
+        ...executionErrors ? {
+            executionErrors: executionErrors.map(reviveError)
+        } : {},
+        ...teardownErrors ? {
+            teardownErrors: teardownErrors.map(reviveError)
+        } : {}
+    };
+};
+const reviveLifecycle = (lifecycle)=>{
+    const { setupError, teardownErrors, ...base } = lifecycle;
+    return {
+        ...base,
+        ...setupError ? {
+            setupError: reviveError(setupError)
+        } : {},
+        ...teardownErrors ? {
+            teardownErrors: teardownErrors.map(reviveError)
+        } : {}
+    };
+};
+const toTransportResult = (result, materializeReport, materializeSource)=>{
+    const transportReports = (scope)=>[
+            ...(scope.reportSources ?? []).map(materializeSource),
+            ...(scope.reportPaths ?? []).filter((path)=>!scope.reportSources?.some((source)=>source.sourcePath === path)).map(materializeReport)
+        ];
+    const mapStep = (step)=>{
+        if (!step.report) return step;
+        const { sources: _sources, ...report } = step.report;
+        return {
+            ...step,
+            report
+        };
+    };
+    const mapAttempt = (attempt)=>{
+        const { reportPaths, reportSources, reportScopeId, ...transportAttempt } = attempt;
+        const reportRefs = transportReports(attempt);
+        return {
+            ...transportAttempt,
+            beforeEach: attempt.beforeEach.map(mapStep),
+            steps: attempt.steps.map(mapStep),
+            afterEach: attempt.afterEach.map(mapStep),
+            ...reportRefs.length ? {
+                reportRefs
+            } : {}
+        };
+    };
+    const attempts = result.case.attempts?.map(mapAttempt);
+    const run = attempts?.at(-1);
+    const { run: _run, attempts: _attempts, ...transportCase } = result.case;
+    const document = result.document ? (()=>{
+        const { reportPaths, reportSources, reportScopeId, ...transportDocument } = result.document;
+        const reportRefs = transportReports(result.document);
+        return {
+            ...transportDocument,
+            ...result.document.hostErrors ? {
+                hostErrors: result.document.hostErrors.map(({ phase, error })=>({
+                        phase,
+                        error: sanitizeReportError(error)
+                    }))
+            } : {},
+            beforeAll: result.document.beforeAll.map(mapStep),
+            afterAll: result.document.afterAll.map(mapStep),
+            ...reportRefs.length ? {
+                reportRefs
+            } : {}
+        };
+    })() : void 0;
+    return JSON.parse(JSON.stringify({
+        case: {
+            ...transportCase,
+            ...run ? {
+                run
+            } : {},
+            ...attempts ? {
+                attempts
+            } : {}
+        },
+        ...document ? {
+            document
+        } : {},
+        ...result.lifecycle ? {
+            lifecycle: result.lifecycle
+        } : {}
+    }));
+};
+const fromTransportResult = (result, resolveReportReference, resolveSource)=>{
+    const resolveReports = (refs)=>{
+        const reportPaths = [];
+        const reportSources = [];
+        for (const ref of refs ?? []){
+            const path = resolveReportReference(ref);
+            const source = resolveSource(ref);
+            if (source) reportSources.push(source);
+            else reportPaths.push(path);
+        }
+        return {
+            ...reportPaths.length ? {
+                reportPaths
+            } : {},
+            ...reportSources.length ? {
+                reportSources
+            } : {}
+        };
+    };
+    const attempts = result.case.attempts?.map((attempt)=>({
+            ...reviveAttempt(attempt),
+            ...resolveReports(attempt.reportRefs)
+        }));
+    const run = attempts?.at(-1);
+    const { run: _run, attempts: _attempts, ...caseBase } = result.case;
+    return {
+        case: {
+            ...caseBase,
+            ...run ? {
+                run
+            } : {},
+            ...attempts ? {
+                attempts
+            } : {}
+        },
+        ...result.document ? {
+            document: {
+                ...reviveDocument(result.document),
+                ...resolveReports(result.document.reportRefs)
+            }
+        } : {},
+        ...result.lifecycle ? {
+            lifecycle: reviveLifecycle(result.lifecycle)
+        } : {}
+    };
+};
+const runLocalCase = async (preparedTask, options, taskProgress, materializeReport, materializeSource)=>{
+    const { prepared, document, collectedCase, task } = preparedTask;
+    const { project } = prepared;
+    const isolatedDocument = {
+        ...document,
+        documentId: task.documentId,
+        cases: [
+            collectedCase
+        ]
+    };
+    const runtime = createProjectRuntime({
+        project,
+        setup: project.setup,
+        signal: options.signal
+    });
+    let lifecycle;
+    let execution;
+    let executionError;
+    try {
+        await runtime.start();
+        if (runtime.canRun) execution = await runWorkflowDocument(isolatedDocument, {
+            resolveNode: project.nodes.require.bind(project.nodes),
+            project,
+            projectContext: runtime.context,
+            retry: project.retry,
+            signal: runtime.signal,
+            defaultTimeoutMs: options.test.testTimeout,
+            shouldStop: ()=>options.signal.aborted,
+            stopReason: ()=>'interrupted',
+            isFatalError: (run)=>[
+                    ...run.beforeEach,
+                    ...run.steps,
+                    ...run.afterEach
+                ].some((step)=>step.error && isFatalDeviceError(step.error)) || (run.teardownErrors ?? []).some(isFatalDeviceError),
+            onStepStart: (info)=>taskProgress(`→ ${formatStep(info)}`),
+            onStepResult: (info, result)=>taskProgress(formatStepResult(info, result)),
+            onCaseResult: (attempt)=>taskProgress(`${'success' === attempt.status ? '✓' : '✗'} attempt ${attempt.attemptIndex + 1}/${project.retry + 1}: ${attempt.name} (${attempt.durationMs} ms)`)
+        });
+    } catch (error) {
+        executionError = error;
+        if (error instanceof WorkflowExecutionFailure) execution = error.result;
+    } finally{
+        const failed = void 0 !== executionError || !runtime.canRun || execution?.cases[0]?.status !== 'success' || execution?.document.status === 'failed';
+        lifecycle = await runtime.finish(failed ? 'failed' : 'success');
+    }
+    if (executionError) {
+        if (!execution) throw executionError;
+        options.onInfrastructureError(executionError);
+    }
+    if (!execution) return toTransportResult({
+        case: asNotRun(task.documentId, collectedCase, project.name, options.signal.aborted ? 'interrupted' : 'project-setup-failed'),
+        lifecycle
+    }, materializeReport, materializeSource);
+    const outcome = execution.cases[0];
+    if (!outcome) throw new Error(`Executor did not produce case result for ${task.caseId}.`);
+    return toTransportResult({
+        case: {
+            ...outcome,
+            documentId: task.documentId
+        },
+        document: execution.document,
+        lifecycle
+    }, materializeReport, materializeSource);
+};
+const runCaseTask = async (preparedTask, taskIndex, taskCount, options, onCompleted)=>{
+    const { prepared, task } = preparedTask;
+    const taskProgress = (message)=>options.progress(`[case ${taskIndex + 1}/${taskCount}] ${task.projectName} / ${task.sourcePath} / ${task.caseName}: ${message}`);
+    taskProgress('started');
+    const outputDir = join(options.runDir, task.projectId, 'executor-output', task.documentId, task.caseId);
+    mkdirSync(outputDir, {
+        recursive: true
+    });
+    const { materialize: materializeReport, materializeSource, resolve: resolveReportReference, resolveSource } = createExecutorReports(outputDir);
+    if (prepared.collectionErrors.length > 0) return {
+        case: asNotRun(task.documentId, preparedTask.collectedCase, task.projectName, 'project-preflight-failed')
+    };
+    const executor = options.executor ?? localTestExecutor;
+    let result;
+    let executorFailure;
+    let executorAttempts = 0;
+    for(let attemptIndex = 0; attemptIndex <= options.test.executorRetry; attemptIndex += 1){
+        executorAttempts = attemptIndex + 1;
+        try {
+            result = await executor.execute(task, {
+                signal: options.signal,
+                onProgress: taskProgress,
+                outputDir,
+                materializeReport,
+                runLocal: ()=>runLocalCase(preparedTask, options, taskProgress, materializeReport, materializeSource)
+            });
+            executorFailure = void 0;
+            break;
+        } catch (error) {
+            if (!(error instanceof TestExecutorError)) throw error;
+            executorFailure = error;
+            if (!error.retryable || attemptIndex >= options.test.executorRetry || options.signal.aborted) break;
+            taskProgress(`executor retry ${attemptIndex + 1}/${options.test.executorRetry}: ${error.message}`);
+        }
+    }
+    if (!result) {
+        if (!executorFailure) throw new Error(`Executor did not return a result for ${task.caseId}.`);
+        taskProgress(`executor-failed: ${executorFailure.message}`);
+        return {
+            case: {
+                ...asNotRun(task.documentId, preparedTask.collectedCase, task.projectName, 'executor-failed'),
+                execution: {
+                    executor: executor.name,
+                    resources: task.resources,
+                    attempts: executorAttempts,
+                    failure: {
+                        kind: executorFailure.kind,
+                        message: executorFailure.message,
+                        retryable: executorFailure.retryable
+                    }
+                }
+            }
+        };
+    }
+    assertTestCaseTaskRunResult(task, result);
+    const internalResult = fromTransportResult(result, resolveReportReference, resolveSource);
+    const completed = {
+        ...internalResult,
+        case: {
+            ...internalResult.case,
+            execution: {
+                executor: executor.name,
+                resources: task.resources,
+                attempts: executorAttempts,
+                ...internalResult.lifecycle ? {
+                    lifecycle: internalResult.lifecycle
+                } : {},
+                ...result.artifacts ? {
+                    artifacts: result.artifacts
+                } : {},
+                ...result.metadata ? {
+                    metadata: result.metadata
+                } : {}
+            }
+        }
+    };
+    onCompleted(completed);
+    for (const attempt of internalResult.case.attempts ?? [])await writeCaseAttemptResult(options.runDir, task.projectId, task.documentId, attempt);
+    if (internalResult.document) await writeWorkflowDocumentResult(options.runDir, internalResult.document);
+    taskProgress(internalResult.case.status);
+    return completed;
+};
+const runCaseExecution = async (options)=>{
+    const tasks = prepareCaseTasks(options.projects);
+    let failedCaseCount = 0;
+    const bailReached = ()=>options.test.bail > 0 && failedCaseCount >= options.test.bail;
+    const results = new Array(tasks.length);
+    if (tasks.length > 0) try {
+        await runTaskPool({
+            tasks: tasks.map((preparedTask)=>preparedTask.task),
+            maxConcurrency: Math.min(options.test.maxConcurrency, tasks.length),
+            signal: options.signal,
+            shouldStop: bailReached,
+            run: async (_task, taskIndex)=>{
+                try {
+                    const result = await runCaseTask(tasks[taskIndex], taskIndex, tasks.length, options, (completed)=>{
+                        results[taskIndex] = completed;
+                    });
+                    results[taskIndex] = result;
+                    if ('failed' === result.case.status) failedCaseCount += 1;
+                    return result;
+                } catch (error) {
+                    options.onInfrastructureError(error);
+                    throw error;
+                }
+            }
+        });
+    } catch (error) {
+        options.onInfrastructureError(error);
+    }
+    return options.projects.map((prepared, projectIndex)=>{
+        const projectTasks = tasks.map((task, taskIndex)=>({
+                task,
+                result: results[taskIndex]
+            })).filter(({ task })=>task.projectIndex === projectIndex);
+        const reason = prepared.collectionErrors.length ? 'project-preflight-failed' : options.signal.aborted ? 'interrupted' : bailReached() ? 'bail' : void 0;
+        const cases = projectTasks.map(({ task, result })=>{
+            if (result) return result.case;
+            if (!reason) throw new Error(`Case scheduler did not produce a result for "${task.task.caseId}".`);
+            return asNotRun(task.task.documentId, task.collectedCase, prepared.project.name, reason);
+        });
+        const documents = projectTasks.flatMap(({ result })=>result?.document ? [
+                result.document
+            ] : []);
+        return buildProjectResult(prepared, cases, documents);
+    });
+};
 const caseHasFatalError = (outcome)=>(outcome.attempts ?? []).some((attempt)=>[
             ...attempt.beforeEach,
             ...attempt.steps,
@@ -1159,7 +2344,7 @@ async function executeDocumentInvocation(options) {
             },
             onStepResult: async (info, result)=>{
                 await invocation.bindings.onStepResult?.(info, result);
-                options.onProgress(formatStepResult(info, result));
+                options.onProgress(formatStepResult(info, result, 'case' === info.scope ? '      ' : '    '));
             },
             onCaseResult: async (attempt)=>{
                 await writeCaseAttemptResult(options.runDir, project.projectId, document.documentId, attempt);
@@ -1277,16 +2462,6 @@ function createOperationJournal(runDir) {
         }
     };
 }
-const asNotRun = (documentId, collectedCase, projectName, reason)=>({
-        documentId,
-        caseId: collectedCase.caseId,
-        projectName,
-        name: collectedCase.definition.name,
-        sourcePath: collectedCase.sourcePath,
-        caseIndex: collectedCase.caseIndex,
-        status: 'not-run',
-        notRunReason: reason
-    });
 const summarize = (projects)=>{
     const healthCases = projects.flatMap((project)=>{
         const documentAttemptByRunId = new Map(project.documents.map((document)=>[
@@ -1320,12 +2495,6 @@ const summarize = (projects)=>{
         projectFailures: projects.filter((project)=>'failed' === project.status).length
     };
 };
-const latestById = (items, id)=>[
-        ...new Map(items.map((item)=>[
-                id(item),
-                item
-            ])).values()
-    ];
 const notRunSuite = (prepared, reason)=>prepared.documents.flatMap((document)=>document.cases.map((item)=>asNotRun(document.documentId, item, prepared.project.name, reason)));
 async function runPreparedTestProject(plan) {
     const { startedAt, runId, projectRoot, configPath, resultDir, runDir, summaryPath, reportDir, definition, projects: preparedProjects } = plan;
@@ -1338,7 +2507,7 @@ async function runPreparedTestProject(plan) {
     await writeTestRunPlan(runDir, preparedProjects);
     const journal = createOperationJournal(runDir);
     const rootController = new AbortController();
-    setMaxListeners(Math.max(10, effectiveConcurrency + 1), rootController.signal);
+    setMaxListeners(Math.max(10, ('case' === definition.test.executionUnit ? Math.min(definition.test.maxConcurrency, totalCases) : effectiveConcurrency) + 1), rootController.signal);
     const handleSignal = (signal)=>{
         rootController.abort(new Error(`Workflow interrupted by ${signal}.`));
     };
@@ -1380,31 +2549,6 @@ async function runPreparedTestProject(plan) {
         const { project } = prepared;
         runInfrastructureCallback(()=>progress(`[project ${projectIndex + 1}/${preparedProjects.length}] ${project.name}`));
     };
-    const buildProjectResult = (prepared, cases, documents, lifecycle)=>{
-        const { project } = prepared;
-        const projectFailed = prepared.collectionErrors.length > 0 || latestById(cases, (item)=>item.caseId).some((item)=>'success' !== item.status) || latestById(documents, (item)=>item.documentId).some((item)=>'failed' === item.status) || lifecycle?.status === 'failed';
-        return {
-            projectId: project.projectId,
-            name: project.name,
-            ...prepared.platform ? {
-                platform: prepared.platform
-            } : {},
-            status: projectFailed ? 'failed' : 'success',
-            retry: project.retry,
-            fileSelection: prepared.fileSelection,
-            tagSelection: project.tags,
-            sourceCount: prepared.sources.length,
-            selectedCaseCount: prepared.selectedCaseCount,
-            filteredCaseCount: prepared.filteredCaseCount,
-            ...lifecycle ? {
-                lifecycle
-            } : {},
-            cases,
-            plans: prepared.plans,
-            documents,
-            collectionErrors: prepared.collectionErrors
-        };
-    };
     const buildSkippedProjectResult = (prepared, projectIndex, reason)=>{
         announceProject(prepared, projectIndex);
         return buildProjectResult(prepared, notRunSuite(prepared, reason), []);
@@ -1505,7 +2649,7 @@ async function runPreparedTestProject(plan) {
     };
     const projectResults = new Array(preparedProjects.length);
     try {
-        await runConcurrentJobs(preparedProjects, {
+        if ('case' !== definition.test.executionUnit || 'run' === plan.preflightScope && totalErrors > 0) await runConcurrentJobs(preparedProjects, {
             concurrency: effectiveConcurrency,
             shouldStop: ()=>hasInfrastructureError || rootController.signal.aborted || bailReached()
         }, async (prepared, index)=>{
@@ -1516,6 +2660,20 @@ async function runPreparedTestProject(plan) {
                 throw error;
             }
         });
+        else {
+            const results = await runCaseExecution({
+                projects: preparedProjects,
+                test: definition.test,
+                executor: definition.executor,
+                runDir,
+                signal: rootController.signal,
+                progress,
+                onInfrastructureError: recordInfrastructureError
+            });
+            results.forEach((result, index)=>{
+                projectResults[index] = result;
+            });
+        }
     } catch (error) {
         recordInfrastructureError(error);
     } finally{
@@ -1621,6 +2779,6 @@ async function runPreparedTestProject(plan) {
 async function runTestProject(options = {}) {
     return runPreparedTestProject(await prepareTestRun(options));
 }
-export { DEFAULT_TEST_FILE_SELECTION, createTestRunId, defineProjectSetup, defineTestProject, discoverTestConfig, discoverTestFiles, loadTestProject, runTestProject, validateTestFileSelection };
+export { DEFAULT_TEST_FILE_SELECTION, TestExecutorError, assertTestCaseTaskRunResult, createTestRunId, defineProjectSetup, defineTestExecutor, defineTestProject, discoverSelectedTestFiles, discoverTestConfig, discoverTestFiles, loadTestProject, localTestExecutor, runTestProject, validateTestFileSelection };
 
 //# sourceMappingURL=index.mjs.map