@devicecloud.dev/dcd 4.2.4 → 4.2.6

package/dist/commands/cloud.d.ts

@@ -6,7 +6,7 @@ import { Command } from '@oclif/core';
  * - Flow file analysis and dependency resolution
  * - Device compatibility validation
  * - Test submission with parallel execution
- * - Real-time result polling with 5-second intervals
+ * - Real-time result polling with 10-second intervals
  * - Artifact download (reports, videos, logs)
  *
  * Replaces `maestro cloud` with DeviceCloud-specific functionality.
@@ -56,6 +56,7 @@ export default class Cloud extends Command {
         orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'android-no-snapshot': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
@@ -68,7 +69,7 @@ export default class Cloud extends Command {
     private moropoService;
     /** Service for downloading test reports and artifacts */
     private reportDownloadService;
-    /** Service for polling test results with 5-second intervals */
+    /** Service for polling test results with 10-second intervals */
     private resultsPollingService;
     /** Service for submitting tests to the API */
     private testSubmissionService;

package/dist/commands/cloud.js

@@ -31,7 +31,7 @@ process.on('warning', (warning) => {
  * - Flow file analysis and dependency resolution
  * - Device compatibility validation
  * - Test submission with parallel execution
- * - Real-time result polling with 5-second intervals
+ * - Real-time result polling with 10-second intervals
  * - Artifact download (reports, videos, logs)
  *
  * Replaces `maestro cloud` with DeviceCloud-specific functionality.
@@ -59,7 +59,7 @@ class Cloud extends core_1.Command {
     moropoService = new moropo_service_1.MoropoService();
     /** Service for downloading test reports and artifacts */
     reportDownloadService = new report_download_service_1.ReportDownloadService();
-    /** Service for polling test results with 5-second intervals */
+    /** Service for polling test results with 10-second intervals */
     resultsPollingService = new results_polling_service_1.ResultsPollingService();
     /** Service for submitting tests to the API */
     testSubmissionService = new test_submission_service_1.TestSubmissionService();
@@ -95,7 +95,7 @@ class Cloud extends core_1.Command {
         let jsonFile = false;
         try {
             const { args, flags, raw } = await this.parse(Cloud);
-            let { 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, 'junit-path': junitPath, 'allure-path': allurePath, 'html-path': htmlPath, async, config: configFile, debug, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, 'dry-run': dryRun, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'ignore-sha-check': ignoreShaCheck, 'include-tags': includeTags, 'ios-device': iOSDevice, 'ios-version': iOSVersion, json, 'json-file-name': jsonFileName, 'maestro-version': maestroVersion, metadata, mitmHost, mitmPath, 'moropo-v1-api-key': moropoApiKey, name, orientation, quiet, report, retry, 'runner-type': runnerType, } = flags;
+            let { 'android-api-level': androidApiLevel, 'android-device': androidDevice, apiKey: apiKeyFlag, apiUrl, 'app-binary-id': appBinaryId, 'app-file': appFile, 'artifacts-path': artifactsPath, 'junit-path': junitPath, 'allure-path': allurePath, 'html-path': htmlPath, async, config: configFile, debug, 'device-locale': deviceLocale, 'download-artifacts': downloadArtifacts, 'dry-run': dryRun, env, 'exclude-flows': excludeFlows, 'exclude-tags': excludeTags, flows, 'google-play': googlePlay, 'ignore-sha-check': ignoreShaCheck, 'include-tags': includeTags, 'ios-device': iOSDevice, 'ios-version': iOSVersion, json, 'json-file-name': jsonFileName, 'maestro-version': maestroVersion, metadata, mitmHost, mitmPath, 'moropo-v1-api-key': moropoApiKey, name, orientation, quiet, report, retry, 'runner-type': runnerType, 'android-no-snapshot': androidNoSnapshot, } = flags;
             // Store debug flag for use in catch block
             debugFlag = debug === true;
             jsonFile = flags['json-file'] === true;
@@ -242,7 +242,7 @@ class Cloud extends core_1.Command {
                 }
                 throw error;
             }
-            const { allExcludeTags, allIncludeTags, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, } = executionPlan;
+            const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, } = executionPlan;
             if (debug) {
                 this.log(`[DEBUG] All include tags: ${allIncludeTags?.join(', ') || 'none'}`);
                 this.log(`[DEBUG] All exclude tags: ${allExcludeTags?.join(', ') || 'none'}`);
@@ -263,6 +263,21 @@ class Cloud extends core_1.Command {
             if (debug) {
                 this.log(`[DEBUG] Common root directory: ${commonRoot}`);
             }
+            // Build testMetadataMap from flowMetadata (keyed by normalized test file name)
+            // This map provides flowName and tags for each test for JSON output
+            const testMetadataMap = {};
+            for (const [absolutePath, metadata] of Object.entries(flowMetadata)) {
+                // Normalize the path to match the format used in results (e.g., "./flows/test.yaml")
+                const normalizedPath = absolutePath.replaceAll(commonRoot, '.').split(path.sep).join('/');
+                const metadataRecord = metadata;
+                const flowName = metadataRecord?.name || path.parse(absolutePath).name;
+                const rawTags = metadataRecord?.tags;
+                const tags = Array.isArray(rawTags) ? rawTags.map(String) : (rawTags ? [String(rawTags)] : []);
+                testMetadataMap[normalizedPath] = { flowName, tags };
+            }
+            if (debug) {
+                this.log(`[DEBUG] Built testMetadataMap for ${Object.keys(testMetadataMap).length} flows`);
+            }
             const { continueOnFailure = true, flows: sequentialFlows = [] } = sequence ?? {};
             if (debug && sequentialFlows.length > 0) {
                 this.log(`[DEBUG] Sequential flows: ${sequentialFlows.join(', ')}`);
@@ -363,6 +378,7 @@ class Cloud extends core_1.Command {
             const testFormData = await this.testSubmissionService.buildTestFormData({
                 androidApiLevel,
                 androidDevice,
+                androidNoSnapshot,
                 appBinaryId: finalBinaryId,
                 cliVersion: this.config.version,
                 commonRoot,
@@ -420,8 +436,11 @@ class Cloud extends core_1.Command {
                     consoleUrl: url,
                     status: 'PENDING',
                     tests: results.map((r) => ({
+                        fileName: r.test_file_name,
+                        flowName: testMetadataMap[r.test_file_name]?.flowName || path.parse(r.test_file_name).name,
                         name: r.test_file_name,
                         status: r.status,
+                        tags: testMetadataMap[r.test_file_name]?.tags || [],
                     })),
                     uploadId: results[0].test_upload_id,
                 };
@@ -446,7 +465,7 @@ class Cloud extends core_1.Command {
                 logger: this.log.bind(this),
                 quiet,
                 uploadId: results[0].test_upload_id,
-            })
+            }, testMetadataMap)
                 .catch(async (error) => {
                 if (error instanceof results_polling_service_1.RunFailedError) {
                     // Handle failed test run

package/dist/config/flags/device.flags.d.ts

@@ -11,4 +11,5 @@ export declare const deviceFlags: {
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'android-no-snapshot': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
 };

package/dist/config/flags/device.flags.js

@@ -43,4 +43,8 @@ exports.deviceFlags = {
         default: false,
         description: '[Android only] Force Maestro-based Chrome onboarding - note: this will slow your tests but can fix browser related crashes. See https://docs.devicecloud.dev/reference/chrome-onboarding for more information.',
     }),
+    'android-no-snapshot': core_1.Flags.boolean({
+        default: false,
+        description: '[Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels.',
+    }),
 };

package/dist/constants.d.ts

@@ -43,6 +43,7 @@ export declare const flags: {
     orientation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'show-crosshairs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'maestro-chrome-onboarding': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    'android-no-snapshot': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     'app-binary-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'app-file': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     'ignore-sha-check': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/methods.js

@@ -647,6 +647,94 @@ async function readFileObjectChunk(file, start, end) {
     const arrayBuffer = await slice.arrayBuffer();
     return Buffer.from(arrayBuffer);
 }
+/**
+ * Reads a file chunk from either a File object or disk
+ * @param fileObject - Optional File object to read from
+ * @param filePath - Path to file on disk
+ * @param start - Start byte position
+ * @param end - End byte position
+ * @returns Promise resolving to Buffer containing the chunk
+ */
+async function readChunk(fileObject, filePath, start, end) {
+    return fileObject
+        ? readFileObjectChunk(fileObject, start, end)
+        : readFileChunk(filePath, start, end);
+}
+/**
+ * Calculates SHA1 hash for a buffer
+ * @param buffer - Buffer to hash
+ * @returns SHA1 hash as hex string
+ */
+function calculateSha1(buffer) {
+    const sha1 = (0, node_crypto_1.createHash)('sha1');
+    sha1.update(buffer);
+    return sha1.digest('hex');
+}
+/**
+ * Uploads a single part to Backblaze
+ * @param config - Configuration for the part upload
+ * @returns Promise that resolves when upload completes
+ */
+async function uploadPartToBackblaze(config) {
+    const { uploadUrl, authorizationToken, partBuffer, partLength, sha1Hex, partNumber, totalParts, debug } = config;
+    if (debug) {
+        console.log(`[DEBUG] Uploading part ${partNumber}/${totalParts} (${(partLength / 1024 / 1024).toFixed(2)} MB, SHA1: ${sha1Hex})`);
+    }
+    try {
+        const response = await fetch(uploadUrl, {
+            body: new Uint8Array(partBuffer),
+            headers: {
+                Authorization: authorizationToken,
+                'Content-Length': partLength.toString(),
+                'X-Bz-Content-Sha1': sha1Hex,
+                'X-Bz-Part-Number': partNumber.toString(),
+            },
+            method: 'POST',
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            if (debug) {
+                console.error(`[DEBUG] Part ${partNumber} upload failed with status ${response.status}: ${errorText}`);
+            }
+            throw new Error(`Part ${partNumber} upload failed with status ${response.status}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof TypeError && error.message === 'fetch failed') {
+            if (debug) {
+                console.error(`[DEBUG] Network error uploading part ${partNumber} - could be DNS, connection, or SSL issue`);
+            }
+            throw new Error(`Part ${partNumber} upload failed due to network error`);
+        }
+        throw error;
+    }
+    if (debug) {
+        console.log(`[DEBUG] Part ${partNumber}/${totalParts} uploaded successfully`);
+    }
+}
+/**
+ * Logs detailed error information for Backblaze upload failures
+ * @param error - The error that occurred
+ * @param debug - Whether debug logging is enabled
+ * @returns void
+ */
+function logBackblazeUploadError(error, debug) {
+    if (debug) {
+        console.error('[DEBUG] === BACKBLAZE LARGE FILE UPLOAD EXCEPTION ===');
+        console.error('[DEBUG] Large file upload exception:', error);
+        console.error(`[DEBUG] Error type: ${error instanceof Error ? error.name : typeof error}`);
+        console.error(`[DEBUG] Error message: ${error instanceof Error ? error.message : String(error)}`);
+        if (error instanceof Error && error.stack) {
+            console.error(`[DEBUG] Stack trace:\n${error.stack}`);
+        }
+    }
+    if (error instanceof Error && error.message.includes('network error')) {
+        console.warn('Warning: Backblaze large file upload failed due to network error');
+    }
+    else {
+        console.warn(`Warning: Backblaze large file upload failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 /**
  * Upload large file to Backblaze using multi-part upload with streaming (for files >= 5MB)
  * Uses file streaming to avoid loading entire file into memory, preventing OOM errors on large files
@@ -657,7 +745,6 @@ async function uploadLargeFileToBackblaze(config) {
     const { apiUrl, apiKey, fileId, uploadPartUrls, filePath, fileSize, debug, fileObject } = config;
     try {
         const partSha1Array = [];
-        // Calculate part size (divide file evenly across all parts)
         const partSize = Math.ceil(fileSize / uploadPartUrls.length);
         if (debug) {
             console.log(`[DEBUG] Uploading large file in ${uploadPartUrls.length} parts (streaming mode)`);
@@ -673,87 +760,38 @@ async function uploadLargeFileToBackblaze(config) {
             if (debug) {
                 console.log(`[DEBUG] Reading part ${partNumber}/${uploadPartUrls.length} bytes ${start}-${end}`);
             }
-            // Read part from File object (for .app bundles) or from disk
-            const partBuffer = fileObject
-                ? await readFileObjectChunk(fileObject, start, end)
-                : await readFileChunk(filePath, start, end);
-            // Calculate SHA1 for this part
-            const sha1 = (0, node_crypto_1.createHash)('sha1');
-            sha1.update(partBuffer);
-            const sha1Hex = sha1.digest('hex');
+            const partBuffer = await readChunk(fileObject, filePath, start, end);
+            const sha1Hex = calculateSha1(partBuffer);
             partSha1Array.push(sha1Hex);
-            if (debug) {
-                console.log(`[DEBUG] Uploading part ${partNumber}/${uploadPartUrls.length} (${(partLength / 1024 / 1024).toFixed(2)} MB, SHA1: ${sha1Hex})`);
-            }
-            try {
-                const response = await fetch(uploadPartUrls[i].uploadUrl, {
-                    body: new Uint8Array(partBuffer),
-                    headers: {
-                        Authorization: uploadPartUrls[i].authorizationToken,
-                        'Content-Length': partLength.toString(),
-                        'X-Bz-Content-Sha1': sha1Hex,
-                        'X-Bz-Part-Number': partNumber.toString(),
-                    },
-                    method: 'POST',
-                });
-                if (!response.ok) {
-                    const errorText = await response.text();
-                    if (debug) {
-                        console.error(`[DEBUG] Part ${partNumber} upload failed with status ${response.status}: ${errorText}`);
-                    }
-                    throw new Error(`Part ${partNumber} upload failed with status ${response.status}`);
-                }
-            }
-            catch (error) {
-                if (error instanceof TypeError && error.message === 'fetch failed') {
-                    if (debug) {
-                        console.error(`[DEBUG] Network error uploading part ${partNumber} - could be DNS, connection, or SSL issue`);
-                    }
-                    throw new Error(`Part ${partNumber} upload failed due to network error`);
-                }
-                throw error;
-            }
-            if (debug) {
-                console.log(`[DEBUG] Part ${partNumber}/${uploadPartUrls.length} uploaded successfully`);
-            }
+            await uploadPartToBackblaze({
+                authorizationToken: uploadPartUrls[i].authorizationToken,
+                debug,
+                partBuffer,
+                partLength,
+                partNumber,
+                sha1Hex,
+                totalParts: uploadPartUrls.length,
+                uploadUrl: uploadPartUrls[i].uploadUrl,
+            });
         }
         // Validate all parts were uploaded
         if (partSha1Array.length !== uploadPartUrls.length) {
             const errorMsg = `Part count mismatch: uploaded ${partSha1Array.length} parts but expected ${uploadPartUrls.length}`;
-            if (debug) {
+            if (debug)
                 console.error(`[DEBUG] ${errorMsg}`);
-            }
             throw new Error(errorMsg);
         }
-        // Finish the large file upload
         if (debug) {
             console.log('[DEBUG] Finishing large file upload...');
             console.log(`[DEBUG] Finalizing ${partSha1Array.length} parts with fileId: ${fileId}`);
         }
         await api_gateway_1.ApiGateway.finishLargeFile(apiUrl, apiKey, fileId, partSha1Array);
-        if (debug) {
+        if (debug)
             console.log('[DEBUG] Large file upload completed successfully');
-        }
         return true;
     }
     catch (error) {
-        if (debug) {
-            console.error('[DEBUG] === BACKBLAZE LARGE FILE UPLOAD EXCEPTION ===');
-            console.error('[DEBUG] Large file upload exception:', error);
-            console.error(`[DEBUG] Error type: ${error instanceof Error ? error.name : typeof error}`);
-            console.error(`[DEBUG] Error message: ${error instanceof Error ? error.message : String(error)}`);
-            if (error instanceof Error && error.stack) {
-                console.error(`[DEBUG] Stack trace:\n${error.stack}`);
-            }
-        }
-        // Provide more specific error messages
-        if (error instanceof Error && error.message.includes('network error')) {
-            console.warn('Warning: Backblaze large file upload failed due to network error');
-        }
-        else {
-            // Don't throw - we don't want Backblaze failures to block the primary upload
-            console.warn(`Warning: Backblaze large file upload failed: ${error instanceof Error ? error.message : String(error)}`);
-        }
+        logBackblazeUploadError(error, debug);
         return false;
     }
 }

package/dist/services/execution-plan.service.js

@@ -89,6 +89,104 @@ function extractDeviceCloudOverrides(config) {
     }
     return overrides;
 }
+/**
+ * Generate execution plan for a single flow file
+ * @param normalizedInput - Normalized path to the flow file
+ * @returns Execution plan for the single file with dependencies
+ */
+async function planSingleFile(normalizedInput) {
+    if (normalizedInput.endsWith('config.yaml') ||
+        normalizedInput.endsWith('config.yml')) {
+        throw new Error('If using config.yaml, pass the workspace folder path, not the config file or a custom path via --config');
+    }
+    const { config } = (0, execution_plan_utils_1.readTestYamlFileAsJson)(normalizedInput);
+    const flowMetadata = {};
+    const flowOverrides = {};
+    if (config) {
+        flowMetadata[normalizedInput] = config;
+        flowOverrides[normalizedInput] = extractDeviceCloudOverrides(config);
+    }
+    const checkedDependancies = await checkDependencies(normalizedInput);
+    return {
+        flowMetadata,
+        flowOverrides,
+        flowsToRun: [normalizedInput],
+        referencedFiles: [...new Set(checkedDependancies)],
+        totalFlowFiles: 1,
+    };
+}
+/**
+ * Apply workspace.flows glob patterns to filter flow files
+ * @param workspaceConfig - Workspace configuration containing flow globs
+ * @param normalizedInput - Normalized path to the workspace directory
+ * @param unfilteredFlowFiles - List of all discovered flow files
+ * @param configFile - Optional custom config file path
+ * @returns Filtered list of flow file paths matching the globs
+ */
+async function applyFlowGlobs(workspaceConfig, normalizedInput, unfilteredFlowFiles, configFile) {
+    if (workspaceConfig.flows) {
+        const globs = workspaceConfig.flows.map((g) => g);
+        const matchedFiles = await (0, glob_1.glob)(globs, {
+            cwd: normalizedInput,
+            nodir: true,
+        });
+        return matchedFiles
+            .filter((file) => {
+            if (file === 'config.yaml' || file === 'config.yml')
+                return false;
+            if (configFile && file === path.basename(configFile))
+                return false;
+            if (!file.endsWith('.yaml') && !file.endsWith('.yml'))
+                return false;
+            const pathParts = file.split(path.sep);
+            for (const part of pathParts) {
+                if (part.endsWith('.app'))
+                    return false;
+            }
+            return true;
+        })
+            .map((file) => path.resolve(normalizedInput, file));
+    }
+    return unfilteredFlowFiles.filter((file) => !file.endsWith('config.yaml') &&
+        !file.endsWith('config.yml') &&
+        (!configFile || !file.endsWith(configFile)));
+}
+/**
+ * Resolve sequential execution order from workspace config
+ * @param workspaceConfig - Workspace configuration with executionOrder
+ * @param pathsByName - Map of flow names to their file paths
+ * @param debug - Whether to output debug logging
+ * @returns Array of flow paths in sequential execution order
+ */
+function resolveSequentialFlows(workspaceConfig, pathsByName, debug) {
+    if (!workspaceConfig.executionOrder?.flowsOrder) {
+        return [];
+    }
+    if (debug) {
+        console.log('[DEBUG] executionOrder.flowsOrder:', workspaceConfig.executionOrder.flowsOrder);
+        console.log('[DEBUG] Available flow names:', Object.keys(pathsByName));
+    }
+    const flowsToRunInSequence = workspaceConfig.executionOrder.flowsOrder
+        .flatMap((flowOrder) => {
+        const normalizedFlowOrder = flowOrder.replace(/\.ya?ml$/i, '');
+        if (debug && flowOrder !== normalizedFlowOrder) {
+            console.log(`[DEBUG] Stripping trailing extension: "${flowOrder}" -> "${normalizedFlowOrder}"`);
+        }
+        return (0, execution_plan_utils_1.getFlowsToRunInSequence)(pathsByName, [normalizedFlowOrder], debug);
+    });
+    if (debug) {
+        console.log(`[DEBUG] Sequential flows resolved: ${flowsToRunInSequence.length} flow(s)`);
+    }
+    if (workspaceConfig.executionOrder.flowsOrder.length > 0 &&
+        flowsToRunInSequence.length === 0) {
+        console.warn(`Warning: executionOrder specified ${workspaceConfig.executionOrder.flowsOrder.length} flow(s) but none were found.\n` +
+            `This may be intentional if flows were excluded by tags.\n\n` +
+            `Expected flows: ${workspaceConfig.executionOrder.flowsOrder.join(', ')}\n` +
+            `Available flow names: ${Object.keys(pathsByName).join(', ')}\n\n` +
+            `Hint: Flow names come from either the 'name' field in the flow config or the filename without extension.`);
+    }
+    return flowsToRunInSequence;
+}
 /**
  * Generate execution plan for test flows
  *
@@ -113,24 +211,7 @@ async function plan(options) {
         throw new Error(`Flow path does not exist: ${path.resolve(normalizedInput)}`);
     }
     if (fs.lstatSync(normalizedInput).isFile()) {
-        if (normalizedInput.endsWith('config.yaml') ||
-            normalizedInput.endsWith('config.yml')) {
-            throw new Error('If using config.yaml, pass the workspace folder path, not the config file or a custom path via --config');
-        }
-        const { config } = (0, execution_plan_utils_1.readTestYamlFileAsJson)(normalizedInput);
-        const flowOverrides = {};
-        if (config) {
-            flowMetadata[normalizedInput] = config;
-            flowOverrides[normalizedInput] = extractDeviceCloudOverrides(config);
-        }
-        const checkedDependancies = await checkDependencies(normalizedInput);
-        return {
-            flowMetadata,
-            flowOverrides,
-            flowsToRun: [normalizedInput],
-            referencedFiles: [...new Set(checkedDependancies)],
-            totalFlowFiles: 1,
-        };
+        return planSingleFile(normalizedInput);
     }
     let unfilteredFlowFiles = await (0, execution_plan_utils_1.readDirectory)(normalizedInput, execution_plan_utils_1.isFlowFile);
     if (unfilteredFlowFiles.length === 0) {
@@ -148,70 +229,26 @@ async function plan(options) {
     else {
         workspaceConfig = getWorkspaceConfig(normalizedInput, unfilteredFlowFiles);
     }
-    if (workspaceConfig.flows) {
-        const globs = workspaceConfig.flows.map((glob) => glob);
-        const matchedFiles = await (0, glob_1.glob)(globs, {
-            cwd: normalizedInput,
-            nodir: true,
-        });
-        // overwrite the list of files with the globbed ones
-        unfilteredFlowFiles = matchedFiles
-            .filter((file) => {
-            // Exclude config files
-            if (file === 'config.yaml' || file === 'config.yml') {
-                return false;
-            }
-            // Exclude config file if specified
-            if (configFile && file === path.basename(configFile)) {
-                return false;
-            }
-            // Check file extension
-            if (!file.endsWith('.yaml') && !file.endsWith('.yml')) {
-                return false;
-            }
-            // Exclude files inside .app bundles
-            // Check if any directory in the path ends with .app
-            const pathParts = file.split(path.sep);
-            for (const part of pathParts) {
-                if (part.endsWith('.app')) {
-                    return false;
-                }
-            }
-            return true;
-        })
-            .map((file) => path.resolve(normalizedInput, file));
-    }
-    else {
-        // workspace config has no flows, so we need to remove the config file from the test list
-        unfilteredFlowFiles = unfilteredFlowFiles.filter((file) => !file.endsWith('config.yaml') &&
-            !file.endsWith('config.yml') &&
-            (!configFile || !file.endsWith(configFile)));
-    }
+    unfilteredFlowFiles = await applyFlowGlobs(workspaceConfig, normalizedInput, unfilteredFlowFiles, configFile);
     if (unfilteredFlowFiles.length === 0) {
         const error = workspaceConfig.flows
             ? new Error(`Flow inclusion pattern(s) did not match any Flow files:\n${workspaceConfig.flows.join('\n')}`)
             : new Error(`Workspace does not contain any Flows: ${path.resolve(normalizedInput)}`);
         throw error;
     }
-    const configPerFlowFile = 
     // eslint-disable-next-line unicorn/no-array-reduce
-    unfilteredFlowFiles.reduce((acc, filePath) => {
+    const configPerFlowFile = unfilteredFlowFiles.reduce((acc, filePath) => {
         const { config } = (0, execution_plan_utils_1.readTestYamlFileAsJson)(filePath);
         acc[filePath] = config;
         return acc;
     }, {});
-    const allIncludeTags = [
-        ...includeTags,
-        ...(workspaceConfig.includeTags || []),
-    ];
-    const allExcludeTags = [
-        ...excludeTags,
-        ...(workspaceConfig.excludeTags || []),
-    ];
+    const allIncludeTags = [...includeTags, ...(workspaceConfig.includeTags || [])];
+    const allExcludeTags = [...excludeTags, ...(workspaceConfig.excludeTags || [])];
     const flowOverrides = {};
     const allFlows = unfilteredFlowFiles.filter((filePath) => {
         const config = configPerFlowFile[filePath];
-        const tags = config?.tags || [];
+        const rawTags = config?.tags;
+        const tags = Array.isArray(rawTags) ? rawTags : (rawTags ? [rawTags] : []);
         if (config) {
             flowMetadata[filePath] = config;
             flowOverrides[filePath] = extractDeviceCloudOverrides(config);
@@ -224,7 +261,6 @@ async function plan(options) {
     if (allFlows.length === 0) {
         throw new Error(`Include / Exclude tags did not match any Flows:\n\nInclude Tags:\n${allIncludeTags.join('\n')}\n\nExclude Tags:\n${allExcludeTags.join('\n')}`);
     }
-    // Check dependencies only for the filtered flows
     const allFiles = await Promise.all(allFlows.map((filePath) => checkDependencies(filePath))).then((results) => [...new Set(results.flat())]);
     // eslint-disable-next-line unicorn/no-array-reduce
     const pathsByName = allFlows.reduce((acc, filePath) => {
@@ -236,35 +272,7 @@ async function plan(options) {
         }
         return acc;
     }, {});
-    if (debug && workspaceConfig.executionOrder?.flowsOrder) {
-        console.log('[DEBUG] executionOrder.flowsOrder:', workspaceConfig.executionOrder.flowsOrder);
-        console.log('[DEBUG] Available flow names:', Object.keys(pathsByName));
-    }
-    const flowsToRunInSequence = workspaceConfig.executionOrder?.flowsOrder
-        ?.map((flowOrder) => {
-        // Strip .yaml/.yml extension only from the END of the string
-        // This supports flowsOrder entries like "my_test.yml" matching "my_test"
-        // while preserving extensions in the middle like "(file.yml) Name"
-        const normalizedFlowOrder = flowOrder.replace(/\.ya?ml$/i, '');
-        if (debug && flowOrder !== normalizedFlowOrder) {
-            console.log(`[DEBUG] Stripping trailing extension: "${flowOrder}" -> "${normalizedFlowOrder}"`);
-        }
-        return (0, execution_plan_utils_1.getFlowsToRunInSequence)(pathsByName, [normalizedFlowOrder], debug);
-    })
-        .flat() || [];
-    if (debug) {
-        console.log(`[DEBUG] Sequential flows resolved: ${flowsToRunInSequence.length} flow(s)`);
-    }
-    // Validate that all specified flows were found
-    if (workspaceConfig.executionOrder?.flowsOrder &&
-        workspaceConfig.executionOrder.flowsOrder.length > 0 &&
-        flowsToRunInSequence.length === 0) {
-        console.warn(`Warning: executionOrder specified ${workspaceConfig.executionOrder.flowsOrder.length} flow(s) but none were found.\n` +
-            `This may be intentional if flows were excluded by tags.\n\n` +
-            `Expected flows: ${workspaceConfig.executionOrder.flowsOrder.join(', ')}\n` +
-            `Available flow names: ${Object.keys(pathsByName).join(', ')}\n\n` +
-            `Hint: Flow names come from either the 'name' field in the flow config or the filename without extension.`);
-    }
+    const flowsToRunInSequence = resolveSequentialFlows(workspaceConfig, pathsByName, debug);
     const normalFlows = allFlows
         .filter((flow) => !flowsToRunInSequence.includes(flow))
         .sort((a, b) => a.localeCompare(b));

package/dist/services/results-polling.service.d.ts

@@ -17,14 +17,28 @@ export interface PollingOptions {
     quiet?: boolean;
     uploadId: string;
 }
+/** Metadata for a test flow extracted from YAML config */
+export interface TestMetadata {
+    /** Flow name from YAML config 'name' field or filename without extension */
+    flowName: string;
+    /** Tags from YAML config 'tags' field */
+    tags: string[];
+}
 export interface PollingResult {
     consoleUrl: string;
     status: 'FAILED' | 'PASSED';
     tests: Array<{
         durationSeconds: null | number;
         failReason?: string;
+        /** File path of the test (same as name, for clarity) */
+        fileName: string;
+        /** Flow name from YAML config or filename without extension */
+        flowName: string;
+        /** Test file name (unchanged for backwards compatibility) */
         name: string;
         status: string;
+        /** Tags from YAML config (empty array if none) */
+        tags: string[];
     }>;
     uploadId: string;
 }
@@ -38,9 +52,10 @@ export declare class ResultsPollingService {
      * Poll for test results until all tests complete
      * @param results Initial test results from submission
      * @param options Polling configuration
+     * @param testMetadata Optional metadata map for each test (flowName, tags)
      * @returns Promise that resolves with final test results or rejects if tests fail
      */
-    pollUntilComplete(results: TestResult[], options: PollingOptions): Promise<PollingResult>;
+    pollUntilComplete(results: TestResult[], options: PollingOptions, testMetadata?: Record<string, TestMetadata>): Promise<PollingResult>;
     private buildPollingResult;
     private calculateStatusSummary;
     private displayFinalResults;

package/dist/services/results-polling.service.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResultsPollingService = exports.RunFailedError = void 0;
 const core_1 = require("@oclif/core");
 const cli_ux_1 = require("@oclif/core/lib/cli-ux");
+const path = require("node:path");
 const api_gateway_1 = require("../gateways/api-gateway");
 const methods_1 = require("../methods");
 const connectivity_1 = require("../utils/connectivity");
@@ -24,14 +25,15 @@ exports.RunFailedError = RunFailedError;
  */
 class ResultsPollingService {
     MAX_SEQUENTIAL_FAILURES = 10;
-    POLL_INTERVAL_MS = 5000;
+    POLL_INTERVAL_MS = 10_000;
     /**
      * Poll for test results until all tests complete
      * @param results Initial test results from submission
      * @param options Polling configuration
+     * @param testMetadata Optional metadata map for each test (flowName, tags)
      * @returns Promise that resolves with final test results or rejects if tests fail
      */
-    async pollUntilComplete(results, options) {
+    async pollUntilComplete(results, options, testMetadata) {
         const { apiUrl, apiKey, uploadId, consoleUrl, quiet = false, json = false, debug = false, logger } = options;
         this.initializePollingDisplay(json, logger);
         let sequentialPollFailures = 0;
@@ -53,6 +55,7 @@ class ResultsPollingService {
                         debug,
                         json,
                         logger,
+                        testMetadata,
                         uploadId,
                     });
                 }
@@ -74,7 +77,7 @@ class ResultsPollingService {
             }
         }
     }
-    buildPollingResult(results, uploadId, consoleUrl) {
+    buildPollingResult(results, uploadId, consoleUrl, testMetadata) {
         const resultsWithoutEarlierTries = this.filterLatestResults(results);
         return {
             consoleUrl,
@@ -84,8 +87,11 @@ class ResultsPollingService {
             tests: resultsWithoutEarlierTries.map((r) => ({
                 durationSeconds: r.duration_seconds,
                 failReason: r.status === 'FAILED' ? r.fail_reason || 'No reason provided' : undefined,
+                fileName: r.test_file_name,
+                flowName: testMetadata?.[r.test_file_name]?.flowName || path.parse(r.test_file_name).name,
                 name: r.test_file_name,
                 status: r.status,
+                tags: testMetadata?.[r.test_file_name]?.tags || [],
             })),
             uploadId,
         };
@@ -219,12 +225,12 @@ class ResultsPollingService {
      * @returns Promise resolving to final polling result
      */
     async handleCompletedTests(updatedResults, options) {
-        const { uploadId, consoleUrl, json, debug, logger } = options;
+        const { uploadId, consoleUrl, json, debug, logger, testMetadata } = options;
         if (debug && logger) {
             logger(`[DEBUG] All tests completed, stopping poll`);
         }
         this.displayFinalResults(updatedResults, consoleUrl, json, logger);
-        const output = this.buildPollingResult(updatedResults, uploadId, consoleUrl);
+        const output = this.buildPollingResult(updatedResults, uploadId, consoleUrl, testMetadata);
         if (output.status === 'FAILED') {
             if (debug && logger) {
                 logger(`[DEBUG] Some tests failed, returning failed status`);

package/dist/services/test-submission.service.d.ts

@@ -2,6 +2,7 @@ import { IExecutionPlan } from './execution-plan.service';
 export interface TestSubmissionConfig {
     androidApiLevel?: string;
     androidDevice?: string;
+    androidNoSnapshot?: boolean;
     appBinaryId: string;
     cliVersion: string;
     commonRoot: string;

package/dist/services/test-submission.service.js

@@ -17,7 +17,7 @@ class TestSubmissionService {
      * @returns FormData ready to be submitted to the API
      */
     async buildTestFormData(config) {
-        const { appBinaryId, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, mitmHost, mitmPath, retry, continueOnFailure = true, report, showCrosshairs, maestroChromeOnboarding, raw, debug = false, logger, } = config;
+        const { appBinaryId, flowFile, executionPlan, commonRoot, cliVersion, env = [], metadata = [], googlePlay = false, androidApiLevel, androidDevice, androidNoSnapshot, iOSVersion, iOSDevice, name, runnerType, maestroVersion, deviceLocale, orientation, mitmHost, mitmPath, retry, continueOnFailure = true, report, showCrosshairs, maestroChromeOnboarding, raw, debug = false, logger, } = config;
         const { allExcludeTags, allIncludeTags, flowMetadata, flowOverrides, flowsToRun: testFileNames, referencedFiles, sequence, workspaceConfig, } = executionPlan;
         const { flows: sequentialFlows = [] } = sequence ?? {};
         const testFormData = new FormData();
@@ -69,6 +69,7 @@ class TestSubmissionService {
         const configPayload = {
             allExcludeTags,
             allIncludeTags,
+            androidNoSnapshot,
             autoRetriesRemaining: retry,
             continueOnFailure,
             deviceLocale,

package/dist/types/schema.types.d.ts

@@ -343,7 +343,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/org/increase_credits": {
+    "/org/paddle-webhook": {
         parameters: {
             query?: never;
             header?: never;
@@ -352,7 +352,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["OrgController_paddleTransactionCompleted"];
+        post: operations["OrgController_handlePaddleWebhook"];
         delete?: never;
         options?: never;
         head?: never;
@@ -407,6 +407,54 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/org/subscriptions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["OrgController_getAllSubscriptions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/org/update-overage-limit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["OrgController_updateOverageLimit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/org/usage-history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["OrgController_getUsageHistory"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/frontend/check-domain-saml": {
         parameters: {
             query?: never;
@@ -439,6 +487,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/billing/create-subscription": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["BillingController_createSubscription"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -457,11 +521,15 @@ export interface components {
             test_upload_id: string;
         };
         IGetBinaryUploadUrlArgs: {
+            /**
+             * @description Platform for the binary upload (ios or android)
+             * @enum {string}
+             */
+            platform: "ios" | "android";
             /** @description File size in bytes (optional, for Backblaze upload strategy) */
             fileSize?: number;
             /** @description Whether client uses TUS resumable uploads (true for new clients, undefined/false for legacy) */
             useTus?: boolean;
-            platform: Record<string, never>;
         };
         B2SimpleUpload: {
             uploadUrl: string;
@@ -497,6 +565,7 @@ export interface components {
             token?: string;
         };
         ICheckForExistingUploadArgs: {
+            /** @description SHA-256 hash of the binary file */
             sha: string;
         };
         ICheckForExistingUploadResponse: {
@@ -504,6 +573,10 @@ export interface components {
             exists: boolean;
         };
         IFinaliseUploadArgs: {
+            /** @description Unique upload identifier */
+            id: string;
+            /** @description Storage path for the uploaded file */
+            path: string;
             /** @description File metadata (bundle ID, package name, platform) - required for new clients */
             metadata?: Record<string, never>;
             /** @description SHA-256 hash of the file - required for new clients */
@@ -520,8 +593,6 @@ export interface components {
             backblazeSuccess: boolean;
             /** @description Whether client uses TUS resumable uploads (true for new clients, undefined/false for legacy) */
             useTus?: boolean;
-            id: string;
-            path: string;
         };
         IFinaliseUploadResponse: Record<string, never>;
         IFinishLargeFileArgs: {
@@ -549,18 +620,25 @@ export interface components {
              * @description This file must be a zip file
              */
             file: string;
+            testFileNames?: string;
+            sequentialFlows?: string;
             /** @enum {string} */
             androidApiLevel?: "29" | "30" | "31" | "32" | "33" | "34" | "35" | "36";
             /** @enum {string} */
             androidDevice?: "pixel-6" | "pixel-6-pro" | "pixel-7" | "pixel-7-pro" | "generic-tablet";
             apiKey?: string;
             apiUrl?: string;
+            appBinaryId: string;
             appFile?: string;
+            env: string;
             /** @enum {string} */
             iOSVersion?: "16" | "17" | "18" | "26";
             /** @enum {string} */
             iOSDevice?: "iphone-14" | "iphone-14-pro" | "iphone-15" | "iphone-15-pro" | "iphone-16" | "iphone-16-plus" | "iphone-16-pro" | "iphone-16-pro-max" | "ipad-pro-6th-gen";
             platform?: string;
+            googlePlay: boolean;
+            config: string;
+            name?: string;
             /** @enum {string} */
             runnerType?: "m4" | "m1" | "default" | "gpu1" | "cpu1";
             metadata?: string;
@@ -569,13 +647,6 @@ export interface components {
             testFileOverrides?: string;
             /** @description SHA-256 hash of the flow ZIP file */
             sha?: string;
-            testFileNames?: string;
-            sequentialFlows?: string;
-            appBinaryId: string;
-            env: string;
-            googlePlay: boolean;
-            config: string;
-            name: string;
         };
         IRetryTestArgs: {
             resultId: number;
@@ -1302,10 +1373,11 @@ export interface operations {
                      *             "2.0.2",
                      *             "2.0.3",
                      *             "2.0.4",
-                     *             "2.0.9"
+                     *             "2.0.9",
+                     *             "2.1.0"
                      *           ],
                      *           "defaultVersion": "1.41.0",
-                     *           "latestVersion": "2.0.9"
+                     *           "latestVersion": "2.1.0"
                      *         }
                      *       }
                      *     }
@@ -1499,7 +1571,7 @@ export interface operations {
             };
         };
     };
-    OrgController_paddleTransactionCompleted: {
+    OrgController_handlePaddleWebhook: {
         parameters: {
             query?: never;
             header: {
@@ -1510,7 +1582,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Success. */
+            /** @description Paddle webhook handler. */
             201: {
                 headers: {
                     [name: string]: unknown;
@@ -1605,6 +1677,97 @@ export interface operations {
             };
         };
     };
+    OrgController_getAllSubscriptions: {
+        parameters: {
+            query?: never;
+            header: {
+                "x-app-api-key": string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orgId: string;
+                };
+            };
+        };
+        responses: {
+            /** @description All subscription data fetched successfully. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
+    OrgController_updateOverageLimit: {
+        parameters: {
+            query?: never;
+            header: {
+                "x-app-api-key": string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orgId: string;
+                    overageLimit: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Overage limit updated successfully. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
+    OrgController_getUsageHistory: {
+        parameters: {
+            query?: never;
+            header: {
+                "x-app-api-key": string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    orgId: string;
+                    /** @enum {string} */
+                    format?: "json" | "csv";
+                    /** Format: date-time */
+                    startDate?: string;
+                    /** Format: date-time */
+                    endDate?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Usage history fetched successfully. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown[];
+                };
+            };
+        };
+    };
     FrontendController_checkDomainSaml: {
         parameters: {
             query?: never;
@@ -1680,4 +1843,41 @@ export interface operations {
             };
         };
     };
+    BillingController_createSubscription: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    items: {
+                        price_id?: string;
+                        quantity?: number;
+                    }[];
+                    customer_email?: string;
+                    custom_data?: {
+                        orgId?: string;
+                        userId?: string;
+                    };
+                    billing_details?: {
+                        enable_checkout?: boolean;
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description Subscription created successfully. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+        };
+    };
 }

package/oclif.manifest.json

@@ -175,6 +175,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "android-no-snapshot": {
+          "description": "[Android only] Force cold boot instead of using snapshot boot. This is automatically enabled for API 35+ but can be used to force cold boot on older API levels.",
+          "name": "android-no-snapshot",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "env": {
           "char": "e",
           "description": "One or more environment variables to inject into your flows",
@@ -667,5 +673,5 @@
       ]
     }
   },
-  "version": "4.2.4"
+  "version": "4.2.6"
 }

package/package.json

@@ -67,7 +67,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "4.2.4",
+  "version": "4.2.6",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },