@myerscarpenter/quest-dev 1.4.0 → 2.0.0

package/src/index.ts

@@ -9,13 +9,17 @@ import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
+import { dirname, join, resolve } from 'path';
 import { screenshotCommand } from './commands/screenshot.js';
 import { openCommand } from './commands/open.js';
-import { startCommand, stopCommand, statusCommand, tailCommand } from './commands/logcat.js';
+import { tailCommand } from './commands/logcat.js';
 import { batteryCommand } from './commands/battery.js';
-import { stayAwakeCommand, stayAwakeWatchdog, stayAwakeStatus, stayAwakeDisable } from './commands/stay-awake.js';
-import { saveConfig, loadConfig } from './utils/config.js';
+import { stayAwakeStatus, stayAwakeDisable } from './commands/stay-awake.js';
+import { saveConfig, loadConfig, type QuestDevConfig } from './utils/config.js';
+import { setVerbose } from './utils/verbose.js';
+import { ensureDaemon, daemonRequest, discoverDaemon, daemonFetch, resolvePort, resolveHost } from './daemon/client.js';
+import { startDaemon } from './daemon/daemon.js';
+import { extractCastingApk, hasCastingApk, findInstalledMqdh } from './utils/casting-apk.js';
 
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -31,6 +35,27 @@ const cli = yargs(hideBin(process.argv))
   .usage('Usage: $0 <command> [options]')
   .demandCommand(1, '')
   .strict()
+  .option('verbose', {
+    describe: 'Show detailed debug output',
+    type: 'boolean',
+    default: false,
+    global: true,
+  })
+  .option('port', {
+    describe: 'Daemon HTTP port (or save with: quest-dev config --port)',
+    type: 'number',
+    global: true,
+  })
+  .option('device', {
+    describe: 'Quest IP address (or save with: quest-dev config --device)',
+    type: 'string',
+    global: true,
+  })
+  .option('host', {
+    describe: 'Daemon bind address (default: 127.0.0.1, use 0.0.0.0 for network access)',
+    type: 'string',
+    global: true,
+  })
   .fail((msg, err, yargs) => {
     yargs.showHelp();
     if (err) console.error(err.message);
@@ -38,9 +63,9 @@ const cli = yargs(hideBin(process.argv))
   })
   .help()
   .alias('help', 'h')
-  .epilog('Requires ADB and Quest connected via USB. Sets up CDP on port 9223 for cdp-cli.');
+  .epilog('Requires ADB and Quest connected via USB or Wi-Fi (adb connect).');
 
-// Screenshot command
+// Screenshot command (standalone — no daemon needed)
 cli.command(
   'screenshot <directory>',
   'Take a screenshot from Quest and save to directory with auto-generated filename',
@@ -65,7 +90,7 @@ cli.command(
   }
 );
 
-// Open command
+// Open command (standalone)
 cli.command(
   'open <url>',
   'Open URL in Quest browser (sets up CDP debugging port forwarding)',
@@ -97,7 +122,7 @@ cli.command(
   }
 );
 
-// Logcat command
+// Logcat command — delegates to daemon for start/stop/status, tail remains standalone
 cli.command(
   'logcat <action>',
   'Capture Android logcat to files (CRITICAL: always start before testing to avoid losing crash logs)',
@@ -116,29 +141,73 @@ cli.command(
   },
   async (argv) => {
     const action = argv.action as string;
-    const filter = argv.filter as string | undefined;
 
+    if (action === 'tail') {
+      await tailCommand();
+      return;
+    }
+
+    // Delegate to daemon
+    const info = await ensureDaemon({ port: argv.port as number | undefined, device: argv.device as string | undefined, host: argv.host as string | undefined });
     switch (action) {
-      case 'start':
-        await startCommand(filter);
+      case 'start': {
+        const result = await daemonFetch(info, '/logcat/start', {
+          body: { filter: argv.filter },
+        }) as { ok: boolean; file?: string; pid?: number };
+        if (result.ok) {
+          console.log(`Capturing (PID: ${result.pid})`);
+          console.log(`File: ${result.file}`);
+          console.log('');
+          console.log('Now run your test. When done: quest-dev logcat stop');
+        } else {
+          console.error('Failed to start logcat capture');
+          console.error(JSON.stringify(result, null, 2));
+        }
         break;
-      case 'stop':
-        await stopCommand();
-        break;
-      case 'status':
-        await statusCommand();
+      }
+      case 'stop': {
+        const result = await daemonFetch(info, '/logcat/stop', {
+          method: 'POST',
+        }) as { ok: boolean };
+        if (result.ok) {
+          // Show file info
+          const status = await daemonFetch(info, '/logcat/status') as {
+            file?: string;
+            size?: string;
+            lines?: number;
+          };
+          console.log('Capture stopped');
+          if (status.file) {
+            console.log(`File: ${status.file}`);
+            if (status.size) console.log(`Size: ${status.size}`);
+          }
+        }
         break;
-      case 'tail':
-        await tailCommand();
+      }
+      case 'status': {
+        const result = await daemonFetch(info, '/logcat/status') as {
+          capturing: boolean;
+          pid?: number;
+          file?: string;
+          size?: string;
+          lines?: number;
+        };
+        if (result.capturing) {
+          console.log(`Capturing (PID: ${result.pid})`);
+          if (result.file) {
+            console.log(`File: ${result.file}`);
+            if (result.size) console.log(`Size: ${result.size}`);
+          }
+        } else {
+          console.log('Not capturing');
+        }
         break;
-      default:
-        console.error(`Unknown action: ${action}`);
-        process.exit(1);
+      }
     }
   }
 );
 
