prompttest 1.5.0 → 1.5.2

package/dist/lib/adb.d.ts

@@ -18,6 +18,8 @@ export interface AndroidDevice {
     model?: string;
     /** The product name of the device (optional) */
     product?: string;
+    /** Transport connection type: 'usb' | 'wifi' | 'emulator' */
+    connectionType?: 'usb' | 'wifi' | 'emulator';
 }
 export interface DeviceMetrics {
     battery?: {
@@ -42,6 +44,16 @@ export interface DeviceMetrics {
     };
 }
 export declare function parseDeviceMetrics(batteryOutput: string, displayOutput: string, memoryOutput: string, graphicsOutput: string): DeviceMetrics;
+/**
+ * Classifies a device connection type from its serial or model properties.
+ */
+export declare function classifyDeviceConnection(serial: string): 'usb' | 'wifi' | 'emulator';
+/**
+ * Deduplicates multiple transport connections for the same physical Android hardware.
+ * Priority: USB > Wi-Fi (IP:port) > Wi-Fi (mDNS) > Emulator.
+ * Prevents simultaneous execution collisions on the same physical phone.
+ */
+export declare function deduplicateDevices(devices: AndroidDevice[]): AndroidDevice[];
 /**
  * AndroidDriver is responsible for executing ADB commands and handling device interactions.
  * It manages the default targeted device, executes shell commands, extracts device state,
@@ -113,10 +125,23 @@ export declare class AndroidDriver {
      */
     execAdbBinary(args: readonly string[] | string[], serial?: string, timeoutMs?: number): Promise<Buffer>;
     /**
-     * Retrieves a list of currently connected Android devices and their statuses.
+    /**
+     * Retrieves all raw connected Android devices from ADB without deduplication.
+     */
+    getRawConnectedDevices(): Promise<AndroidDevice[]>;
+    /**
+     * Retrieves a list of currently connected Android devices.
+     * By default, deduplicates multiple transport channels for the same physical phone (prioritizing USB > Wi-Fi).
+     * @param options.deduplicate Set to false to return raw unfiltered endpoints.
      * @returns A promise resolving to an array of AndroidDevice objects.
      */
-    getConnectedDevices(): Promise<AndroidDevice[]>;
+    getConnectedDevices(options?: {
+        deduplicate?: boolean;
+    }): Promise<AndroidDevice[]>;
+    /**
+     * Helper utility to deduplicate a list of AndroidDevice items.
+     */
+    deduplicateDevices(devices: AndroidDevice[]): AndroidDevice[];
     /**
      * Wakes up the device screen and attempts to dismiss the keyguard.
      * @param serial Optional target device serial.

package/dist/lib/ci.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @file ci.ts
+ * @description One-Command CI/CD Workflow Scaffolder for PromptTest (CI-01).
+ * Generates automated regression workflows for GitHub Actions (using reactivecircus/android-emulator-runner)
+ * and GitLab CI with headless emulator virtualization and artifact reporting.
+ */
+export type CiProvider = 'github-actions' | 'gitlab-ci';
+export type CiTrigger = 'push' | 'pull_request' | 'schedule';
+export type CiTarget = 'specs' | 'explore';
+export interface CiWorkflowOptions {
+    /** Target CI provider platform */
+    provider?: CiProvider;
+    /** Trigger events to invoke the pipeline */
+    triggers?: CiTrigger[];
+    /** Execution mode: running specs vs autonomous exploration */
+    target?: CiTarget;
+    /** Spec file or glob pattern to execute */
+    specPattern?: string;
+    /** Target Android package name (required for explore target) */
+    packageName?: string;
+    /** Node.js runtime version to configure */
+    nodeVersion?: number;
+    /** Android API level for the emulator runner */
+    apiLevel?: number;
+    /** CPU architecture for the emulator image */
+    arch?: string;
+}
+export interface CiInitResult {
+    provider: CiProvider;
+    filePath: string;
+    fileName: string;
+    content: string;
+}
+/**
+ * Synthesizes a production-ready GitHub Actions YAML workflow
+ * utilizing headless Android emulator runners and artifact publishing.
+ */
+export declare function generateGithubWorkflow(options?: CiWorkflowOptions): string;
+/**
+ * Synthesizes a GitLab CI YAML configuration.
+ */
+export declare function generateGitlabWorkflow(options?: CiWorkflowOptions): string;
+/**
+ * Scaffolds the CI workflow file directly into the repository directory.
+ */
+export declare function initCi(options?: CiWorkflowOptions & {
+    destDir?: string;
+    customFileName?: string;
+}): Promise<CiInitResult>;

package/dist/lib/license.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module license
+ * @description
+ * Viral Report Attribution & Offline Pro Licensing (LC-01).
+ * Cryptographically validates offline license keys, stores activation state,
+ * and controls white-label report formatting.
+ */
+export interface LicensePayload {
+    tier: 'free' | 'pro' | 'enterprise';
+    holder: string;
+    issuedAt: number;
+    expiresAt: number;
+    whiteLabel: boolean;
+    features: string[];
+}
+export interface LicenseInfo {
+    active: boolean;
+    tier: 'free' | 'pro' | 'enterprise';
+    holder?: string;
+    expiresAt?: string;
+    whiteLabel: boolean;
+    features: string[];
+}
+/**
+ * Generates a signed license key string for testing or license distribution.
+ */
+export declare function generateLicenseKey(payload: LicensePayload, secret?: string): string;
+/**
+ * Cryptographically verifies an offline license key string.
+ */
+export declare function verifyLicenseKey(key: string, secret?: string): {
+    valid: boolean;
+    payload?: LicensePayload;
+    error?: string;
+};
+/**
+ * Activates and persists a valid license key locally.
+ */
+export declare function activateLicense(key: string, secret?: string): {
+    success: boolean;
+    message: string;
+    payload?: LicensePayload;
+};
+/**
+ * Retrieves current active license state.
+ */
+export declare function getLicenseInfo(secret?: string): LicenseInfo;
+/**
+ * Removes active license key and reverts to free tier.
+ */
+export declare function deactivateLicense(): boolean;

package/dist/lib/live-server.d.ts

@@ -24,6 +24,10 @@ export interface LiveServerOptions {
     initialReport?: QaReportData;
     /** Optional AndroidDriver instance for interactive device state and actions. */
     driver?: AndroidDriver;
+    /** Optional factory for creating an AutonomousExplorer instance (allows clean dependency injection in tests). */
+    explorerFactory?: (driver?: AndroidDriver) => {
+        explore: (options: any) => Promise<void>;
+    };
 }
 export interface LiveServerHandle {
     /** The underlying Node.js HTTP server instance. */

package/dist/lib/profiler.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @module profiler
+ * @description
+ * Real-Time Mobile Performance & FPS Profiler (PF-01).
+ * Samples `dumpsys gfxinfo <pkg>` and `dumpsys meminfo <pkg>` during test execution,
+ * computes frame rendering statistics, jank percentages, and memory growth.
+ */
+import { AndroidDriver } from './adb.js';
+export interface FrameStats {
+    totalFrames: number;
+    jankyFrames: number;
+    jankPercentage: number;
+    p50Ms?: number;
+    p90Ms?: number;
+    p95Ms?: number;
+    p99Ms?: number;
+    missedVsync?: number;
+    slowUiThread?: number;
+}
+export interface MemorySample {
+    timestamp: number;
+    stepIndex?: number;
+    stepName?: string;
+    totalPssKb: number;
+    nativeHeapKb?: number;
+    javaHeapKb?: number;
+}
+export interface PerformanceReport {
+    packageName: string;
+    durationMs: number;
+    fpsCompliance: 'PASS' | 'WARN' | 'FAIL';
+    frames: FrameStats;
+    memory: {
+        startPssKb: number;
+        peakPssKb: number;
+        endPssKb: number;
+        deltaPssKb: number;
+        samples: MemorySample[];
+    };
+}
+/**
+ * Parses dumpsys gfxinfo stdout to extract frame counts, jank percentage, and percentile latencies.
+ */
+export declare function parseGfxInfo(stdout: string): FrameStats;
+/**
+ * Parses dumpsys meminfo stdout to extract Total PSS, Native Heap, and Java Heap values in KB.
+ */
+export declare function parseMemInfo(stdout: string): {
+    totalPssKb: number;
+    nativeHeapKb?: number;
+    javaHeapKb?: number;
+};
+/**
+ * PerformanceProfiler tracks real-time frame times, jank metrics, and memory growth.
+ */
+export declare class PerformanceProfiler {
+    private driver;
+    private serial?;
+    private packageName;
+    private startTime;
+    private memorySamples;
+    constructor(driver?: AndroidDriver, serial?: string);
+    /**
+     * Starts tracking performance for the target package.
+     */
+    start(packageName: string): Promise<void>;
+    /**
+     * Captures a discrete memory sample at a step transition.
+     */
+    sample(stepIndex: number, stepName: string): Promise<void>;
+    /**
+     * Finalizes tracking and returns the performance report.
+     */
+    stop(): Promise<PerformanceReport>;
+}

package/dist/lib/reporter.d.ts

@@ -7,6 +7,7 @@
  * JUnit XML. It plays a critical role in providing observability and
  * traceability for autonomous test executions.
  */
+import type { PerformanceReport } from './profiler.js';
 /**
  * Represents a single executed step or action during the test run.
  */
@@ -64,6 +65,14 @@ export interface QaReportData {
     errorsDetected: string[];
     /** Optional relative path to screen recording video (MP4). */
     videoPath?: string;
+    /** Optional performance profiler metrics (PF-01). */
+    performanceMetrics?: PerformanceReport;
+    /** Details of any locators auto-healed during the test run */
+    healsApplied?: Array<{
+        original: string;
+        healed: string;
+        stepNumber: number;
+    }>;
     /** The chronological list of all audit steps executed. */
     steps: AuditStep[];
 }
@@ -148,10 +157,15 @@ export declare class QaReporter implements Reporter {
     private formats;
     private videoPath?;
     private embedScreenshots;
+    private performanceMetrics?;
     private screenshotBuffers;
     private stepListeners;
     private completeListeners;
     private errorListeners;
+    /**
+     * Sets the performance metrics collected by the profiler.
+     */
+    setPerformanceMetrics(metrics: PerformanceReport): void;
     /**
      * Constructs a new QaReporter.
      *

package/dist/lib/runner-utils.d.ts

@@ -7,6 +7,7 @@
  * and diagnostic error generation.
  */
 import { UiNode } from './crawler.js';
+import { AndroidDriver } from './adb.js';
 import { MemoryEngine } from './memory.js';
 import type { QaReportData, Reporter, ReportFormat } from './reporter.js';
 /**
@@ -73,6 +74,8 @@ export interface RunOptions {
     tags?: string;
     /** Emit machine-readable JSON execution summary to stdout. */
     json?: boolean;
+    /** Real-time mobile performance & FPS profiler (PF-01). */
+    profile?: boolean;
 }
 /**
  * Represents a single parsed action step in a plain-English test spec.
@@ -149,6 +152,8 @@ export interface PromptStep {
     emailBodyContains?: string;
     /** Healed locator provenance (original target string) */
     healedFrom?: string;
+    /** Healed replacement string chosen by self-healing */
+    healedTo?: string;
 }
 /**
  * Recursively expands `INCLUDE '<path>'` directives within a spec file.
@@ -288,3 +293,24 @@ export declare function createSyntheticReport(packageName: string, deviceId: str
  * @returns Sanitized or masked string.
  */
 export declare function maskSensitiveValue(value: string, target?: string): string;
+export interface FailureTriageParams {
+    outputDir: string;
+    specName: string;
+    currentSpecName: string;
+    stepNum: number;
+    step: PromptStep;
+    error: Error;
+    stepStartTime: number;
+    startTime: number;
+    errorShot?: Buffer;
+    lastHierarchy?: {
+        xml?: string;
+        flat?: UiNode[];
+    } | null;
+    driver: AndroidDriver;
+    serial?: string;
+}
+/**
+ * Assembles failure triage folder, logs, hierarchy XML, match scores, and a ZIP archive.
+ */
+export declare function createFailureTriageBundle(params: FailureTriageParams): Promise<string | undefined>;

package/dist/lib/scaffold.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @module scaffold
+ * @description
+ * Inspects an active Android screen (or raw XML hierarchy) and synthesizes
+ * a starter plain-English test spec (.txt) containing Launch, Wait, form Type,
+ * button Tap, and element Verify steps.
+ */
+import { AndroidDriver } from './adb.js';
+import { UiNode } from './crawler.js';
+export interface ScaffoldOptions {
+    /** Target package to scaffold. Defaults to active foreground app */
+    packageName?: string;
+    /** Specific device serial to connect to */
+    deviceSerial?: string;
+    /** Explicit output path for the generated spec. Defaults to specs/<pkg>_scaffold.txt */
+    outputPath?: string;
+    /** Driver instance for dependency injection */
+    driver?: AndroidDriver;
+    /** Whether to explore interconnected screens and generate a multi-screen journey spec */
+    journey?: boolean;
+}
+export interface ScaffoldResult {
+    packageName: string;
+    specContent: string;
+    specPath?: string;
+    stepsCount: number;
+    inputCount: number;
+    buttonCount: number;
+}
+/**
+ * Sanitizes node labels by stripping Private Use Area (PUA) icon font glyphs,
+ * special/non-printable unicode codepoints, and leading/trailing punctuation.
+ */
+export declare function sanitizeNodeLabel(label: string): string;
+/**
+ * Derives a human-readable clean label from a UiNode.
+ */
+export declare function getNodeLabel(node: UiNode): string;
+/**
+ * Synthesizes a valid PromptTest specification from a flat list of UiNodes.
+ */
+export declare function scaffoldSpecFromNodes(nodes: UiNode[], packageName?: string): string;
+/**
+ * Validates that every generated step in a spec string parses cleanly with the PromptTest DSL.
+ */
+export declare function validateScaffoldedSpec(specContent: string): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Connects to the device, retrieves screen hierarchy, and writes a scaffolded spec file.
+ */
+export declare function scaffoldSpec(options?: ScaffoldOptions): Promise<ScaffoldResult>;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "prompttest",
-  "version": "1.5.0",
-  "description": "Ultra-fast, zero-code autonomous mobile testing & visual QA brain for Android",
+  "version": "1.5.2",
+  "description": "Ultra-fast, zero-code autonomous mobile testing & visual QA brain for Android & iOS",
   "license": "BUSL-1.1",
-  "homepage": "https://github.com/shriramsingh/prompttest-community#readme",
+  "homepage": "https://shriramsingh.github.io/prompttest-studio-site/",
   "bugs": {
     "url": "https://github.com/shriramsingh/prompttest-community/issues"
   },
@@ -15,7 +15,8 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "prompttest": "dist/bin/prompttest.js"
+    "prompttest": "dist/bin/prompttest.js",
+    "prompttest-mobile": "dist/bin/prompttest.js"
   },
   "files": [
     "dist",
@@ -59,6 +60,7 @@
     "test:student": "tsx bin/prompttest.ts run specs/coachconnect_student.txt host.exp.exponent",
     "audit": "npm audit --audit-level=high",
     "build": "node scripts/build.mjs",
+    "package:mobile": "npm run build && node scripts/prepare-mobile-package.mjs",
     "package:sea": "node scripts/package-sea.mjs",
     "pack:verify": "node scripts/verify-pack.mjs",
     "pack:smoke": "npm run build && node scripts/smoke-pack.mjs",
@@ -68,9 +70,18 @@
     "preversion": "npm run typecheck && npm test",
     "version:patch": "npm version patch",
     "version:minor": "npm version minor",
-    "version:major": "npm version major"
+    "version:major": "npm version major",
+    "publish:all": "node scripts/publish-all.mjs",
+    "publish:all:dry": "node scripts/publish-all.mjs --dry-run"
   },
   "keywords": [
+    "prompttest-mobile",
+    "prompttest",
+    "mobile-testing",
+    "mobile-qa",
+    "android-automation",
+    "appium-alternative",
+    "detox-alternative",
     "android",
     "testing",
     "automation",