@midscene/test 1.12.4 → 1.12.5-beta-20260907092148.0

package/dist/es/test-cli.mjs

@@ -1,5 +1,5 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import * as __rspack_external_node_fs_5ea92f0c from "node:fs";
+import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import { z } from "zod/v4";
 import { pathToFileURL } from "node:url";
 import { require as api_require } from "tsx/cjs/api";
@@ -8,18 +8,134 @@ import { createHash, randomUUID } from "node:crypto";
 import { setMaxListeners } from "node:events";
 import { globSync } from "tinyglobby";
 import { JSON_SCHEMA, load } from "js-yaml";
-const GENERATED_COMMENT = '<!-- Generated by `midscene-test describe-nodes`. Do not edit directly. -->';
+var __webpack_modules__ = {
+    "node:fs" (module) {
+        module.exports = __rspack_external_node_fs_5ea92f0c;
+    },
+    "node:path" (module) {
+        module.exports = __rspack_external_node_path_c5b9b54f;
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+__webpack_require__.m = __webpack_modules__;
+(()=>{
+    __webpack_require__.d = (exports, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.f = {};
+    __webpack_require__.e = (chunkId)=>Promise.all(Object.keys(__webpack_require__.f).reduce((promises, key)=>{
+            __webpack_require__.f[key](chunkId, promises);
+            return promises;
+        }, []));
+})();
+(()=>{
+    __webpack_require__.u = (chunkId)=>"1~" + chunkId + ".mjs";
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    var installedChunks = {
+        443: 0
+    };
+    var installChunk = (data)=>{
+        var __rspack_esm_ids = data.__rspack_esm_ids;
+        var __webpack_modules__ = data.__webpack_modules__;
+        var __rspack_esm_runtime = data.__rspack_esm_runtime;
+        var moduleId, chunkId, i = 0;
+        for(moduleId in __webpack_modules__)if (__webpack_require__.o(__webpack_modules__, moduleId)) __webpack_require__.m[moduleId] = __webpack_modules__[moduleId];
+        if (__rspack_esm_runtime) __rspack_esm_runtime(__webpack_require__);
+        for(; i < __rspack_esm_ids.length; i++){
+            chunkId = __rspack_esm_ids[i];
+            if (__webpack_require__.o(installedChunks, chunkId) && installedChunks[chunkId]) installedChunks[chunkId][0]();
+            installedChunks[__rspack_esm_ids[i]] = 0;
+        }
+    };
+    __webpack_require__.f.j = function(chunkId, promises) {
+        var installedChunkData = __webpack_require__.o(installedChunks, chunkId) ? installedChunks[chunkId] : void 0;
+        if (0 !== installedChunkData) if (installedChunkData) promises.push(installedChunkData[1]);
+        else {
+            var promise = import("./" + __webpack_require__.u(chunkId)).then(installChunk, (e)=>{
+                if (0 !== installedChunks[chunkId]) installedChunks[chunkId] = void 0;
+                throw e;
+            });
+            var promise = Promise.race([
+                promise,
+                new Promise((resolve)=>{
+                    installedChunkData = installedChunks[chunkId] = [
+                        resolve
+                    ];
+                })
+            ]);
+            promises.push(installedChunkData[1] = promise);
+        }
+    };
+})();
+var external_node_fs_ = __webpack_require__("node:fs");
+var external_node_path_ = __webpack_require__("node:path");
+const GENERATED_COMMENT = '<!-- Generated by `midscene-test nodes`. Do not edit directly. -->';
+const sortNodesForReference = (nodes)=>{
+    const priority = (name)=>'aiAct' === name ? 0 : 'aiAssert' === name ? 1 : 2;
+    return [
+        ...nodes
+    ].sort((left, right)=>priority(left.name) - priority(right.name) || (left.name < right.name ? -1 : left.name > right.name ? 1 : 0));
+};
+const escapeTableCell = (value)=>value.trim().replace(/\\/g, '\\\\').replace(/\|/g, '\\|').replace(/\r\n|\r|\n/g, '<br>');
+const renderNodeOverview = (nodes)=>{
+    const heading = '## Available Nodes';
+    if (0 === nodes.length) return `${heading}\n\nNo nodes are registered by the current Test Project.`;
+    const rows = nodes.map((node)=>`| ${escapeTableCell(node.name)} | ${escapeTableCell(node.description || "Description not declared.")} |`);
+    return `${heading}\n\nThis table lists all available Nodes. See [Node Details](#node-details) below for each Node's usage and input schema.\n\n${[
+        "| Node | Description |",
+        '| --- | --- |',
+        ...rows
+    ].join('\n')}`;
+};
+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.',
+        '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, the runner searches `**/*.{yaml,yml}` recursively instead. Check `projects[].files` in your configuration before choosing a file location.'
+    ];
+    if (location) {
+        sections.push(`**Config file:** ${location.configPath ? `\`${location.configPath}\`` : 'No config file loaded.'}`);
+        for (const project of location.projects){
+            const patterns = project.files.include.map((pattern)=>`\`${pattern}\``).join(', ');
+            const projectLabel = location.projects.length > 1 ? ` (Execution Project: ${project.name})` : '';
+            const excludes = project.files.exclude?.length ? `; excludes: ${project.files.exclude.map((pattern)=>`\`${pattern}\``).join(', ')}` : '';
+            sections.push(`**Case files:** ${patterns}${projectLabel}${excludes}`);
+        }
+    }
+    sections.push('Files matching `files.exclude` are not selected. The runner always ignores `.git/`, `.midscene/`, `midscene_run/`, and `node_modules/` directories, including nested ones.', 'Call a Node in `cases[].steps`, or in the Workflow Document lifecycle steps `beforeAll`, `beforeEach`, `afterEach`, and `afterAll`. Node registrations are shared across the Test Project; each Execution Project supplies its own runtime environment.');
+    return sections.join('\n\n');
+};
 const WORKFLOW_STEP_CONTRACT = `## Workflow Step Contract
 
 Each step uses a node name as its key. The \`$\` object contains engine metadata and is not part of the node input.
 
 \`\`\`yaml
-workflow:
-  - node.name:
-      prompt: Describe the task.
-      $:
-        timeout: 30000
-        continue-on-error: false
+cases:
+  - name: Example case
+    steps:
+      - node.name:
+          prompt: Describe the task.
+          $:
+            timeout: 30000
+            continue-on-error: false
 \`\`\`
 
 A Node may map a string step value to one declared input field. Each Node section states whether it supports this shorthand and names the target field.`;
