feat(cli): add feature file runner

packages/cli/package.json

@@ -19,6 +19,8 @@
     "test:ai:temp": "AITEST=true BRIDGE_MODE=true vitest tests/bridge.test.ts"
   },
   "dependencies": {
+    "@cucumber/gherkin": "41.0.0",
+    "@cucumber/messages": "33.0.3",
     "@midscene/android": "workspace:*",
     "@midscene/computer": "workspace:*",
     "@midscene/core": "workspace:*",

packages/cli/rslib.config.ts

@@ -43,6 +43,7 @@ export default defineConfig({
     entry: {
       index: 'src/index.ts',
       'framework/index': 'src/framework/index.ts',
+      'framework/feature-loader': 'src/framework/feature-loader.ts',
     },
     define: {
       __VERSION__: JSON.stringify(version),

packages/cli/src/cli-utils.ts

@@ -139,15 +139,19 @@ Examples:
   };
 };
 
-// match yml or yaml files
+const RUNNABLE_FILE_EXTENSIONS = ['.yml', '.yaml', '.feature'];
+
+const isRunnableFile = (file: string): boolean =>
+  RUNNABLE_FILE_EXTENSIONS.some((ext) => file.endsWith(ext));
+
 export async function matchYamlFiles(
   fileGlob: string,
   options?: {
     cwd?: string;
   },
 ) {
   if (existsSync(fileGlob) && statSync(fileGlob).isDirectory()) {
-    fileGlob = join(fileGlob, '**/*.{yml,yaml}');
+    fileGlob = join(fileGlob, '**/*.{yml,yaml,feature}');
   }
 
   const { cwd } = options || {};
@@ -160,7 +164,5 @@ export async function matchYamlFiles(
     cwd,
   });
 
-  return files
-    .filter((file) => file.endsWith('.yml') || file.endsWith('.yaml'))
-    .sort();
+  return files.filter(isRunnableFile).sort();
 }

packages/cli/src/config-factory.ts

@@ -105,7 +105,9 @@ export async function parseConfigYaml(
 
   // Validate that at least one file was found
   if (files.length === 0) {
-    throw new Error('No YAML files found matching the patterns in "files"');
+    throw new Error(
+      'No YAML or feature files found matching the patterns in "files"',
+    );
   }
 
   // Generate default summary filename

packages/cli/src/execution-summary.ts

@@ -157,10 +157,19 @@ const toTestStatus = (
 const safeReportNamePart = (value: string): string =>
   value.replace(/[:*?"<>|# ]/g, '-');
 
-const createRetryReportName = (file: string): string => {
-  const fileName = basename(file, extname(file)) || 'yaml';
+const resultDisplayName = (result: MidsceneYamlConfigResult): string =>
+  result.testName ?? result.file;
+
+const retryAttemptDisplayName = (result: MidsceneYamlConfigResult): string =>
+  result.testName ?? basename(result.file);
+
+const createRetryReportName = (result: MidsceneYamlConfigResult): string => {
+  const label = resultDisplayName(result);
+  const fileName = result.testName
+    ? basename(label)
+    : basename(result.file, extname(result.file)) || 'yaml';
   const fileHash = createHash('sha1')
-    .update(resolve(file))
+    .update(`${resolve(result.file)}\0${result.testName ?? ''}`)
     .digest('hex')
     .slice(0, 8);
   return `${safeReportNamePart(fileName)}-${fileHash}-retry-attempts`;
@@ -179,13 +188,14 @@ const createRetryAttemptReport = (
   const tool = new ReportMergingTool();
   for (const attempt of attemptsWithReports) {
     const status = toTestStatus(attempt);
+    const displayName = retryAttemptDisplayName(result);
     tool.append({
       reportFilePath: attempt.report!,
       reportAttributes: {
         testDuration: attempt.duration ?? 0,
         testStatus: status,
-        testTitle: `Attempt ${attempt.attempt}: ${status} - ${basename(result.file)}`,
-        testId: `${safeReportNamePart(basename(result.file))}-attempt-${attempt.attempt}`,
+        testTitle: `Attempt ${attempt.attempt}: ${status} - ${displayName}`,
+        testId: `${safeReportNamePart(displayName)}-attempt-${attempt.attempt}`,
         testDescription:
           attempt.error ??
           (attempt.success ? 'YAML attempt passed' : 'YAML attempt failed'),
@@ -194,7 +204,7 @@ const createRetryAttemptReport = (
   }
 
   return (
-    tool.mergeReports(createRetryReportName(result.file), {
+    tool.mergeReports(createRetryReportName(result), {
       outputDir: getMidsceneRunSubDir('report'),
       overwrite: true,
     }) || undefined
@@ -249,7 +259,7 @@ export function writeExecutionSummaryFile(
       const retryReport = createRetryAttemptReportSafely(result);
 
       return {
-        script: relative(outputDir, result.file),
+        script: result.testName ?? relative(outputDir, result.file),
         success: result.success,
         resultType: result.resultType,
         output: result.output
@@ -340,15 +350,15 @@ export function printExecutionSummary(
   if (successfulFiles.length > 0) {
     console.log('\n✅ Successful files:');
     successfulFiles.forEach((result) => {
-      console.log(`   ${result.file}`);
+      console.log(`   ${resultDisplayName(result)}`);
       printResultArtifacts(result);
     });
   }
 
   if (failedFiles.length > 0) {
     console.log('\n❌ Failed files');
     failedFiles.forEach((result) => {
-      console.log(`   ${result.file}`);
+      console.log(`   ${resultDisplayName(result)}`);
       if (result.error) {
         console.log(`     Error: ${result.error}`);
       }
@@ -360,7 +370,7 @@ export function printExecutionSummary(
       '\n⚠️  Partial failed files (some tasks failed with continueOnError)',
     );
     partialFailedFiles.forEach((result) => {
-      console.log(`   ${result.file}`);
+      console.log(`   ${resultDisplayName(result)}`);
       if (result.error) {
         console.log(`     Error: ${result.error}`);
       }
@@ -370,7 +380,7 @@ export function printExecutionSummary(
   if (notExecutedFiles.length > 0) {
     console.log('\n⏸️ Not executed files');
     notExecutedFiles.forEach((result) => {
-      console.log(`   ${result.file}`);
+      console.log(`   ${resultDisplayName(result)}`);
     });
   }
 

packages/cli/src/framework/command.ts

@@ -9,6 +9,7 @@ import {
   printExecutionSummary,
   writeExecutionSummaryFile,
 } from '../execution-summary';
+import { isFeatureFile } from './feature-file';
 import {
   type GeneratedRstestYamlProject,
   type RstestYamlCaseOptions,
@@ -68,14 +69,20 @@ const readProjectResults = (
       ) as MidsceneYamlConfigResult;
     }
 
-    return createNotExecutedYamlResult(item.yamlFile);
+    return {
+      ...createNotExecutedYamlResult(item.yamlFile),
+      testName: item.testName,
+    };
   });
 
 export async function runFrameworkTestConfig(
   config: BatchRunnerConfig,
   commandOptions: FrameworkTestCommandOptions = {},
 ): Promise<number> {
   printExecutionPlan(config);
+  if (config.shareBrowserContext && config.files.some(isFeatureFile)) {
+    throw new Error('shareBrowserContext is not supported for .feature files');
+  }
 
   const projectDir = resolve(commandOptions.projectDir || process.cwd());
   const project = createRstestYamlProject({