-// Battery command
+// Battery command (standalone)
 cli.command(
   'battery',
   'Show Quest battery percentage and charging status',
@@ -148,10 +217,42 @@ cli.command(
   }
 );
 
-// Stay-awake command
+// Start command — starts daemon with stay-awake for web content workflows
+cli.command(
+  'start',
+  'Start quest-dev daemon (enables stay-awake, serves dashboard for casting)',
+  (yargs) => {
+    return yargs
+      .option('pin', {
+        describe: 'Meta Store PIN for stay-awake (or save with: quest-dev config --pin)',
+        type: 'string',
+      });
+  },
+  async (argv) => {
+    const info = await ensureDaemon({ port: argv.port as number | undefined, device: argv.device as string | undefined, host: argv.host as string | undefined });
+
+    // Enable stay-awake
+    const result = await daemonFetch(info, '/stay-awake/enable', {
+      body: { pin: argv.pin },
+    }) as { ok: boolean; error?: string };
+    if (result.ok) {
+      console.log('Stay-awake enabled');
+    } else if (result.error !== 'PIN required') {
+      console.warn('Stay-awake:', result.error);
+    }
+
+    const url = `http://localhost:${info.port}/`;
+    console.log(`\nDaemon running (PID: ${info.pid}, port: ${info.port})`);
+    console.log(`Dashboard: ${url}`);
+    console.log(`\nStart casting: curl -X POST ${url}cast/start`);
+    console.log(`Stop daemon:   quest-dev stop`);
+  }
+);
+
+// Stay-awake command — delegates to daemon
 cli.command(
   'stay-awake',
-  'Keep Quest awake (disables autosleep, guardian, dialogs)',
+  'Keep Quest awake (disables autosleep, guardian, dialogs) via daemon',
   (yargs) => {
     return yargs
       .option('pin', {
@@ -177,30 +278,149 @@ cli.command(
         type: 'boolean',
         default: false,
       })
-      .option('verbose', {
-        describe: 'Print battery level on every check (every 60s)',
-        type: 'boolean',
-        default: false,
-        alias: 'v',
-      });
+;
   },
   async (argv) => {
     if (argv.status) {
       await stayAwakeStatus();
-    } else if (argv.disable) {
-      await stayAwakeDisable(argv.pin as string | undefined);
+      return;
+    }
+    if (argv.disable) {
+      // Try daemon first, fall back to direct
+      const existing = discoverDaemon();
+      if (existing) {
+        await daemonFetch(existing, '/stay-awake/disable', { method: 'POST' });
+        console.log('Stay-awake disabled via daemon');
+      } else {
+        await stayAwakeDisable(argv.pin as string | undefined);
+      }
+      return;
+    }
+
+    // Enable via daemon
+    const info = await ensureDaemon({
+      port: argv.port as number | undefined,
+      device: argv.device as string | undefined,
+      host: argv.host as string | undefined,
+      idleTimeout: argv.idleTimeout as number | undefined,
+      lowBattery: argv.lowBattery as number | undefined,
+    });
+    const result = await daemonFetch(info, '/stay-awake/enable', {
+      body: { pin: argv.pin },
+    }) as { ok: boolean; error?: string };
+    if (result.ok) {
+      console.log('Stay-awake enabled via daemon');
+      console.log(`Daemon PID: ${info.pid}, port: ${info.port}`);
     } else {
-      await stayAwakeCommand(
-        argv.pin as string | undefined,
-        argv.idleTimeout as number | undefined,
-        argv.lowBattery as number | undefined,
-        argv.verbose as boolean,
-      );
+      console.error('Failed to enable stay-awake:', result.error);
+      process.exit(1);
     }
   }
 );
 
-// Config command
+// Deploy command — auto-starts daemon, deploys APK, reports crash/success
+cli.command(
+  'deploy <apk>',
+  'Deploy APK to Quest (auto-starts daemon, enables stay-awake, installs, launches, checks for crash)',
+  (yargs) => {
+    return yargs
+      .positional('apk', {
+        describe: 'Path to APK file',
+        type: 'string',
+        demandOption: true,
+      })
+      .option('crash-wait', {
+        describe: 'Time in ms to wait before crash check (default: 5000)',
+        type: 'number',
+        default: 5000,
+      });
+  },
+  async (argv) => {
+    const apkPath = resolve(argv.apk as string);
+    const info = await ensureDaemon({ port: argv.port as number | undefined, device: argv.device as string | undefined, host: argv.host as string | undefined });
+
+    console.log(`Deploying: ${apkPath}`);
+    const result = await daemonFetch(info, '/deploy', {
+      body: {
+        apk_path: apkPath,
+        crash_wait_ms: argv.crashWait,
+      },
+    }) as {
+      ok: boolean;
+      package: string;
+      crashed: boolean;
+      logcatLines?: string[];
+      logcatFile?: string;
+      error?: string;
+      install?: {
+        incremental: boolean;
+        blocksTransferred?: number;
+        totalBlocks?: number;
+        bytesTransferred?: number;
+        installSecs: number;
+        apkSizeMB: number;
+      };
+    };
+
+    if (result.ok) {
+      const inst = result.install;
+      if (inst) {
+        const mode = inst.incremental ? 'incremental' : 'full';
+        if (inst.blocksTransferred !== undefined && inst.totalBlocks) {
+          const kb = Math.round((inst.bytesTransferred ?? 0) / 1024);
+          console.log(`\nInstalled (${mode}, ${inst.installSecs}s): ${inst.blocksTransferred}/${inst.totalBlocks} blocks (~${kb}KB of ${inst.apkSizeMB}MB)`);
+        } else {
+          console.log(`\nInstalled (${mode}, ${inst.installSecs}s)`);
+        }
+      }
+      console.log(`Deploy successful: ${result.package} is running`);
+      console.log(`Logcat: ${result.logcatFile}`);
+      console.log(`Daemon API: http://127.0.0.1:${info.port}/help`);
+    } else if (result.crashed) {
+      console.error(`\nCRASH DETECTED: ${result.package}`);
+      if (result.logcatLines && result.logcatLines.length > 0) {
+        console.error(`\n--- ${result.logcatFile} ---`);
+        for (const line of result.logcatLines) {
+          console.error(line);
+        }
+        console.error(`--- End ${result.logcatFile} ---\n`);
+      }
+      if (result.error) {
+        console.error(result.error);
+      }
+      console.error(`Logcat: ${result.logcatFile}`);
+      process.exit(1);
+    } else {
+      console.error(`\nDeploy failed: ${result.error}`);
+      if (result.logcatFile) {
+        console.error(`Logcat: ${result.logcatFile}`);
+      }
+      process.exit(1);
+    }
+  }
+);
+
+// Stop command — shuts down daemon
+cli.command(
+  'stop',
+  'Stop the quest-dev daemon (restores Quest settings)',
+  () => {},
+  async () => {
+    const existing = discoverDaemon();
+    if (!existing) {
+      console.log('No daemon running');
+      return;
+    }
+    try {
+      await daemonFetch(existing, '/shutdown', { method: 'POST' });
+      console.log('Daemon shutdown requested');
+    } catch {
+      console.log('Daemon is not responding (may already be stopped)');
+    }
+  }
+);
+
+// Config command (standalone)
 cli.command(
   'config',
   'Save default settings for quest-dev commands',
@@ -235,41 +455,105 @@ cli.command(
       return;
     }
 
-    const values: Record<string, unknown> = {};
-    if (argv.pin !== undefined) values.pin = argv.pin;
-    if (argv.idleTimeout !== undefined) values.idleTimeout = argv.idleTimeout;
-    if (argv.lowBattery !== undefined) values.lowBattery = argv.lowBattery;
+    const values: QuestDevConfig = {};
+    if (argv.pin !== undefined) values.pin = argv.pin as string;
+    if (argv.port !== undefined) values.port = argv.port as number;
+    if (argv.device !== undefined) values.device = argv.device as string;
+    if (argv.idleTimeout !== undefined) values.idleTimeout = argv.idleTimeout as number;
+    if (argv.lowBattery !== undefined) values.lowBattery = argv.lowBattery as number;
 
     if (Object.keys(values).length === 0) {
-      console.error('No config values provided. Use --pin, --idle-timeout, or --low-battery.');
+      console.error('No config values provided. Use --pin, --port, --device, --idle-timeout, or --low-battery.');
       process.exit(1);
     }
 
-    saveConfig(values as any);
+    saveConfig(values);
     console.log('Config saved:');
     console.log(JSON.stringify(values, null, 2));
+
+    // Warn if device changed while daemon is running
+    if (values.device !== undefined && discoverDaemon()) {
+      console.log('\nNote: daemon is running. Restart it to use the new device:');
+      console.log('  quest-dev stop && quest-dev start');
+    }
   }
 );
 
