spaps 0.7.6 → 0.7.7

package/src/cli-dispatcher.js

@@ -44,6 +44,38 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     };
   }
 
+  function allowDryRun(command) {
+    if (!dryRun) return command;
+    command.allowUnknownOption(true);
+    if (typeof command.allowExcessArguments === 'function') {
+      command.allowExcessArguments(true);
+    }
+    return command;
+  }
+
+  function addRemoteCommandOptions(command) {
+    return command
+      .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+      .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+      .option('--json', 'Output in JSON format');
+  }
+
+  // spaps home
+  const cmdHome = program
+    .command('home')
+    .description('Show operator, app, and runtime state')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('home', (opts, _cmd, isJson) => ({
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdHome);
+
   // spaps local
   const cmdLocal = program
     .command('local [subcommand]')
@@ -58,7 +90,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     )
     .option('-d, --detach', 'Run in background (don\'t tail logs)', false)
     .option('--fresh', 'Fresh start: tear down and rebuild from scratch', false)
-    .option('--from-backup <path>', 'Load from Supabase backup file', null)
+    .option('--from-backup <path>', 'Load from database dump file', null)
     .option('-o, --open', 'Open browser automatically', false)
     .option('--json', 'Output in JSON format')
     .action(
@@ -80,12 +112,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         return out;
       })
     );