@@ -62,7 +178,7 @@ const toJsonSchema = (node)=>{
 };
 const renderNode = (node, warnings)=>{
     const sections = [
-        `## \`${node.name}\``
+        `### \`${node.name}\``
     ];
     if (node.title) sections.push(`**Title:** ${node.title.trim()}`);
     if (node.description) sections.push(node.description.trim());
@@ -72,7 +188,7 @@ const renderNode = (node, warnings)=>{
     }
     if (false === node.stringInputKey || void 0 === node.stringInputKey) sections.push('**String shorthand:** Not supported by this Node.');
     else sections.push(`**String shorthand:** Maps to \`{ ${node.stringInputKey}: value }\`.`);
-    sections.push('### Input Schema');
+    sections.push('#### Input Schema');
     if (node.inputSchema) sections.push(`\`\`\`json\n${JSON.stringify(toJsonSchema(node), null, 2)}\n\`\`\``);
     else {
         warnings.push(`node "${node.name}" has no inputSchema`);
@@ -80,19 +196,21 @@ const renderNode = (node, warnings)=>{
     }
     return sections.join('\n\n');
 };
-const renderNodeReference = (nodes)=>{
+const renderNodeReference = (nodes, location)=>{
     const warnings = [];
-    const sortedNodes = [
-        ...nodes
-    ].sort((left, right)=>left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+    const sortedNodes = sortNodesForReference(nodes);
     const sections = [
         GENERATED_COMMENT,
         '# Midscene Test Node Reference',
         'This document describes the nodes registered by the current Test Project.',
+        renderNodeOverview(sortedNodes),
+        renderWorkflowLocations(location),
         WORKFLOW_STEP_CONTRACT
     ];
-    if (0 === sortedNodes.length) sections.push('No nodes are registered by the current Test Project.');
-    else for (const node of sortedNodes)sections.push(renderNode(node, warnings));
+    if (sortedNodes.length > 0) {
+        sections.push('## Node Details');
+        for (const node of sortedNodes)sections.push(renderNode(node, warnings));
+    }
     return {
         markdown: `${sections.join('\n\n')}\n`,
         warnings
@@ -385,7 +503,7 @@ const rejectUnknownKeys = (value, allowedKeys, label)=>{
     const unknown = Object.keys(value).find((key)=>!allowed.has(key));
     if (unknown) throw new TypeError(`Midscene config ${label}.${unknown} is not supported.`);
 };
-const isAbsolutePattern = (pattern)=>isAbsolute(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith('\\\\');
+const isAbsolutePattern = (pattern)=>(0, external_node_path_.isAbsolute)(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith('\\\\');
 const validatePatterns = (value, field, label = 'files', allowEmptyInclude = false)=>{
     if (!Array.isArray(value)) throw new TypeError(`Midscene config ${label}.${field} must be an array.`);
     if ('include' === field && 0 === value.length && !allowEmptyInclude) throw new TypeError(`Midscene config ${label}.include must be a non-empty array.`);
@@ -625,12 +743,12 @@ async function loadTestProject(configPath) {
     if (!configPath) return validateTestProjectDefinition({
         nodes: []
     });
-    const absolutePath = resolve(configPath);
+    const absolutePath = (0, external_node_path_.resolve)(configPath);
     assertTypeScriptConfig(absolutePath);
     let loaded;
     try {
         loaded = await tsImport(pathToFileURL(absolutePath).href, {
-            parentURL: pathToFileURL(`${dirname(absolutePath)}${sep}`).href,
+            parentURL: pathToFileURL(`${(0, external_node_path_.dirname)(absolutePath)}${external_node_path_.sep}`).href,
             tsconfig: false
         });
     } catch (error) {
@@ -911,7 +1029,7 @@ const reportPathsFromTeardown = (result)=>{
     if (!Array.isArray(paths)) throw new TypeError('Node teardown reportPaths must be an array.');
     return paths.map((path, index)=>{
         if ('string' != typeof path || 0 === path.trim().length) throw new TypeError(`Node teardown reportPaths[${index}] must be a non-empty string.`);
-        if (!isAbsolute(path)) throw new TypeError(`Node teardown reportPaths[${index}] must be an absolute path.`);
+        if (!(0, external_node_path_.isAbsolute)(path)) throw new TypeError(`Node teardown reportPaths[${index}] must be an absolute path.`);
         return path;
     });
 };
@@ -1427,7 +1545,7 @@ const createWorkflowDocumentId = (projectId, sourcePath)=>createHash('sha256').u
 function collectWorkflowDocument(source, options) {
     let parsed;
     try {
-        parsed = load(readFileSync(source.absolutePath, 'utf8'), {
+        parsed = load((0, external_node_fs_.readFileSync)(source.absolutePath, 'utf8'), {
             schema: JSON_SCHEMA
         });
     } catch (error) {
@@ -1444,7 +1562,7 @@ function collectWorkflowDocument(source, options) {
         'afterAll'
     ], 'Workflow document');
     if (!Array.isArray(parsed.cases) || 0 === parsed.cases.length) throw new WorkflowParseError('Workflow document must contain a non-empty cases array.');
-    const sourcePath = source.sourcePath.split(sep).join('/');
+    const sourcePath = source.sourcePath.split(external_node_path_.sep).join('/');
     const resolveStepVariables = (step, phase, stepIndex, caseIndex)=>({
             ...step,
             input: resolveWorkflowVariables(step.input, {
@@ -1537,40 +1655,40 @@ function collectWorkflowDocument(source, options) {
     };
 }
 const writeJson = (path, value)=>{
-    mkdirSync(dirname(path), {
+    (0, external_node_fs_.mkdirSync)((0, external_node_path_.dirname)(path), {
         recursive: true
     });
-    writeFileSync(path, JSON.stringify(value, null, 2));
+    (0, external_node_fs_.writeFileSync)(path, JSON.stringify(value, null, 2));
 };
-const toPosix = (value)=>value.split(sep).join('/');
-const caseAttemptResultPath = (projectId, documentId, result)=>toPosix(join(projectId, 'documents', documentId, 'cases', result.caseId, `${result.runId}.json`));
-const workflowDocumentResultPath = (result)=>toPosix(join(result.projectId, 'documents', result.documentId, 'document.json'));
+const toPosix = (value)=>value.split(external_node_path_.sep).join('/');
+const caseAttemptResultPath = (projectId, documentId, result)=>toPosix((0, external_node_path_.join)(projectId, 'documents', documentId, 'cases', result.caseId, `${result.runId}.json`));
+const workflowDocumentResultPath = (result)=>toPosix((0, external_node_path_.join)(result.projectId, 'documents', result.documentId, 'document.json'));
 const collectionErrorPath = (projectId, sourcePath)=>{
     const id = createHash('sha256').update(JSON.stringify([
         projectId,
         sourcePath
     ])).digest('hex');
-    return toPosix(join(projectId, 'collection-errors', `${id}.json`));
+    return toPosix((0, external_node_path_.join)(projectId, 'collection-errors', `${id}.json`));
 };
 const writeWorkflowDocumentResult = (runDir, result)=>{
     const { documentRunId: _documentRunId, ...persistedResult } = result;
-    writeJson(join(runDir, workflowDocumentResultPath(result)), persistedResult);
+    writeJson((0, external_node_path_.join)(runDir, workflowDocumentResultPath(result)), persistedResult);
 };
 const writeCaseAttemptResult = (runDir, projectId, documentId, result)=>{
     const { runId: attemptId, ...persistedResult } = result;
-    writeJson(join(runDir, caseAttemptResultPath(projectId, documentId, result)), {
+    writeJson((0, external_node_path_.join)(runDir, caseAttemptResultPath(projectId, documentId, result)), {
         ...persistedResult,
         attemptId
     });
 };
 const writeCollectionError = (runDir, collectionError)=>{
-    writeJson(join(runDir, collectionErrorPath(collectionError.projectId, collectionError.sourcePath)), {
+    writeJson((0, external_node_path_.join)(runDir, collectionErrorPath(collectionError.projectId, collectionError.sourcePath)), {
         kind: 'collection-error',
         ...collectionError
     });
 };
 const relativeToSummary = (summaryPath, target)=>{
-    const value = relative(dirname(summaryPath), target);
+    const value = (0, external_node_path_.relative)((0, external_node_path_.dirname)(summaryPath), target);
     return toPosix(value || '.');
 };
 const errorJson = (error)=>error instanceof Error && 'toJSON' in error ? error.toJSON() : error;
@@ -1672,9 +1790,9 @@ const DEFAULT_TEST_FILE_SELECTION = {
         '**/*.{yaml,yml}'
     ]
 };
-const test_project_runner_toPosix = (value)=>value.split(sep).join('/');
+const test_project_runner_toPosix = (value)=>value.split(external_node_path_.sep).join('/');
 const discoverTestFiles = (projectRoot, selection = DEFAULT_TEST_FILE_SELECTION)=>{
-    const root = resolve(projectRoot);
+    const root = (0, external_node_path_.resolve)(projectRoot);
     const normalized = validateTestFileSelection(selection);
     if (!normalized) throw new TypeError('Test file selection is required.');
     const files = globSync(normalized.include, {
@@ -1691,25 +1809,25 @@ const discoverTestFiles = (projectRoot, selection = DEFAULT_TEST_FILE_SELECTION)
         onlyFiles: true
     }).filter((file)=>/\.ya?ml$/i.test(file));
     return [
-        ...new Set(files.map((file)=>resolve(file)))
+        ...new Set(files.map((file)=>(0, external_node_path_.resolve)(file)))
     ].sort((a, b)=>{
-        const relativeA = test_project_runner_toPosix(relative(root, a));
-        const relativeB = test_project_runner_toPosix(relative(root, b));
+        const relativeA = test_project_runner_toPosix((0, external_node_path_.relative)(root, a));
+        const relativeB = test_project_runner_toPosix((0, external_node_path_.relative)(root, b));
         return relativeA < relativeB ? -1 : relativeA > relativeB ? 1 : 0;
     });
 };
 const discoverTestConfig = (projectRoot)=>{
-    const root = resolve(projectRoot);
-    const candidates = readdirSync(root).filter((name)=>name.startsWith(CONFIG_PREFIX)).sort();
+    const root = (0, external_node_path_.resolve)(projectRoot);
+    const candidates = (0, external_node_fs_.readdirSync)(root).filter((name)=>name.startsWith(CONFIG_PREFIX)).sort();
     const unsupported = candidates.filter((name)=>name !== CONFIG_NAME);
     if (unsupported.length > 0) throw new Error([
         `Unsupported or conflicting Midscene configs found in ${root}:`,
         ...candidates.map((name)=>`- ${name}`),
         `Only ${CONFIG_NAME} is supported.`
     ].join('\n'));
-    return candidates.includes(CONFIG_NAME) ? join(root, CONFIG_NAME) : void 0;
+    return candidates.includes(CONFIG_NAME) ? (0, external_node_path_.join)(root, CONFIG_NAME) : void 0;
 };
-const defaultResultDir = (projectRoot)=>join(projectRoot, '.midscene', 'test-results');
+const defaultResultDir = (projectRoot)=>(0, external_node_path_.join)(projectRoot, '.midscene', 'test-results');
 const padDatePart = (value)=>String(value).padStart(2, '0');
 const createTestRunId = (date = new Date(), uuid = randomUUID())=>{
     const timestamp = [
@@ -1723,7 +1841,7 @@ const createTestRunId = (date = new Date(), uuid = randomUUID())=>{
     return `${timestamp}-${uuid.slice(0, 8)}`;
 };
 const assertDirectory = (path, label)=>{
-    if (!existsSync(path) || !statSync(path).isDirectory()) throw new Error(`${label} does not exist or is not a directory: ${path}`);
+    if (!(0, external_node_fs_.existsSync)(path) || !(0, external_node_fs_.statSync)(path).isDirectory()) throw new Error(`${label} does not exist or is not a directory: ${path}`);
 };
 const asCollectionError = (projectId, projectName, sourcePath, error)=>({
         projectId,
@@ -1812,7 +1930,7 @@ const prepareProject = (project, projectRoot, resolveNode, runDir)=>{
     const sources = files.map((absolutePath)=>({
             projectId: project.projectId,
             projectName: project.name,
-            sourcePath: test_project_runner_toPosix(relative(projectRoot, absolutePath)),
+            sourcePath: test_project_runner_toPosix((0, external_node_path_.relative)(projectRoot, absolutePath)),
             absolutePath
         }));
     const collectionErrors = [];
@@ -1854,23 +1972,23 @@ const notRunSuite = (prepared, reason)=>prepared.documents.flatMap((document)=>d
 async function runTestProject(options = {}) {
     const startedAt = new Date();
     const runId = createTestRunId(startedAt);
-    const cwd = resolve(options.cwd ?? process.cwd());
+    const cwd = (0, external_node_path_.resolve)(options.cwd ?? process.cwd());
     assertDirectory(cwd, 'Test working directory');
-    const cliProjectRoot = options.projectRoot ? resolve(cwd, options.projectRoot) : void 0;
+    const cliProjectRoot = options.projectRoot ? (0, external_node_path_.resolve)(cwd, options.projectRoot) : void 0;
     if (cliProjectRoot) assertDirectory(cliProjectRoot, 'Test project directory');
     const configSearchRoot = cliProjectRoot ?? cwd;
-    const configPath = options.configPath ? resolve(configSearchRoot, options.configPath) : discoverTestConfig(configSearchRoot);
-    if (options.configPath && (!configPath || !existsSync(configPath))) throw new Error(`Midscene config does not exist: ${configPath}`);
+    const configPath = options.configPath ? (0, external_node_path_.resolve)(configSearchRoot, options.configPath) : discoverTestConfig(configSearchRoot);
+    if (options.configPath && (!configPath || !(0, external_node_fs_.existsSync)(configPath))) throw new Error(`Midscene config does not exist: ${configPath}`);
     const definition = await loadTestProject(configPath);
     const projectRoot = cliProjectRoot ?? cwd;
-    const resultDir = options.resultDir ? resolve(cwd, options.resultDir) : defaultResultDir(projectRoot);
-    const runDir = join(resultDir, runId);
-    const summaryPath = join(runDir, 'summary.json');
-    const reportDir = resolve(projectRoot, definition.output.reportDir);
-    mkdirSync(resultDir, {
+    const resultDir = options.resultDir ? (0, external_node_path_.resolve)(cwd, options.resultDir) : defaultResultDir(projectRoot);
+    const runDir = (0, external_node_path_.join)(resultDir, runId);
+    const summaryPath = (0, external_node_path_.join)(runDir, 'summary.json');
+    const reportDir = (0, external_node_path_.resolve)(projectRoot, definition.output.reportDir);
+    (0, external_node_fs_.mkdirSync)(resultDir, {
         recursive: true
     });
-    mkdirSync(runDir);
+    (0, external_node_fs_.mkdirSync)(runDir);
     const selectedProjects = selectProjects(definition.projects, options.projectNames);
     const preparedProjects = selectedProjects.map((project)=>prepareProject(project, projectRoot, definition.resolveNode, runDir));
     const progress = options.onProgress ?? (()=>{});
@@ -2081,7 +2199,7 @@ async function runTestProject(options = {}) {
     return result;
 }
 const parseTestCliArgs = (args, cwd = process.cwd())=>{
-    const command = 'describe-nodes' === args[0] ? args[0] : void 0;
+    const command = 'nodes' === args[0] ? args[0] : void 0;
     const commandOffset = command ? 1 : 0;
     let projectRoot;
     let configPath;
@@ -2091,20 +2209,20 @@ const parseTestCliArgs = (args, cwd = process.cwd())=>{
         const arg = args[index];
         if (!arg.startsWith('-')) {
             if (projectRoot) throw new Error('Only one test project directory is allowed.');
-            projectRoot = resolve(cwd, arg);
+            projectRoot = (0, external_node_path_.resolve)(cwd, arg);
             continue;
         }
         if ('--config' === arg || '--result-dir' === arg || '--project' === arg) {
             const value = args[index + 1];
             if (!value) throw new Error(`${arg} requires a value.`);
             if ('--config' === arg) configPath = value;
-            else if ('--result-dir' === arg) resultDir = resolve(cwd, value);
+            else if ('--result-dir' === arg) resultDir = (0, external_node_path_.resolve)(cwd, value);
             else projectNames.push(value);
             index += 1;
         } else throw new Error(`Unknown option: ${arg}`);
     }
-    if ('describe-nodes' === command && resultDir) throw new Error('--result-dir is not supported by describe-nodes.');
-    if ('describe-nodes' === command && projectNames.length > 0) throw new Error('--project is not supported by describe-nodes.');
+    if ('nodes' === command && resultDir) throw new Error('--result-dir is not supported by nodes.');
+    if ('nodes' === command && projectNames.length > 0) throw new Error('--project is not supported by nodes.');
     return {
         ...command ? {
             command
@@ -2124,27 +2242,43 @@ const defaultCliIO = {
     write: (message)=>process.stdout.write(message)
 };
 const test_command_assertDirectory = (path, label)=>{
-    if (!existsSync(path) || !statSync(path).isDirectory()) throw new Error(`${label} does not exist or is not a directory: ${path}`);
+    if (!(0, external_node_fs_.existsSync)(path) || !(0, external_node_fs_.statSync)(path).isDirectory()) throw new Error(`${label} does not exist or is not a directory: ${path}`);
 };
-const describeNodes = async (options, io)=>{
-    const cwd = resolve(options.cwd);
+const runNodesCommand = async (options, io)=>{
+    const cwd = (0, external_node_path_.resolve)(options.cwd);
     test_command_assertDirectory(cwd, 'Test working directory');
-    const projectRoot = options.projectRoot ? resolve(cwd, options.projectRoot) : void 0;
+    const projectRoot = options.projectRoot ? (0, external_node_path_.resolve)(cwd, options.projectRoot) : void 0;
     if (projectRoot) test_command_assertDirectory(projectRoot, 'Test project directory');
     const configSearchRoot = projectRoot ?? cwd;
-    const configPath = options.configPath ? resolve(configSearchRoot, options.configPath) : discoverTestConfig(configSearchRoot);
-    if (options.configPath && (!configPath || !existsSync(configPath))) throw new Error(`Midscene config does not exist: ${configPath}`);
+    const configPath = options.configPath ? (0, external_node_path_.resolve)(configSearchRoot, options.configPath) : discoverTestConfig(configSearchRoot);
+    if (options.configPath && (!configPath || !(0, external_node_fs_.existsSync)(configPath))) throw new Error(`Midscene config does not exist: ${configPath}`);
     const project = await loadTestProject(configPath);
-    const document = renderNodeReference(project.nodes.definitions());
-    for (const warning of document.warnings)io.error(`midscene-test describe-nodes: ${warning}`);
-    if (io.write) io.write(document.markdown);
-    else io.log(document.markdown.trimEnd());
+    const nodes = sortNodesForReference(project.nodes.definitions());
+    const document = renderNodeReference(nodes, {
+        configPath: configPath ? (0, external_node_path_.relative)(configSearchRoot, configPath).split(external_node_path_.sep).join('/') : void 0,
+        projects: project.projects.map((executionProject)=>({
+                name: executionProject.name,
+                files: executionProject.files ?? DEFAULT_TEST_FILE_SELECTION
+            }))
+    });
+    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);
+    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}`);
 };
 async function runTestCli(args, io = defaultCliIO) {
     try {
+        if ('create' === args[0]) {
+            const { runCreateCommand } = await __webpack_require__.e("891").then(__webpack_require__.bind(__webpack_require__, "./src/cli/create-command.ts"));
+            await runCreateCommand(args.slice(1), io);
+            return 0;
+        }
         const options = parseTestCliArgs(args);
-        if ('describe-nodes' === options.command) {
-            await describeNodes(options, io);
+        if ('nodes' === options.command) {
+            await runNodesCommand(options, io);
             return 0;
         }
         const result = await runTestProject({