@midscene/test 1.15.3 → 1.15.4-beta-20261013090705.0

package/dist/es/test-cli.mjs

@@ -20,9 +20,7 @@ var __webpack_modules__ = {
         module.exports = __rspack_external_node_path_c5b9b54f;
     },
     "./package.json" (module) {
-        module.exports = {
-            rE: "1.15.3"
-        };
+        module.exports = JSON.parse('{"rE":"1.15.4-beta-20261013090705.0"}');
     }
 };
 var __webpack_module_cache__ = {};
@@ -269,7 +267,7 @@ const validatePatterns = (value, field, label = 'files', allowEmptyInclude = fal
         return pattern;
     });
 };
-const test_project_validateTestFileSelection = (value, label = 'files')=>{
+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, [
@@ -393,7 +391,7 @@ const validateExecutionProjects = (value, defaultSetup, globalNodes)=>{
         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 = test_project_validateTestFileSelection(candidate.files, `${label}.files`);
+        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([
@@ -423,12 +421,27 @@ const validateExecutionProjects = (value, defaultSetup, globalNodes)=>{
 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')
+        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.');
+    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.`);
@@ -457,15 +470,22 @@ const validateTestProjectDefinition = (definition)=>{
         'projects',
         'test',
         'output',
-        'nodes'
+        '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: validateTestOptions(definition.test),
+        test,
         output: validateOutput(definition.output),
         nodes,
+        ...executor ? {
+            executor
+        } : {},
         resolveNode: (name)=>nodes.get(name)
     };
 };
@@ -510,6 +530,7 @@ async function loadTestProject(configPath) {
     }
     return validateTestProjectDefinition(getDefaultExport(loaded, absolutePath));
 }
+const isSafeResultPathSegment = (value)=>'string' == typeof value && /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(value);
 const createCaseInvocationId = (projectId, sourcePath, caseIndex, invocationIndex = 0)=>createHash('sha256').update(JSON.stringify([
         projectId,
         sourcePath,
@@ -729,10 +750,15 @@ function collectWorkflowDocument(source, options) {
             caseIndex
         });
         collect_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
         });
@@ -743,6 +769,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,
@@ -751,7 +784,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
         });
@@ -762,8 +795,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
             }
         };
@@ -903,6 +942,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,
@@ -980,6 +1051,27 @@ const DEFAULT_TEST_FILE_SELECTION = {
     ]
 };
 const project_preparation_toPosix = (value)=>value.split(external_node_path_.sep).join('/');
+const discoverSelectedTestFiles = (projectRoot, paths)=>{
+    const root = (0, 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 = (0, external_node_path_.resolve)(root, requestedPath);
+        const relativePath = (0, external_node_path_.relative)(root, absolutePath);
+        if ('..' === relativePath || relativePath.startsWith(`..${external_node_path_.sep}`) || (0, external_node_path_.isAbsolute)(relativePath)) throw new Error(`Test selection path is outside the project: ${requestedPath}`);
+        if (!(0, external_node_fs_.existsSync)(absolutePath)) throw new Error(`Test selection path does not exist: ${requestedPath}`);
+        if ((0, external_node_fs_.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((0, external_node_path_.relative)(root, a));
+        const relativeB = project_preparation_toPosix((0, external_node_path_.relative)(root, b));
+        return relativeA < relativeB ? -1 : relativeA > relativeB ? 1 : 0;
+    });
+};
 const discoverResolvedTestFiles = (projectRoot, selection)=>{
     const root = (0, external_node_path_.resolve)(projectRoot);
     const match = (patterns)=>globSync(patterns, {
@@ -1004,6 +1096,11 @@ const discoverResolvedTestFiles = (projectRoot, selection)=>{
         return relativeA < relativeB ? -1 : relativeA > relativeB ? 1 : 0;
     });
 };
+const discoverTestFiles = (projectRoot, selection = DEFAULT_TEST_FILE_SELECTION)=>{
+    const normalized = validateTestFileSelection(selection);
+    if (!normalized) throw new TypeError('Test file selection is required.');
+    return discoverResolvedTestFiles(projectRoot, normalized);
+};
 const discoverTestConfig = (projectRoot)=>{
     const root = (0, external_node_path_.resolve)(projectRoot);
     const candidates = (0, external_node_fs_.readdirSync)(root).filter((name)=>name.startsWith(CONFIG_PREFIX)).sort();
@@ -1034,8 +1131,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
@@ -1060,7 +1163,9 @@ async function prepareProject(project, projectRoot, runDir, defaultTimeoutMs, op
     const platform = options.platform?.trim();
     const fileSelection = project.files ?? DEFAULT_TEST_FILE_SELECTION;
     const prerequisiteFile = options.prerequisiteFile ? (0, external_node_path_.resolve)(options.prerequisiteFile) : void 0;
-    const mainFiles = options.files ?? discoverResolvedTestFiles(projectRoot, fileSelection);
+    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
@@ -1083,6 +1188,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,
@@ -1113,10 +1219,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,
@@ -1164,9 +1276,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 = [
@@ -1204,6 +1349,7 @@ async function prepareTestRun(options) {
     const startedAt = new Date();
     const runId = createTestRunId(startedAt);
     const input = resolveRunInput(options);
+    const selection = validateRunSelection(options);
     const configPath = options.configPath ? (0, 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 && !(0, external_node_fs_.existsSync)(configPath)) throw new Error(`Midscene config does not exist: ${configPath}`);
@@ -1217,11 +1363,20 @@ async function prepareTestRun(options) {
     });
     (0, external_node_fs_.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,
@@ -1317,20 +1472,1062 @@ 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
+    };
+};
+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',
+            'stop'
+        ]),
+        reason: z["enum"]([
+            'passed',
+            'attempt-failed',
+            'budget-exhausted',
+            'cleanup-pending',
+            'cleanup-failed',
+            'operation-pending',
+            'fatal-error',
+            'interrupted',
+            'bail',
+            'infrastructure-error'
+        ])
+    }).optional()
+};
+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 test_executor_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+const executorErrorKey = Symbol.for('@midscene/test/executor-error');
+let _executorErrorKey = executorErrorKey;
+class TestExecutorError extends Error {
+    constructor(message, options = {}){
+        super(message, {
+            cause: options.cause
+        }), test_executor_define_property(this, _executorErrorKey, true), test_executor_define_property(this, "kind", void 0), test_executor_define_property(this, "retryable", void 0);
+        this.name = 'TestExecutorError';
+        this.kind = options.kind ?? 'unknown';
+        this.retryable = options.retryable ?? false;
+    }
+}
+function isTestExecutorError(value) {
+    return value instanceof Error && true === Reflect.get(value, executorErrorKey) && [
+        'provision',
+        'transport',
+        'cleanup',
+        'report',
+        'unknown'
+    ].includes(Reflect.get(value, 'kind')) && 'boolean' == typeof Reflect.get(value, 'retryable');
+}
+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}.`);
+    }
+    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}.`);
+}
+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 = (0, external_node_fs_.realpathSync)(source.dumpPath);
+            const reference = randomUUID();
+            const destination = (0, external_node_path_.join)(outputDir, 'reports', reference);
+            (0, external_node_fs_.mkdirSync)(destination, {
+                recursive: true
+            });
+            const dumpPath = (0, external_node_path_.join)(destination, 'snapshot.json');
+            (0, external_node_fs_.cpSync)(dump, dumpPath);
+            const screenshots = (0, external_node_path_.join)((0, external_node_path_.dirname)(dump), 'screenshots');
+            if ((0, external_node_fs_.existsSync)(screenshots)) (0, external_node_fs_.cpSync)(screenshots, (0, external_node_path_.join)(destination, 'screenshots'), {
+                recursive: true,
+                dereference: true
+            });
+            const sourcePath = (0, external_node_path_.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 = (0, external_node_fs_.realpathSync)(sourcePath);
+            const entry = (0, external_node_fs_.statSync)(source).isDirectory() ? (0, external_node_path_.join)(source, 'index.html') : source;
+            if (!(0, external_node_fs_.statSync)(entry).isFile()) throw new TestExecutorError(`Executor report must have a regular HTML entry: ${sourcePath}`, {
+                kind: 'report'
+            });
+            const reference = randomUUID();
+            const destination = (0, external_node_path_.join)(outputDir, 'reports', reference);
+            (0, external_node_fs_.mkdirSync)(destination, {
+                recursive: true
+            });
+            const isDirectoryReport = 'index.html' === (0, external_node_path_.basename)(entry);
+            const reportPath = (0, external_node_path_.join)(destination, isDirectoryReport ? 'index.html' : 'report.html');
+            (0, external_node_fs_.cpSync)(isDirectoryReport ? (0, external_node_path_.dirname)(entry) : entry, isDirectoryReport ? destination : reportPath, {
+                recursive: isDirectoryReport,
+                dereference: true
+            });
+            if (!isDirectoryReport) {
+                const screenshots = (0, external_node_path_.join)((0, external_node_path_.dirname)(entry), 'screenshots');
+                if ((0, external_node_fs_.existsSync)(screenshots)) (0, external_node_fs_.cpSync)(screenshots, (0, external_node_path_.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 = (0, external_node_path_.join)(options.runDir, task.projectId, 'executor-output', task.documentId, task.caseId);
+    (0, external_node_fs_.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 (!isTestExecutorError(error)) 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,
@@ -1376,7 +2573,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);
@@ -1494,16 +2691,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)=>[
@@ -1537,12 +2724,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;
@@ -1555,7 +2736,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}.`));
     };
