mstro-app 0.2.0 → 0.3.1

package/bin/mstro.js

@@ -8,8 +8,8 @@
  * Main entry point for the Mstro AI assistant.
  *
  * Usage:
- *   mstro                     # Start Mstro (auto-finds available port)
- *   mstro login               # Authenticate this device
+ *   mstro                     # Start Mstro (logs in automatically if needed)
+ *   mstro login               # Re-authenticate this device
  *   mstro logout              # Sign out
  *   mstro whoami              # Show current user
  *   mstro status              # Show connection status
@@ -35,10 +35,27 @@ const CLIENT_ROOT = resolve(__dirname, '..');
 const pkg = JSON.parse(readFileSync(join(CLIENT_ROOT, 'package.json'), 'utf-8'));
 
 // Check for updates (runs async in background, notifies on next run)
+// update-notifier initializes lastUpdateCheck to Date.now(), which means the
+// first check won't happen until 24h after install. We detect first-run by
+// checking if the configstore has never stored an update result, and if so
+// reset the timestamp to force an immediate background check.
 const notifier = updateNotifier({
   pkg,
   updateCheckInterval: 1000 * 60 * 60 * 24  // Check daily
 });
+try {
+  if (notifier.config && !notifier.config.has('update') && !notifier.update) {
+    const lastCheck = notifier.config.get('lastUpdateCheck');
+    // If lastUpdateCheck was just set (within the last 30s), this is a fresh
+    // configstore — reset it to 0 so the library spawns a check immediately.
+    if (lastCheck && (Date.now() - lastCheck) < 30_000) {
+      notifier.config.set('lastUpdateCheck', 0);
+      notifier.check();
+    }
+  }
+} catch {
+  // Non-critical — don't let update check logic crash the CLI
+}
 
 // Capture the user's original working directory before any cwd changes
 const USER_CWD = process.cwd();
@@ -49,6 +66,7 @@ const MSTRO_FIRST_RUN_FLAG = join(MSTRO_CONFIG_DIR, '.configured');
 const CLAUDE_SETTINGS_FILE = join(homedir(), '.claude', 'settings.json');
 const CLAUDE_HOOKS_DIR = join(homedir(), '.claude', 'hooks');
 const BOUNCER_HOOK_FILE = join(CLAUDE_HOOKS_DIR, 'bouncer.sh');