-  if (dryRun) {
-    cmdLocal.allowUnknownOption(true);
-    if (typeof cmdLocal.allowExcessArguments === 'function') {
-      cmdLocal.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdLocal);
 
   // spaps quickstart
   const cmdQuick = program
@@ -94,12 +121,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .option('-p, --port <port>', 'Port to check', String(DEFAULT_PORT))
     .option('--json', 'Output in JSON format')
     .action(makeAction('quickstart', (opts, _cmd, isJson) => ({ port: Number(opts.port), json: isJson })));
-  if (dryRun) {
-    cmdQuick.allowUnknownOption(true);
-    if (typeof cmdQuick.allowExcessArguments === 'function') {
-      cmdQuick.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdQuick);
 
   // spaps status
   const cmdStatus = program
@@ -108,12 +130,24 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .option('-p, --port <port>', 'Port to check', String(DEFAULT_PORT))
     .option('--json', 'Output in JSON format')
     .action(makeAction('status', (opts, _cmd, isJson) => ({ port: Number(opts.port), json: isJson })));
-  if (dryRun) {
-    cmdStatus.allowUnknownOption(true);
-    if (typeof cmdStatus.allowExcessArguments === 'function') {
-      cmdStatus.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdStatus);
+
+  // spaps verify
+  const cmdVerify = program
+    .command('verify')
+    .alias('test')
+    .description('Run a quick SPAPS verification')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('verify', (opts, _cmd, isJson) => ({
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdVerify);
 
   // spaps init
   const cmdInit = program
@@ -121,12 +155,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .description('Initialize SPAPS in current project')
     .option('--json', 'Output in JSON format')
     .action(makeAction('init', (_opts, _cmd, isJson) => ({ json: isJson })));
-  if (dryRun) {
-    cmdInit.allowUnknownOption(true);
-    if (typeof cmdInit.allowExcessArguments === 'function') {
-      cmdInit.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdInit);
 
   // spaps create <name>
   const cmdCreate = program
@@ -147,24 +176,14 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         json: isJson,
       }))
     );
-  if (dryRun) {
-    cmdCreate.allowUnknownOption(true);
-    if (typeof cmdCreate.allowExcessArguments === 'function') {
-      cmdCreate.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdCreate);
 
   // spaps types
   const cmdTypes = program
     .command('types')
     .description('Generate TypeScript types (coming soon)')
     .action(makeAction('types', () => ({})));
-  if (dryRun) {
-    cmdTypes.allowUnknownOption(true);
-    if (typeof cmdTypes.allowExcessArguments === 'function') {
-      cmdTypes.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdTypes);
 
   // spaps help
   const cmdHelp = program
@@ -175,12 +194,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .action(
       makeAction('help', (opts) => ({ interactive: Boolean(opts.interactive), quick: Boolean(opts.quick) }))
     );
-  if (dryRun) {
-    cmdHelp.allowUnknownOption(true);
-    if (typeof cmdHelp.allowExcessArguments === 'function') {
-      cmdHelp.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdHelp);
 
   // spaps docs
   const cmdDocs = program
@@ -192,12 +206,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .action(
       makeAction('docs', (opts, _cmd, isJson) => ({ interactive: Boolean(opts.interactive), search: opts.search || null, json: isJson }))
     );
-  if (dryRun) {
-    cmdDocs.allowUnknownOption(true);
-    if (typeof cmdDocs.allowExcessArguments === 'function') {
-      cmdDocs.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdDocs);
 
   // spaps tools
   const cmdTools = program
@@ -209,12 +218,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .action(
       makeAction('tools', (opts, _cmd, isJson) => ({ port: Number(opts.port), format: String(opts.format || 'openai'), json: isJson }))
     );
-  if (dryRun) {
-    cmdTools.allowUnknownOption(true);
-    if (typeof cmdTools.allowExcessArguments === 'function') {
-      cmdTools.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdTools);
 
   // spaps fixtures
   const cmdFixtures = program
@@ -223,7 +227,8 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .option('--dir <dir>', 'Target repo directory (defaults to current working directory)')
     .option('-p, --port <port>', 'Port to inspect for SPAPS runtime hints', String(DEFAULT_PORT))
     .option('--base-url <url>', 'Browser app base URL for generated storage-state files')
-    .option('--persona <persona>', 'Persona code to target for storage-state export')
+    .option('--persona <persona>', 'Persona code to target for apply or storage-state export')
+    .option('--seed', 'Run persona-declared seed requests against the local SPAPS server', false)
     .option('-f, --format <format>', 'Artifact format (playwright)', 'playwright')
     .option('--force', 'Overwrite fixture files during init', false)
     .option('--json', 'Output in JSON format')
@@ -235,18 +240,14 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
           port: Number(opts.port) || DEFAULT_PORT,
           baseUrl: opts.baseUrl || null,
           persona: opts.persona || null,
+          seed: Boolean(opts.seed),
           format: String(opts.format || 'playwright'),
           force: Boolean(opts.force),
           json: isJson,
         };
       })
     );
-  if (dryRun) {
-    cmdFixtures.allowUnknownOption(true);
-    if (typeof cmdFixtures.allowExcessArguments === 'function') {
-      cmdFixtures.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdFixtures);
 
   // spaps doctor
   const cmdDoctor = program
@@ -258,16 +259,12 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
     .action(
       makeAction('doctor', (opts, _cmd, isJson) => ({ port: Number(opts.port), stripe: opts.stripe || null, json: isJson }))
     );
-  if (dryRun) {
-    cmdDoctor.allowUnknownOption(true);
-    if (typeof cmdDoctor.allowExcessArguments === 'function') {
-      cmdDoctor.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdDoctor);
 
   // spaps login
   const cmdLogin = program
     .command('login')
+    .alias('connect')
     .description('Authenticate with a SPAPS server (RFC 8628 device flow)')
     .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
     .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
@@ -281,12 +278,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         json: isJson,
       }))
     );
-  if (dryRun) {
-    cmdLogin.allowUnknownOption(true);
-    if (typeof cmdLogin.allowExcessArguments === 'function') {
-      cmdLogin.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdLogin);
 
   // spaps logout
   const cmdLogout = program
@@ -302,12 +294,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         json: isJson,
       }))
     );
-  if (dryRun) {
-    cmdLogout.allowUnknownOption(true);
-    if (typeof cmdLogout.allowExcessArguments === 'function') {
-      cmdLogout.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdLogout);
 
   // spaps whoami
   const cmdWhoami = program
@@ -323,12 +310,7 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         json: isJson,
       }))
     );
-  if (dryRun) {
-    cmdWhoami.allowUnknownOption(true);
-    if (typeof cmdWhoami.allowExcessArguments === 'function') {
-      cmdWhoami.allowExcessArguments(true);
-    }
-  }
+  allowDryRun(cmdWhoami);
 
   // spaps token (print access token for piping to curl or env vars)
   const cmdToken = program
@@ -344,12 +326,304 @@ function defineProgram({ handlers = {}, dryRun = false, version = '0.0.0', logo
         json: isJson,
       }))
     );
