@midscene/test 1.13.2-beta-20260923035443.0 → 1.13.2

package/dist/lib/test-cli.js

@@ -16,7 +16,9 @@ var __webpack_modules__ = {
         module.exports = require("yargs/yargs");
     },
     "./package.json" (module) {
-        module.exports = JSON.parse('{"rE":"1.13.2-beta-20260923035443.0"}');
+        module.exports = {
+            rE: "1.13.2"
+        };
     }
 };
 var __webpack_module_cache__ = {};
@@ -81,7 +83,7 @@ var __webpack_exports__ = {};
     var package_0 = __webpack_require__("./package.json");
     const v4_namespaceObject = require("zod/v4");
     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
@@ -101,7 +103,7 @@ var __webpack_exports__ = {};
     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) {
@@ -191,13 +193,14 @@ Each Node's returned \`data\` is saved on that Step's result. Results are not na
         }
         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
@@ -1214,32 +1217,13 @@ Each Node's returned \`data\` is saved on that Step's result. Results are not na
             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 = (0, report_namespaceObject.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,
@@ -1599,24 +1583,44 @@ Legacy tasks/flow YAML and its CLI options belong to the midscene command.
         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 {