+const PTY_SETUP_DISMISSED_FLAG = join(MSTRO_CONFIG_DIR, '.pty-setup-dismissed');
 
 /**
  * Mark Mstro as configured by writing the first-run flag file
@@ -193,18 +211,221 @@ async function promptBouncerSetup() {
   }
 }
 
+/**
+ * Check if node-pty native module is loadable
+ */
+async function isNodePtyAvailable() {
+  try {
+    await import('node-pty');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if user has dismissed the pty setup prompt
+ */
+function hasUserDismissedPtySetup() {
+  return existsSync(PTY_SETUP_DISMISSED_FLAG);
+}
+
+/**
+ * Mark pty setup prompt as dismissed
+ */
+function markPtySetupDismissed() {
+  if (!existsSync(MSTRO_CONFIG_DIR)) {
+    mkdirSync(MSTRO_CONFIG_DIR, { recursive: true, mode: 0o700 });
+  }
+  writeFileSync(PTY_SETUP_DISMISSED_FLAG, new Date().toISOString());
+}
+
+/**
+ * Show a one-line warning that node-pty is not available
+ */
+function showPtyWarning() {
+  log('  Terminal support not available. Run: mstro setup-terminal', colors.dim);
+}
+
+/**
+ * Get platform-specific build tool instructions
+ */
+function getPtyBuildInstructions() {
+  const os = process.platform;
+  if (os === 'darwin') {
+    return '    Install Xcode Command Line Tools: xcode-select --install';
+  }
+  if (os === 'win32') {
+    return '    Install Windows Build Tools: npm install -g windows-build-tools';
+  }
+  return '    Debian/Ubuntu: sudo apt install build-essential python3\n' +
+         '    Fedora/RHEL:   sudo dnf install gcc-c++ make python3\n' +
+         '    Arch:          sudo pacman -S base-devel python';
+}
+
+/**
+ * Attempt to rebuild/install node-pty from CLIENT_ROOT
+ * Returns true if npm command succeeded, false otherwise
+ */
+function attemptPtyRebuild() {
+  return new Promise((resolve) => {
+    const nodePtyDir = join(CLIENT_ROOT, 'node_modules', 'node-pty');
+    const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const command = existsSync(nodePtyDir) ? 'rebuild' : 'install';
+    const args = command === 'rebuild'
+      ? ['rebuild', 'node-pty']
+      : ['install', 'node-pty', '--no-save'];
+
+    log(`\n  ${command === 'rebuild' ? 'Rebuilding' : 'Installing'} node-pty...`, colors.dim);
+
+    const child = spawn(npmCmd, args, {
+      cwd: CLIENT_ROOT,
+      stdio: 'inherit',
+    });
+
+    child.on('error', (err) => {
+      log(`  Error: ${err.message}`, colors.red);
+      resolve(false);
+    });
+
+    child.on('exit', (code) => {
+      resolve(code === 0);
+    });
+  });
+}
+
+/**
+ * Prompt user to set up node-pty for terminal support
+ * Returns: 'configure' | 'skip' | 'never'
+ */
+async function promptPtySetup() {
+  log('\n  Terminal Support\n', colors.bold + colors.cyan);
+  log('  Mstro includes a web terminal that lets you open a shell', colors.dim);
+  log('  directly in your browser. This requires compiling a native module (node-pty).\n', colors.dim);
+
+  const isInteractive = process.stdin.isTTY;
+
+  if (!isInteractive) {
+    log('  Non-interactive mode: skipping terminal setup.', colors.yellow);
+    log('  Run "mstro setup-terminal" to enable terminal support.\n', colors.dim);
+    return 'skip';
+  }
+
+  log('  Set up terminal support now?', colors.bold);
+  log('    [Y] Yes, compile now (requires build tools)', colors.dim);
+  log('    [n] Not now (ask again next time)', colors.dim);
+  log('    [d] Don\'t show this again\n', colors.dim);
+
+  const answer = await prompt('  Your choice [Y/n/d]: ');
+  const choice = answer.toLowerCase();
+
+  if (choice === '' || choice === 'y' || choice === 'yes') {
+    return 'configure';
+  }
+  if (choice === 'd' || choice === 'dont' || choice === "don't") {
+    log('\n  Got it! You can set up later with: mstro setup-terminal\n', colors.dim);
+    markPtySetupDismissed();
+    return 'never';
+  }
+  log('\n  Skipping for now. Will ask again next time.', colors.yellow);
+  log('  You can also set up with: mstro setup-terminal\n', colors.dim);
+  return 'skip';
+}
+
+/**
+ * Run the pty rebuild and show results
+ */
+async function runPtySetup() {
+  const success = await attemptPtyRebuild();
+
+  if (success) {
+    const available = await isNodePtyAvailable();
+    if (available) {
+      log('\n  Terminal support enabled successfully!\n', colors.bold + colors.green);
+      return true;
+    }
+    log('\n  node-pty installed but failed to load.', colors.red);
+  }
+
+  log('\n  Could not compile node-pty automatically.\n', colors.yellow);
+  log('  You may need to install build tools first:\n', colors.bold);
+  log(getPtyBuildInstructions(), colors.dim);
+  log('');
+  log('  After installing build tools, run: mstro setup-terminal\n', colors.dim);
+  return false;
+}
+
+/**
+ * Read alive mstro instances and session token for server communication.
+ * Returns null if no running servers can be reached.
+ */
+function getAliveInstances() {
+  const mstroDir = join(homedir(), '.mstro');
+  const instancesPath = join(mstroDir, 'instances.json');
+  const tokenPath = join(mstroDir, 'session-token');
+
+  if (!existsSync(instancesPath) || !existsSync(tokenPath)) return null;
+
+  try {
+    const instances = JSON.parse(readFileSync(instancesPath, 'utf-8'));
+    const token = readFileSync(tokenPath, 'utf-8').trim();
+    if (!Array.isArray(instances) || !token) return null;
+
+    const now = Date.now();
+    const alive = instances.filter(i => now - i.lastHeartbeat < 2 * 60 * 1000);
+    return alive.length > 0 ? { alive, token } : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Notify running mstro servers to reload node-pty.
+ * Reads instances from ~/.mstro/instances.json and POSTs to /api/reload-pty.
+ */
+async function notifyRunningServers() {
+  const result = getAliveInstances();
+  if (!result) {
+    log('  Restart mstro to enable terminal support.\n', colors.dim);
+    return;
+  }
+
+  let reloaded = 0;
+  for (const instance of result.alive) {
+    try {
+      const res = await fetch(`http://localhost:${instance.port}/api/reload-pty`, {
+        method: 'POST',
+        headers: { 'x-session-token': result.token },
+      });
+      if (res.ok) {
+        const data = await res.json();
+        if (data.success) reloaded++;
+      }
+    } catch {
+      // Server not reachable — stale instance
+    }
+  }
+
+  if (reloaded > 0) {
+    log(`  Notified ${reloaded} running mstro server${reloaded > 1 ? 's' : ''} — terminal is ready!\n`, colors.green);
+  } else {
+    log('  Restart mstro to enable terminal support.\n', colors.dim);
+  }
+}
+
 function showHelp() {
-  log('\n  Mstro - No-code AI Workspace\n', colors.bold + colors.cyan);
-  log('  Run Claude Code workflows from your laptop, cloud VM, or any machine.\n', colors.dim);
+  log('\n  Mstro - Run Claude Code from any browser\n', colors.bold + colors.cyan);
+  log('  Streams live Claude Code sessions from your machine to mstro.app.\n', colors.dim);
   log('  Usage:', colors.bold);
-  log('    mstro                       Start Mstro (auto-finds available port)', colors.dim);
-  log('    mstro login                 Authenticate this device with mstro.app', colors.dim);
+  log('    mstro                       Start Mstro (logs in automatically if needed)', colors.dim);
+  log('    mstro login                 Re-authenticate this device with mstro.app', colors.dim);
   log('    mstro logout                Sign out of mstro.app', colors.dim);
   log('    mstro whoami                Show current user and device info', colors.dim);
   log('    mstro status                Show connection and auth status', colors.dim);
   log('    mstro telemetry [on|off]    Enable/disable anonymous telemetry', colors.dim);
   log('    mstro -p 4105               Start on specific port (overrides auto port)', colors.dim);
   log('    mstro configure-hooks       Configure Claude Code security hooks', colors.dim);
+  log('    mstro setup-terminal        Enable web terminal (compiles native module)', colors.dim);
   log('    mstro --version             Show version number', colors.dim);
   log('    mstro --help                Show this help message', colors.dim);
   log('');
@@ -214,7 +435,7 @@ function showHelp() {
   log('    --verbose, -v               Enable verbose output', colors.dim);
   log('');
   log('  Authentication:', colors.bold);
-  log('    Run "mstro login" to connect this device to your mstro.app account.', colors.dim);
+  log('    Running "mstro" will prompt you to log in automatically if needed.', colors.dim);
   log('    Once logged in, machines sync automatically with your web dashboard.', colors.dim);
   log('');
   log('  Security:', colors.bold);
@@ -283,11 +504,12 @@ function runConfigureHooks(andThenStart = false) {
     process.exit(1);
   });
 
-  child.on('exit', (code) => {
+  child.on('exit', async (code) => {
     if (code === 0) {
       markConfigured();
       if (andThenStart) {
-        // After configuring, start the server
+        // After configuring bouncer, prompt for terminal setup before starting
+        await ensurePtySetup();
         const requestedPort = parsePort(process.argv.slice(2));
         const envOverrides = requestedPort ? { PORT: String(requestedPort) } : {};
         runNpmScript('start', [], envOverrides);
@@ -321,14 +543,18 @@ function parsePort(args) {
  * Show update notification if available
  */
 function showUpdateNotification() {
-  if (notifier.update && semverGt(notifier.update.latest, notifier.update.current)) {
-    const { current, latest, type } = notifier.update;
-    const updateCmd = 'npm i -g mstro@latest';
-
-    log('');
-    log(`  ${colors.yellow}Update available:${colors.reset} ${colors.dim}${current}${colors.reset} → ${colors.green}${latest}${colors.reset} ${colors.dim}(${type})${colors.reset}`);
-    log(`  Run: ${colors.cyan}${updateCmd}${colors.reset}`);
-    log('');
+  try {
+    if (notifier.update && semverGt(notifier.update.latest, notifier.update.current)) {
+      const { current, latest, type } = notifier.update;
+      const updateCmd = `npm i -g ${pkg.name}`;
+
+      log('');
+      log(`  ${colors.yellow}Update available:${colors.reset} ${colors.dim}${current}${colors.reset} → ${colors.green}${latest}${colors.reset} ${colors.dim}(${type})${colors.reset}`);
+      log(`  Run: ${colors.cyan}${updateCmd}${colors.reset}`);
+      log('');
+    }
+  } catch {
+    // Don't let a corrupted cache or invalid semver crash the CLI
   }
 }
 
@@ -349,36 +575,61 @@ function isLoggedIn() {
 }
 
 /**
- * Show login required message
+ * Auto-login if not authenticated. Exits on failure.
  */
-function showLoginRequired() {
-  log('\n  Authentication required', colors.bold + colors.yellow);
-  log('');
-  log('  You must be logged in to use mstro.', colors.dim);
-  log('  Run "mstro login" to authenticate this device.', colors.dim);
-  log('');
+async function ensureLoggedIn() {
+  if (isLoggedIn()) return;
+  log('\n  Not logged in — starting authentication...\n', colors.bold + colors.cyan);
+  try {
+    const { login } = await import('./commands/login.js');
+    await login(args, { inline: true });
+  } catch (err) {
+    log(`\n  Login failed: ${err.message}`, colors.red);
+    log('  Run "mstro login" to try again.\n', colors.dim);
+    process.exit(1);
+  }
 }
 
 /**
- * Check if node-pty is loadable (native module compiled correctly)
+ * Prompt for bouncer setup if not configured
+ * Returns true if runConfigureHooks was called (async exit path)
  */
-async function startServer(envOverrides) {
-  if (!isLoggedIn()) {
-    showLoginRequired();
-    process.exit(1);
+async function ensureBouncerSetup() {
+  if (isBouncerConfigured()) return false;
+  if (hasUserDismissedSetup()) {
+    showBouncerWarning();
+    return false;
   }
+  const choice = await promptBouncerSetup();
+  if (choice === 'configure') {
+    runConfigureHooks(true);
+    return true;
+  }
+  return false;
+}
 
-  if (!isBouncerConfigured()) {
-    if (hasUserDismissedSetup()) {
-      showBouncerWarning();
-    } else {
-      const choice = await promptBouncerSetup();
-      if (choice === 'configure') {
-        runConfigureHooks(true);
-        return;
-      }
-    }
+/**
+ * Prompt for node-pty setup if not available
+ */
+async function ensurePtySetup() {
+  const ptyAvailable = await isNodePtyAvailable();
+  if (ptyAvailable) return;
+  if (hasUserDismissedPtySetup()) {
+    showPtyWarning();
+    return;
+  }
+  const choice = await promptPtySetup();
+  if (choice === 'configure') {
+    await runPtySetup();
   }
+}
+
+async function startServer(envOverrides) {
+  await ensureLoggedIn();
+
+  if (await ensureBouncerSetup()) return;
+
+  await ensurePtySetup();
 
   showUpdateNotification();
   runNpmScript('start', [], envOverrides);
@@ -417,6 +668,20 @@ async function main() {
       await telemetry(args.slice(args.indexOf('telemetry') + 1));
     }],
     ['configure-hooks', () => runConfigureHooks(false)],
+    ['setup-terminal', async () => {
+      log('\n  Mstro Terminal Setup\n', colors.bold + colors.cyan);
+      const alreadyAvailable = await isNodePtyAvailable();
+      if (alreadyAvailable) {
+        log('  node-pty is already available. Terminal support is enabled!\n', colors.green);
+        await notifyRunningServers();
+        return;
+      }
+      const success = await runPtySetup();
+      if (success) {
+        await notifyRunningServers();
+      }
+      process.exit(success ? 0 : 1);
+    }],
   ]);
 
   // Flag-based commands
@@ -441,6 +706,7 @@ async function main() {
   const handler = subcommand ? commands.get(subcommand) : undefined;
   if (handler) {
     await handler();
+    showUpdateNotification();
     return;
   }
 

package/dist/server/cli/headless/claude-invoker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-invoker.d.ts","sourceRoot":"","sources":["../../../../server/cli/headless/claude-invoker.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAO9D,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAm5BD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA0I1B"}
+{"version":3,"file":"claude-invoker.d.ts","sourceRoot":"","sources":["../../../../server/cli/headless/claude-invoker.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAO9D,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAogCD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA0H1B"}