-// Stay-awake watchdog (internal subcommand, spawned by stay-awake parent)
+// Setup cast — extract casting APK from MQDH
 cli.command(
-  'stay-awake-watchdog',
-  false as any, // Hide from help
+  'setup-cast [source]',
+  'Extract casting APK from Meta Quest Developer Hub',
   (yargs) => {
     return yargs
-      .option('parent-pid', {
-        type: 'number',
-        demandOption: true,
-      })
-      .option('pin', {
+      .positional('source', {
+        describe: 'Path to MQDH (.app, .dmg, .exe.zip, .exe, or directory). Omit to auto-detect.',
         type: 'string',
-        demandOption: true,
-      });
+      })
+      .example('$0 setup-cast', 'Auto-detect MQDH installation')
+      .example('$0 setup-cast "/Applications/Meta Quest Developer Hub.app"', 'macOS .app')
+      .example('$0 setup-cast ~/Downloads/MetaQuestDeveloperHub.dmg', 'macOS .dmg')
+      .example('$0 setup-cast ~/Downloads/Meta-Quest-Developer-Hub.exe.zip', 'Windows installer');
+  },
+  async (argv) => {
+    // If APKs already extracted, just confirm
+    if (!argv.source && hasCastingApk()) {
+      console.log('Casting APKs already extracted. Ready to cast.');
+      console.log('(Run with a path argument to re-extract from a newer MQDH version.)');
+      return;
+    }
+
+    let source = argv.source as string | undefined;
+
+    // Auto-detect if no source provided
+    if (!source) {
+      const found = findInstalledMqdh();
+      if (found) {
+        console.log(`Found MQDH: ${found}`);
+        source = found;
+      } else {
+        console.log('Could not find Meta Quest Developer Hub on this machine.\n');
+        console.log('Download it from:');
+        console.log('  https://developer.oculus.com/meta-quest-developer-hub\n');
+        console.log('Then run:');
+        console.log('  quest-dev setup-cast /path/to/Meta\\ Quest\\ Developer\\ Hub.app   (macOS)');
+        console.log('  quest-dev setup-cast /path/to/MetaQuestDeveloperHub.dmg           (macOS)');
+        console.log('  quest-dev setup-cast /path/to/Meta-Quest-Developer-Hub.exe.zip    (Windows)');
+        process.exit(1);
+      }
+    }
+
+    console.log('Extracting casting APKs...');
+    await extractCastingApk(resolve(source));
+    console.log('\nDone. The APK will be auto-installed on your Quest when you start casting.');
+  }
+);
+
+// Hidden daemon subcommand (spawned by client.ts)
+cli.command(
+  'daemon',
+  false as any, // Hide from help
+  (yargs) => {
+    return yargs
+      .option('idle-timeout', { type: 'number' })
+      .option('low-battery', { type: 'number' });
   },
   async (argv) => {
-    await stayAwakeWatchdog(argv.parentPid as number, argv.pin as string);
+    await startDaemon({
+      port: resolvePort(argv.port as number | undefined),
+      device: argv.device as string | undefined,
+      host: argv.host as string | undefined,
+      idleTimeout: argv.idleTimeout as number | undefined,
+      lowBattery: argv.lowBattery as number | undefined,
+    });
   }
 );
 
+// Set verbose flag before any command runs
+cli.middleware((argv) => {
+  if (argv.verbose) {
+    setVerbose(true);
+  }
+});
+
 // Parse and execute
 cli.parse();