@midscene/test 1.13.2-beta-20260923035443.0 → 1.13.2

package/dist/es/test-cli.mjs

@@ -10,7 +10,7 @@ import { JSON_SCHEMA, load } from "js-yaml";
 import { createHash, randomUUID } from "node:crypto";
 import { mkdir, writeFile } from "node:fs/promises";
 import { setMaxListeners } from "node:events";
-import { TestRunReportAssembler, calculateTestRunHealth } from "@midscene/core/report";
+import { TestRunReportAssembler } from "@midscene/core/report";
 import { getDebug } from "@midscene/shared/logger";
 var __webpack_modules__ = {
     "node:fs" (module) {
@@ -20,7 +20,9 @@ var __webpack_modules__ = {
         module.exports = __rspack_external_node_path_c5b9b54f;
     },
     "./package.json" (module) {
-        module.exports = JSON.parse('{"rE":"1.13.2-beta-20260923035443.0"}');
+        module.exports = {
+            rE: "1.13.2"
+        };
     }
 };
 var __webpack_module_cache__ = {};
@@ -96,7 +98,7 @@ var external_node_fs_ = __webpack_require__("node:fs");
 var external_node_path_ = __webpack_require__("node:path");
 var package_0 = __webpack_require__("./package.json");
 const GENERATED_COMMENT = '<!-- Generated by `midscene-test nodes`. Do not edit directly. -->';
-const sortNodesForReference = (nodes)=>{
+const sortNodesForSpec = (nodes)=>{
     const priority = (name)=>'aiAct' === name ? 0 : 'aiAssert' === name ? 1 : 2;
     return [
         ...nodes
@@ -116,7 +118,7 @@ const renderNodeOverview = (nodes)=>{
 const renderWorkflowLocations = (location)=>{
     const sections = [
         '## Where to use these Nodes',
-        'Use these Nodes in Workflow Documents (`.yaml` or `.yml` files) selected by an Execution Project. Case file patterns and the config file path below are relative to this reference file. Case file patterns use glob syntax. A custom `--config` path does not change where case files are selected.',
+        'Use these Nodes in Workflow Documents (`.yaml` or `.yml` files) selected by an Execution Project. Case file patterns and the config file path below are relative to this spec file. Case file patterns use glob syntax. A custom `--config` path does not change where case files are selected.',
         'Projects created by `midscene-test create` select `cases/**/*.{yaml,yml}` by default, so you can write test cases in `cases/example.yaml` or subdirectories of `cases/`. If an Execution Project has no `files` configuration, Midscene Test searches `**/*.{yaml,yml}` recursively instead. Check `projects[].files` in your configuration before choosing a file location.'
     ];
     if (location) {
@@ -206,13 +208,14 @@ const renderNode = (node, warnings)=>{
     }
     return sections.join('\n\n');
 };
-const renderNodeReference = (nodes, location)=>{
+const renderNodeSpec = (nodes, location)=>{
     const warnings = [];
-    const sortedNodes = sortNodesForReference(nodes);
+    const sortedNodes = sortNodesForSpec(nodes);
     const sections = [
         GENERATED_COMMENT,
-        '# Midscene Test Node Reference',
-        'This document describes the nodes registered by the current Test Project.',
+        '# Midscene Test Node Spec',
+        'This document describes the Nodes available in YAML test files (`.yaml` or `.yml`) for the Midscene Test framework (`@midscene/test`). It lists the Nodes registered by the current Test Project, their inputs, and how to call them in test steps and lifecycle hooks.',
+        "Learn about the framework and YAML test authoring:\n\n- [Midscene Test overview](https://midscenejs.com/midscene-test/overview): framework concepts and the role of Nodes.\n- [Create and use test projects](https://midscenejs.com/midscene-test/use): write YAML cases, run tests, and inspect results.\n- [Configure test projects](https://midscenejs.com/midscene-test/configuration): register Nodes, select case files, and manage runtime resources.",
         renderNodeOverview(sortedNodes),
         renderWorkflowLocations(location),
         WORKFLOW_STEP_CONTRACT
@@ -1218,32 +1221,13 @@ const asNotRun = (documentId, collectedCase, projectName, reason)=>({
         notRunReason: reason
     });
 const summarize = (projects)=>{
-    const healthCases = projects.flatMap((project)=>{
-        const documentAttemptByRunId = new Map(project.documents.map((document)=>[
-                document.documentRunId,
-                document.attemptIndex ?? 0
-            ]));
-        return latestById(project.cases, (item)=>item.caseId).map((item)=>({
-                status: item.status,
-                ...item.run ? {
-                    run: item.run
-                } : {},
-                ...item.attempts ? {
-                    attempts: item.attempts
-                } : {},
-                retryCount: item.documentRunId ? documentAttemptByRunId.get(item.documentRunId) ?? 0 : 0
-            }));
-    });
+    const cases = projects.flatMap((project)=>latestById(project.cases, (item)=>item.caseId));
     const documents = projects.flatMap((project)=>latestById(project.documents, (item)=>item.documentId));
-    const health = calculateTestRunHealth(healthCases);
     return {
-        total: health.total,
-        passed: health.passed,
-        failed: health.failed,
-        notRun: health.notRun,
-        passedAfterRetry: health.passedAfterRetry,
-        finalPassRate: health.finalPassRate,
-        firstPassRate: health.firstPassRate,
+        total: cases.length,
+        passed: cases.filter((item)=>'success' === item.status).length,
+        failed: cases.filter((item)=>'failed' === item.status).length,
+        notRun: cases.filter((item)=>'not-run' === item.status).length,
         filtered: projects.reduce((total, project)=>total + project.filteredCaseCount, 0),
         collectionErrors: projects.reduce((total, project)=>total + project.collectionErrors.length, 0),
         documentFailures: documents.filter((document)=>'failed' === document.status).length,
@@ -1603,24 +1587,44 @@ const runNodesCommand = async (options, io)=>{
     const projectName = options.projectNames?.[0];
     const selectedProjects = projectName ? project.projects.filter((candidate)=>candidate.name === projectName) : project.projects;
     if (0 === selectedProjects.length) throw new Error(`Unknown Midscene project: ${projectName}`);
-    const registry = selectedProjects[0].nodes;
-    if (selectedProjects.some((candidate)=>candidate.nodes.names().length !== registry.names().length || candidate.nodes.definitions().some((node)=>registry.get(node.name) !== node))) throw new Error('Projects have different Nodes. Use nodes --project <name> to select one.');
-    const nodes = sortNodesForReference(registry.definitions());
-    const document = renderNodeReference(nodes, {
-        configPath: configPath ? (0, external_node_path_.relative)(configSearchRoot, configPath).split(external_node_path_.sep).join('/') : void 0,
-        projects: selectedProjects.map((executionProject)=>({
-                name: executionProject.name,
-                files: executionProject.files ?? DEFAULT_TEST_FILE_SELECTION
-            }))
+    const filenames = new Map();
+    const owners = new Map();
+    for (const executionProject of project.projects){
+        const safeName = executionProject.name.normalize('NFC').replace(/[<>:"/\\|?*\u0000-\u001f]/g, '-').replace(/[. ]+$/g, '-');
+        const filename = project.hasExplicitProjects ? `midscene-node-spec.${safeName}.md` : 'midscene-node-spec.md';
+        const key = filename.toLowerCase();
+        const owner = owners.get(key);
+        if (void 0 !== owner) throw new Error(`Projects "${owner}" and "${executionProject.name}" generate the same Node Spec filename: ${filename}`);
+        owners.set(key, executionProject.name);
+        filenames.set(executionProject.name, filename);
+    }
+    const specs = selectedProjects.map((executionProject)=>{
+        const nodes = sortNodesForSpec(executionProject.nodes.definitions());
+        const document = renderNodeSpec(nodes, {
+            configPath: configPath ? (0, external_node_path_.relative)(configSearchRoot, configPath).split(external_node_path_.sep).join('/') : void 0,
+            projects: [
+                {
+                    name: executionProject.name,
+                    files: executionProject.files ?? DEFAULT_TEST_FILE_SELECTION
+                }
+            ]
+        });
+        return {
+            executionProject,
+            nodes,
+            document
+        };
     });
-    for (const warning of document.warnings)io.error(`midscene-test nodes: ${warning}`);
-    const referencePath = (0, external_node_path_.resolve)(configSearchRoot, 'midscene-node-reference.md');
-    (0, external_node_fs_.writeFileSync)(referencePath, document.markdown);
-    if (projectName) io.log(`Execution Project: ${projectName}`);
-    io.log(`Registered Nodes (${nodes.length}):`);
-    if (0 === nodes.length) io.log('No nodes are registered by the current Test Project.');
-    for (const node of nodes)io.log(`- ${node.name}: ${node.description?.trim() || "Description not declared."}`);
-    io.log(`\nNode reference generated: ${referencePath}`);
+    for (const { executionProject, nodes, document } of specs){
+        for (const warning of document.warnings)io.error(`midscene-test nodes: ${warning}`);
+        const specPath = (0, external_node_path_.resolve)(configSearchRoot, filenames.get(executionProject.name));
+        (0, external_node_fs_.writeFileSync)(specPath, document.markdown);
+        if (project.hasExplicitProjects || projectName) io.log(`Execution Project: ${executionProject.name}`);
+        io.log(`Registered Nodes (${nodes.length}):`);
+        if (0 === nodes.length) io.log('No nodes are registered by the current Test Project.');
+        for (const node of nodes)io.log(`- ${node.name}: ${node.description?.trim() || "Description not declared."}`);
+        io.log(`\nNode Spec generated: ${specPath}`);
+    }
 };
 async function runTestCli(args, io = defaultCliIO) {
     try {