@@ -1597,31 +2778,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), []);
@@ -1722,7 +2878,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)=>{
@@ -1733,6 +2889,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{
@@ -1845,6 +3015,10 @@ const parseTestCliArgs = (args, cwd = process.cwd())=>{
     let configPath;
     let resultDir;
     const projectNames = [];
+    const paths = [];
+    const caseIds = [];
+    const includeTags = [];
+    const excludeTags = [];
     for(let index = commandOffset; index < args.length; index += 1){
         const token = args[index];
         const equal = token.startsWith('-') ? token.indexOf('=') : -1;
@@ -1855,17 +3029,22 @@ const parseTestCliArgs = (args, cwd = process.cwd())=>{
             projectRoot = (0, external_node_path_.resolve)(cwd, arg);
             continue;
         }
-        if ('--config' === arg || '--result-dir' === arg || '--project' === arg) {
+        if ('--config' === arg || '--result-dir' === arg || '--project' === arg || '--file' === arg || '--case-id' === arg || '--tag' === arg || '--exclude-tag' === arg) {
             const value = inlineValue ?? args[index + 1];
             if (!value || value.startsWith('--')) throw new Error(`${arg} requires a value.`);
             if ('--config' === arg) configPath = value;
             else if ('--result-dir' === arg) resultDir = (0, external_node_path_.resolve)(cwd, value);
-            else projectNames.push(value);
+            else if ('--project' === arg) projectNames.push(value);
+            else if ('--file' === arg) paths.push(value);
+            else if ('--case-id' === arg) caseIds.push(value);
+            else if ('--tag' === arg) includeTags.push(value);
+            else excludeTags.push(value);
             if (void 0 === inlineValue) index += 1;
         } else throw new Error(`Unknown option: ${token}`);
     }
     if ('nodes' === command && resultDir) throw new Error('--result-dir is not supported by nodes.');
     if ('nodes' === command && projectNames.length > 1) throw new Error('nodes accepts only one --project name.');
+    if ('nodes' === command && (paths.length > 0 || caseIds.length > 0 || includeTags.length > 0 || excludeTags.length > 0)) throw new Error('nodes does not support --file, --case-id, --tag, or --exclude-tag.');
     return {
         ...command ? {
             command
@@ -1876,6 +3055,22 @@ const parseTestCliArgs = (args, cwd = process.cwd())=>{
         resultDir,
         ...projectNames.length > 0 ? {
             projectNames
+        } : {},
+        ...paths.length > 0 ? {
+            paths
+        } : {},
+        ...caseIds.length > 0 ? {
+            caseIds
+        } : {},
+        ...includeTags.length > 0 || excludeTags.length > 0 ? {
+            tags: {
+                ...includeTags.length > 0 ? {
+                    include: includeTags
+                } : {},
+                ...excludeTags.length > 0 ? {
+                    exclude: excludeTags
+                } : {}
+            }
         } : {}
     };
 };