-  if (dryRun) {
-    cmdToken.allowUnknownOption(true);
-    if (typeof cmdToken.allowExcessArguments === 'function') {
-      cmdToken.allowExcessArguments(true);
-    }
+  allowDryRun(cmdToken);
+
+  // spaps dayrate <subcommand>
+  const cmdDayrate = program
+    .command('dayrate <subcommand>')
+    .description('Dayrate domain commands (subcommand: config)')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('dayrate', (opts, cmd, isJson) => ({
+        subcommand: cmd.args[0],
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdDayrate);
+
+  // spaps email
+  const cmdEmail = program
+    .command('email')
+    .description('Email domain commands')
+    .showHelpAfterError()
+    .showSuggestionAfterError()
+    .addHelpText('after', '\nUse `spaps email <verb> --help` for verb-specific flags.\n');
+  if (!dryRun) {
+    cmdEmail.action(() => {
+      cmdEmail.outputHelp();
+    });
   }
+  allowDryRun(cmdEmail);
+
+  function addEmailSubcommand(name, description, addOptions, shape) {
+    const command = cmdEmail.command(name).description(description);
+    if (typeof addOptions === 'function') addOptions(command);
+    addRemoteCommandOptions(command);
+    command.action(
+      makeAction('email', (opts, _cmd, isJson) => ({
+        subcommand: name,
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        ...shape(opts),
+        json: isJson,
+      }))
+    );
+    allowDryRun(command);
+    return command;
+  }
+
+  addEmailSubcommand(
+    'send',
+    'Send a transactional email by template key',
+    (command) =>
+      command
+        .requiredOption('--template-key <key>', 'Template key')
+        .requiredOption('--to <email>', 'Recipient email address')
+        .option('--context <json>', 'Template context as JSON')
+        .option('--user-id <id>', 'User id for log attribution')
+        .option('--owner-id <id>', 'Owner id for log attribution')
+        .option('--subject-override <text>', 'Subject override')
+        .option('--body-override <text>', 'Body override'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+      to: opts.to || null,
+      context: opts.context || null,
+      userId: opts.userId || null,
+      ownerId: opts.ownerId || null,
+      subjectOverride: opts.subjectOverride || null,
+      bodyOverride: opts.bodyOverride || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'get-template',
+    'Fetch one email template by key',
+    (command) => command.requiredOption('--template-key <key>', 'Template key'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'preview',
+    'Render a template preview using sample or custom context',
+    (command) =>
+      command
+        .requiredOption('--template-key <key>', 'Template key')
+        .option('--context <json>', 'Template context as JSON'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+      context: opts.context || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'logs',
+    'List email logs filtered by owner or user',
+    (command) =>
+      command
+        .option('--owner-id <id>', 'Owner id for log attribution')
+        .option('--user-id <id>', 'User id for log attribution')
+        .option('--limit <n>', 'Pagination limit')
+        .option('--offset <n>', 'Pagination offset'),
+    (opts) => ({
+      ownerId: opts.ownerId || null,
+      userId: opts.userId || null,
+      limit: opts.limit ? Number(opts.limit) : null,
+      offset: opts.offset ? Number(opts.offset) : null,
+    })
+  );
+
+  addEmailSubcommand(
+    'list-templates',
+    'List all templates for the active application',
+    null,
+    () => ({})
+  );
+
+  addEmailSubcommand(
+    'create-template',
+    'Create a new template',
+    (command) =>
+      command
+        .requiredOption('--template-key <key>', 'Template key')
+        .requiredOption('--name <name>', 'Template display name')
+        .requiredOption('--subject <text>', 'Template subject')
+        .requiredOption('--html-body <html>', 'Template HTML body')
+        .option('--text-body <text>', 'Template text body')
+        .option('--description <text>', 'Template description')
+        .option('--from-email <email>', 'From email address')
+        .option('--from-name <name>', 'From display name')
+        .option('--reply-to <email>', 'Reply-to address')
+        .option('--variables <json>', 'Template variables JSON')
+        .option('--sample-context <json>', 'Sample context JSON')
+        .option('--is-active <bool>', 'Template active state')
+        .option('--category <category>', 'Template category'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+      name: opts.name || null,
+      subject: opts.subject || null,
+      htmlBody: opts.htmlBody || null,
+      textBody: opts.textBody || null,
+      description: opts.description || null,
+      fromEmail: opts.fromEmail || null,
+      fromName: opts.fromName || null,
+      replyTo: opts.replyTo || null,
+      variables: opts.variables || null,
+      sampleContext: opts.sampleContext || null,
+      isActive: opts.isActive === undefined ? null : opts.isActive,
+      category: opts.category || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'update-template',
+    'Update an existing template',
+    (command) =>
+      command
+        .requiredOption('--template-key <key>', 'Template key')
+        .option('--name <name>', 'Template display name')
+        .option('--subject <text>', 'Template subject')
+        .option('--html-body <html>', 'Template HTML body')
+        .option('--text-body <text>', 'Template text body')
+        .option('--description <text>', 'Template description')
+        .option('--from-email <email>', 'From email address')
+        .option('--from-name <name>', 'From display name')
+        .option('--reply-to <email>', 'Reply-to address')
+        .option('--variables <json>', 'Template variables JSON')
+        .option('--sample-context <json>', 'Sample context JSON')
+        .option('--is-active <bool>', 'Template active state')
+        .option('--category <category>', 'Template category'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+      name: opts.name || null,
+      subject: opts.subject || null,
+      htmlBody: opts.htmlBody || null,
+      textBody: opts.textBody || null,
+      description: opts.description || null,
+      fromEmail: opts.fromEmail || null,
+      fromName: opts.fromName || null,
+      replyTo: opts.replyTo || null,
+      variables: opts.variables || null,
+      sampleContext: opts.sampleContext || null,
+      isActive: opts.isActive === undefined ? null : opts.isActive,
+      category: opts.category || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'get-override',
+    'Fetch the current override for a template',
+    (command) => command.requiredOption('--template-key <key>', 'Template key'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'set-override',
+    'Create or update an override for a template',
+    (command) =>
+      command
+        .requiredOption('--template-key <key>', 'Template key')
+        .option('--subject-override <text>', 'Subject override')
+        .option('--body-override <text>', 'Body override'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+      subjectOverride: opts.subjectOverride || null,
+      bodyOverride: opts.bodyOverride || null,
+    })
+  );
+
+  addEmailSubcommand(
+    'clear-override',
+    'Delete an override for a template',
+    (command) => command.requiredOption('--template-key <key>', 'Template key'),
+    (opts) => ({
+      templateKey: opts.templateKey || null,
+    })
+  );
+
+  // spaps policy <subcommand>
+  const cmdPolicy = program
+    .command('policy <subcommand>')
+    .description('Policies domain commands (subcommand: list|create|delete)')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--name <name>', 'Policy name (create)')
+    .option('--effect <effect>', 'Policy effect: allow|deny (create)')
+    .option('--conditions <json>', 'Policy conditions as JSON (create)')
+    .option('--description <text>', 'Policy description (create)')
+    .option('--priority <n>', 'Policy priority (create)')
+    .option('--id <id>', 'Policy id (delete)')
+    .option('--is-active <bool>', 'Filter by is_active (list)')
+    .option('--limit <n>', 'Limit (list)')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('policy', (opts, cmd, isJson) => ({
+        subcommand: cmd.args[0],
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        name: opts.name || null,
+        effect: opts.effect || null,
+        conditions: opts.conditions || null,
+        description: opts.description || null,
+        priority: opts.priority ? Number(opts.priority) : 0,
+        id: opts.id || null,
+        isActive: opts.isActive === undefined ? null : opts.isActive,
+        limit: opts.limit ? Number(opts.limit) : null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdPolicy);
+
+  // spaps webhook <subcommand>
+  const cmdWebhook = program
+    .command('webhook <subcommand>')
+    .description('Webhooks domain commands (subcommand: list|register)')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--url <url>', 'Destination URL (register)')
+    .option('--events <csv>', 'Comma-separated event keys (register)')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('webhook', (opts, cmd, isJson) => ({
+        subcommand: cmd.args[0],
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        url: opts.url || null,
+        events: opts.events || null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdWebhook);
+
+  // spaps issue-reports <subcommand>
+  const cmdIssueReports = program
+    .command('issue-reports <subcommand>')
+    .description('Issue reporting commands (subcommand: list-mine)')
+    .option('-p, --port <port>', 'Port (default: 3301)', String(DEFAULT_PORT))
+    .option('--server-url <url>', 'Full server URL (overrides --port and SPAPS_API_URL)')
+    .option('--status <status>', 'Filter by status')
+    .option('--limit <n>', 'Pagination limit')
+    .option('--offset <n>', 'Pagination offset')
+    .option('--json', 'Output in JSON format')
+    .action(
+      makeAction('issue-reports', (opts, cmd, isJson) => ({
+        subcommand: cmd.args[0],
+        port: Number(opts.port) || DEFAULT_PORT,
+        serverUrl: opts.serverUrl || null,
+        status: opts.status || null,
+        limit: opts.limit ? Number(opts.limit) : null,
+        offset: opts.offset ? Number(opts.offset) : null,
+        json: isJson,
+      }))
+    );
+  allowDryRun(cmdIssueReports);
 
   return { program, getIntents: () => intents };
 }

package/src/doctor.js

@@ -6,6 +6,7 @@ const chalk = require('chalk');
 
 const { getServerStatus } = require('./ai-helper');
 const { DEFAULT_PORT } = require('./config');
+const { listDomains } = require('./domains');
 
 function checkNodeVersion() {
   const version = process.versions.node || '0.0.0';
@@ -169,6 +170,60 @@ async function checkWebhook(port) {
   }
 }
 
+async function probeDomain(port, domain) {
+  const httpMod = require('http');
+  const { method, path: probePath, ok_on_404 = false, ok_on_auth_error = false } = domain.probe;
+  return new Promise((resolve) => {
+    const req = httpMod.request(
+      { hostname: 'localhost', port, path: probePath, method, timeout: 2000 },
+      (res) => {
+        // Drain so the socket can close cleanly.
+        res.on('data', () => {});
+        res.on('end', () => {
+          const code = res.statusCode || 0;
+          const is2xx = code >= 200 && code < 300;
+          const is404 = code === 404;
+          const isAuth = code === 401 || code === 403;
+          const mounted = is2xx || (ok_on_404 && is404) || (ok_on_auth_error && isAuth);
+          resolve({
+            check: `domain_${domain.key}_mounted`,
+            success: mounted,
+            details: { probe: `${method} ${probePath}`, status: code, domain: domain.key },
+            fix: mounted
+              ? null
+              : `Probe ${method} ${probePath} returned ${code}; confirm the ${domain.label} router is mounted on the running server.`,
+          });
+        });
+      }
+    );
+    req.on('error', (err) => {
+      resolve({
+        check: `domain_${domain.key}_mounted`,
+        success: false,
+        details: { probe: `${method} ${probePath}`, error: err.message, domain: domain.key },
+        fix: `Server unreachable while probing ${method} ${probePath}. Start the local stack and retry.`,
+      });
+    });
+    req.on('timeout', () => {
+      req.destroy(new Error('probe timeout'));
+    });
+    req.end();
+  });
+}
+
+async function checkDomainMounts(port) {
+  const status = await getServerStatus(port);
+  if (!status.running) {
+    return listDomains().map((d) => ({
+      check: `domain_${d.key}_mounted`,
+      success: false,
+      details: { probe: `${d.probe.method} ${d.probe.path}`, running: false, domain: d.key },
+      fix: `Start server: npx spaps local --port ${port}`,
+    }));
+  }
+  return Promise.all(listDomains().map((d) => probeDomain(port, d)));
+}
+
 function formatHuman(results) {
   const ok = results.every(r => r.success);
   console.log(chalk.yellow('\n🍠 SPAPS Doctor\n'));
@@ -203,6 +258,8 @@ async function runDoctor({ port = DEFAULT_PORT, stripe = null, json = false } =
   results.push(checkEnvTest());
   results.push(await checkNextJsPort());
   results.push(await checkWebhook(port));
+  const domainResults = await checkDomainMounts(port);
+  results.push(...domainResults);
 
   const ok = results.every(r => r.success);
   const payload = { success: ok, results, next_steps: ok ? [] : ['Apply suggested fixes and re-run: npx spaps doctor --json'] };
@@ -214,4 +271,4 @@ async function runDoctor({ port = DEFAULT_PORT, stripe = null, json = false } =
   return payload;
 }
 
-module.exports = { runDoctor };
+module.exports = { runDoctor, checkDomainMounts };