@vizzly-testing/cli 0.34.0 → 0.35.1

package/dist/commands/tdd-daemon.js

@@ -1,12 +1,11 @@
 import { spawn } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { getServerRegistry } from '../tdd/server-registry.js';
 import { withTimeout } from '../utils/async-utils.js';
 import * as output from '../utils/output.js';
 import { tddCommand } from './tdd.js';
-import { resolveDaemonPid, waitForProcessExit } from './tdd-daemon-process.js';
+import { parsePositiveInteger, readDaemonPidFile, resolveDaemonPid, waitForProcessExit } from './tdd-daemon-process.js';
 export { findDaemonPidByPort, readDaemonPidFile, resolveDaemonPid, waitForProcessExit } from './tdd-daemon-process.js';
 let defaultTimers = {
   setTimeout,
@@ -40,55 +39,30 @@ export function cleanupLocalDaemonFiles(directory = process.cwd(), deps = {}) {
     serverFileRemoved: removeFileIfExists(serverFile, deps)
   };
 }
-export function buildLegacyServerInfo({
-  pid,
-  port,
-  now = Date.now
-}) {
-  return {
-    pid,
-    port: port.toString(),
-    startTime: now()
-  };
-}
-export function writeLegacyGlobalServerFile({
-  pid,
-  port
-}, {
-  home = homedir,
-  exists = existsSync,
-  mkdir = mkdirSync,
-  writeFile = writeFileSync,
-  now = Date.now
-} = {}) {
-  let globalVizzlyDir = join(home(), '.vizzly');
-  if (!exists(globalVizzlyDir)) {
-    mkdir(globalVizzlyDir, {
-      recursive: true
-    });
+export function readLocalDaemonInfo(directory = process.cwd(), deps = {}) {
+  let {
+    serverFile
+  } = getLocalDaemonFiles(directory);
+  let fileExists = deps.existsSync || existsSync;
+  let readFile = deps.readFileSync || readFileSync;
+  if (!fileExists(serverFile)) {
+    return null;
+  }
+  try {
+    let info = JSON.parse(readFile(serverFile, 'utf8'));
+    let port = parsePositiveInteger(info.port);
+    let pid = parsePositiveInteger(info.pid);
+    if (!port) {
+      return null;
+    }
+    return {
+      ...info,
+      port,
+      pid
+    };
+  } catch {
+    return null;
   }
-  let globalServerFile = join(globalVizzlyDir, 'server.json');
-  let serverInfo = buildLegacyServerInfo({
-    pid,
-    port,
-    now
-  });
-  writeFile(globalServerFile, JSON.stringify(serverInfo, null, 2));
-  return {
-    path: globalServerFile,
-    serverInfo
-  };
-}
-export function cleanupLegacyGlobalServerFile({
-  home = homedir,
-  exists = existsSync,
-  unlink = unlinkSync
-} = {}) {
-  let globalServerFile = join(home(), '.vizzly', 'server.json');
-  return removeFileIfExists(globalServerFile, {
-    existsSync: exists,
-    unlinkSync: unlink
-  });
 }
 export function unregisterDaemonServer({
   port,
@@ -105,10 +79,12 @@ export function cleanupDaemonState({
   directory = process.cwd(),
   registry = getServerRegistry(),
   localFileDeps = {},
-  legacyFileDeps = {}
+  cleanLocalFiles = true
 } = {}) {
-  let localFiles = cleanupLocalDaemonFiles(directory, localFileDeps);
-  let legacyGlobalServerFileRemoved = cleanupLegacyGlobalServerFile(legacyFileDeps);
+  let cleanupResult = cleanLocalFiles ? cleanupLocalDaemonFiles(directory, localFileDeps) : {
+    pidFileRemoved: false,
+    serverFileRemoved: false
+  };
   try {
     if (port !== undefined) {
       unregisterDaemonServer({
@@ -124,11 +100,42 @@ export function cleanupDaemonState({
   } catch {
     // Non-fatal; stale file cleanup is still useful on its own.
   }
+  return cleanupResult;
+}
+function resolveDaemonTarget(options = {}, directory = process.cwd()) {
+  let registry = getServerRegistry();
+  let requestedPort = options.port ? Number(options.port) : null;
+  let localInfo = readLocalDaemonInfo(directory);
+  let localInfoMatches = !requestedPort || localInfo?.port === requestedPort ? localInfo : null;
+  let registryServer = requestedPort ? registry.find({
+    port: requestedPort
+  }) : registry.find({
+    directory
+  });
+  let serverInfo = localInfoMatches || registryServer || (requestedPort ? {
+    port: requestedPort
+  } : null);
+  let port = requestedPort || serverInfo?.port || 47392;
   return {
-    ...localFiles,
-    legacyGlobalServerFileRemoved
+    registry,
+    requestedPort,
+    localInfo: localInfoMatches,
+    registryServer,
+    serverInfo,
+    port,
+    directory: registryServer?.directory || directory,
+    useLocalPidFile: !requestedPort || Boolean(localInfoMatches),
+    cleanLocalFiles: !requestedPort || Boolean(localInfoMatches || registryServer)
   };
 }
+function cleanupDaemonTarget(target) {
+  return cleanupDaemonState({
+    port: target.port,
+    directory: target.directory,
+    registry: target.registry,
+    cleanLocalFiles: target.cleanLocalFiles
+  });
+}
 export function buildDashboardUrl(port = 47392) {
   return `http://localhost:${port}`;
 }
@@ -196,29 +203,62 @@ export async function waitForDaemonChildInit(child, {
   timers = defaultTimers
 } = {}) {
   let cleanup = () => {};
+  let stderrOutput = '';
   let initPromise = new Promise(resolve => {
+    let handleStderr = data => {
+      stderrOutput += data.toString();
+    };
+    let handleMessage = message => {
+      if (message?.type !== 'error') {
+        return;
+      }
+      let error = new Error(message.message || 'Daemon child failed to start');
+      if (message.code) {
+        error.code = message.code;
+      }
+      if (message.stack) {
+        error.stack = message.stack;
+      }
+      cleanup();
+      resolve({
+        ok: false,
+        reason: 'error',
+        error
+      });
+    };
     let handleDisconnect = () => {
       cleanup();
       resolve({
         ok: true
       });
     };
-    let handleExit = () => {
+    let handleExit = (code, signal) => {
+      let error = new Error(stderrOutput.trim() || 'Daemon child exited before startup');
+      error.code = code ?? signal ?? null;
       cleanup();
       resolve({
         ok: false,
-        reason: 'exit'
+        reason: 'exit',
+        error
       });
     };
     cleanup = () => {
+      child.stderr?.off?.('data', handleStderr);
+      child.off('message', handleMessage);
       child.off('disconnect', handleDisconnect);
       child.off('exit', handleExit);
     };
+    child.stderr?.on?.('data', handleStderr);
+    child.on('message', handleMessage);
     child.on('disconnect', handleDisconnect);
     child.on('exit', handleExit);
   });
   try {
-    return await withTimeout(initPromise, timeoutMs, 'TDD server initialization timed out', timers);
+    let result = await withTimeout(initPromise, timeoutMs, 'TDD server initialization timed out', timers);
+    if (result.ok) {
+      child.stderr?.unref?.();
+    }
+    return result;
   } catch (error) {
     cleanup();
     return {
@@ -301,7 +341,7 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
   let autoAllocated = false;
   if (options.port) {
     // User specified a port - use it (will fail if busy)
-    port = options.port;
+    port = Number(options.port);
 
     // Check if user-specified port is in use
     if (await isServerRunning(port)) {
@@ -339,14 +379,15 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
       output.startSpinner(`Downloading baselines from build ${options.baselineBuild}...`);
     }
 
-    // Spawn child process with stdio inherited during init for direct error visibility
+    // Keep daemon stdio detached so callers that capture output do not hang
+    // waiting for the long-lived child to close inherited pipes.
     let child = spawn(process.execPath, buildDaemonChildArgs({
       port,
       options,
       globalOptions
     }), {
       detached: true,
-      stdio: ['ignore', 'inherit', 'inherit', 'ipc'],
+      stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
       cwd: process.cwd()
     });
     let initResult = await waitForDaemonChildInit(child);
@@ -354,7 +395,7 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
       if (options.baselineBuild && !globalOptions.verbose) {
         output.stopSpinner();
       }
-      output.error('TDD server failed to start');
+      output.error(initResult.error?.message || 'TDD server failed to start');
       process.exit(1);
     }
 
@@ -394,16 +435,6 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
       // Non-fatal
     }
 
-    // Also write legacy server.json for SDK discovery (backwards compatibility)
-    try {
-      writeLegacyGlobalServerFile({
-        pid: child.pid,
-        port
-      });
-    } catch {
-      // Non-fatal, SDK can still use health check
-    }
-
     // JSON output for successful start
     let dashboardUrl = buildDashboardUrl(port);
     if (globalOptions.json) {
@@ -442,7 +473,8 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
 
     // Always show stop hint
     output.blank();
-    output.hint('Stop with: vizzly tdd stop');
+    let stopCommand = port === 47392 ? 'vizzly tdd stop' : `vizzly tdd stop --port ${port}`;
+    output.hint(`Stop with: ${stopCommand}`);
     if (options.open) {
       openDashboard(port);
     }
@@ -475,6 +507,7 @@ export async function runDaemonChild(options = {}, globalOptions = {}) {
   try {
     // Use existing tddCommand but with daemon mode
     let {
+      result,
       cleanup
     } = await tddCommand(null,
     // No test command - server only
@@ -482,6 +515,9 @@ export async function runDaemonChild(options = {}, globalOptions = {}) {
       ...options,
       daemon: true
     }, globalOptions);
+    if (result?.success === false) {
+      throw new Error(result.error || 'TDD server failed to start');
+    }
 
     // Disconnect IPC after successful initialization to signal parent
     if (process.send) {
@@ -521,11 +557,29 @@ export async function runDaemonChild(options = {}, globalOptions = {}) {
     // Keep process alive
     process.stdin.resume();
   } catch (error) {
-    // Most errors shown via inherited stdio, but catch any that weren't
+    await sendDaemonChildError(error);
     console.error(`Fatal error: ${error.message}`);
     process.exit(1);
   }
 }
+async function sendDaemonChildError(error) {
+  if (!process.send) {
+    return;
+  }
+  let message = {
+    type: 'error',
+    message: error.message,
+    code: error.code || null,
+    stack: error.stack || null
+  };
+  await new Promise(resolve => {
+    try {
+      process.send(message, () => resolve());
+    } catch {
+      resolve();
+    }
+  });
+}
 
 /**
  * Stop TDD daemon server
@@ -538,10 +592,16 @@ export async function tddStopCommand(options = {}, globalOptions = {}) {
     verbose: globalOptions.verbose,
     color: !globalOptions.noColor
   });
-  let port = options.port || 47392;
-  let pid = await resolveDaemonPid({
-    port
-  });
+  let target = resolveDaemonTarget(options);
+  let pid = target.useLocalPidFile ? await resolveDaemonPid({
+    port: target.port
+  }) : null;
+
+  // Stop is intentionally file/registry-driven. Do not rediscover arbitrary
+  // processes by port here; a non-Vizzly server may be using that port.
+  if (!pid) {
+    pid = target.serverInfo?.pid || null;
+  }
   if (!pid) {
     // JSON output for not running
     if (globalOptions.json) {
@@ -554,9 +614,7 @@ export async function tddStopCommand(options = {}, globalOptions = {}) {
     }
 
     // Clean up any stale files
-    cleanupDaemonState({
-      port
-    });
+    cleanupDaemonTarget(target);
     return;
   }
   try {
@@ -576,16 +634,14 @@ export async function tddStopCommand(options = {}, globalOptions = {}) {
     }
 
     // Clean up files
-    cleanupDaemonState({
-      port
-    });
+    cleanupDaemonTarget(target);
 
     // JSON output for successful stop
     if (globalOptions.json) {
       output.data({
         status: 'stopped',
         pid,
-        port
+        port: target.port
       });
       return;
     }
@@ -593,10 +649,16 @@ export async function tddStopCommand(options = {}, globalOptions = {}) {
   } catch (error) {
     if (error.code === 'ESRCH') {
       // Process not found - clean up stale files
+      cleanupDaemonTarget(target);
+      if (globalOptions.json) {
+        output.data({
+          status: 'stale',
+          stopped: false,
+          message: 'TDD server was not running; cleaned up stale files'
+        });
+        return;
+      }
       output.warn('TDD server was not running (cleaning up stale files)');
-      cleanupDaemonState({
-        port
-      });
     } else {
       output.error('Error stopping TDD server', error);
     }
@@ -608,17 +670,53 @@ export async function tddStopCommand(options = {}, globalOptions = {}) {
  * @param {Object} options - Command options
  * @param {Object} globalOptions - Global CLI options
  */
-export async function tddStatusCommand(_options, globalOptions = {}) {
+function printRunningStatus({
+  serverInfo,
+  port,
+  pid,
+  uptimeMs = null,
+  uptimeStr = '',
+  dashboardUrl = buildDashboardUrl(port),
+  globalOptions = {}
+}) {
+  if (globalOptions.json) {
+    output.data({
+      running: true,
+      port,
+      pid,
+      uptimeMs,
+      uptime: uptimeStr || null,
+      dashboardUrl
+    });
+    return;
+  }
+  let colors = output.getColors();
+  output.header('tdd', 'local');
+  output.print(`  ${output.statusDot('success')} Running ${uptimeStr ? colors.brand.textTertiary(`· ${uptimeStr}`) : ''}`);
+  output.blank();
+  output.printBox(colors.brand.info(colors.underline(dashboardUrl)), {
+    title: 'Dashboard',
+    style: 'branded'
+  });
+  if (globalOptions.verbose && pid) {
+    output.blank();
+    output.print(`  ${colors.brand.textTertiary('PID:')} ${pid}`);
+  }
+  if (globalOptions.verbose && serverInfo?.logFile) {
+    output.print(`  ${colors.brand.textTertiary('Log:')} ${serverInfo.logFile}`);
+  }
+}
+export async function tddStatusCommand(options = {}, globalOptions = {}) {
   output.configure({
     json: globalOptions.json,
     verbose: globalOptions.verbose,
     color: !globalOptions.noColor
   });
   let {
-    pidFile,
-    serverFile
+    pidFile
   } = getLocalDaemonFiles();
-  if (!existsSync(pidFile)) {
+  let target = resolveDaemonTarget(options);
+  if (!target.serverInfo && !existsSync(pidFile)) {
     // JSON output for not running
     if (globalOptions.json) {
       output.data({
@@ -631,31 +729,27 @@ export async function tddStatusCommand(_options, globalOptions = {}) {
     return;
   }
   try {
-    let pid = parsePositiveInteger(readFileSync(pidFile, 'utf8'));
+    let pid = target.useLocalPidFile ? readDaemonPidFile(pidFile) : null;
+    if (!pid) {
+      pid = target.serverInfo?.pid || null;
+    }
     if (!pid) {
-      output.warn('TDD server pid file is invalid (cleaning up stale files)');
-      cleanupDaemonState();
+      output.warn('TDD server not running (cleaning up stale files)');
+      cleanupDaemonTarget(target);
       return;
     }
 
     // Check if process is actually running
     process.kill(pid, 0); // Signal 0 just checks if process exists
 
-    let serverInfo = {
-      port: 47392
-    };
-    if (existsSync(serverFile)) {
-      serverInfo = JSON.parse(readFileSync(serverFile, 'utf8'));
-    }
-
     // Try to check health endpoint
-    let health = await checkServerHealth(serverInfo.port);
+    let health = await checkServerHealth(target.port);
     if (health.running) {
       // Calculate uptime
       let uptimeMs = null;
       let uptimeStr = '';
-      if (serverInfo.startTime) {
-        uptimeMs = Date.now() - serverInfo.startTime;
+      if (target.serverInfo?.startTime) {
+        uptimeMs = Date.now() - target.serverInfo.startTime;
         let uptime = Math.floor(uptimeMs / 1000);
         let hours = Math.floor(uptime / 3600);
         let minutes = Math.floor(uptime % 3600 / 60);
@@ -664,47 +758,31 @@ export async function tddStatusCommand(_options, globalOptions = {}) {
         if (minutes > 0 || hours > 0) uptimeStr += `${minutes}m `;
         uptimeStr += `${seconds}s`;
       }
-      let dashboardUrl = buildDashboardUrl(serverInfo.port);
-
-      // JSON output for running status
-      if (globalOptions.json) {
-        output.data({
-          running: true,
-          port: serverInfo.port,
-          pid,
-          uptimeMs,
-          uptime: uptimeStr || null,
-          dashboardUrl
-        });
-        return;
-      }
-      let colors = output.getColors();
-
-      // Show header
-      output.header('tdd', 'local');
-
-      // Show running status with uptime
-      output.print(`  ${output.statusDot('success')} Running ${uptimeStr ? colors.brand.textTertiary(`· ${uptimeStr}`) : ''}`);
-      output.blank();
-
-      // Show dashboard URL in a branded box
-      output.printBox(colors.brand.info(colors.underline(dashboardUrl)), {
-        title: 'Dashboard',
-        style: 'branded'
+      let dashboardUrl = buildDashboardUrl(target.port);
+      printRunningStatus({
+        serverInfo: target.serverInfo,
+        port: target.port,
+        pid,
+        uptimeMs,
+        uptimeStr,
+        dashboardUrl,
+        globalOptions
       });
-
-      // Verbose mode: show PID
-      if (globalOptions.verbose) {
-        output.blank();
-        output.print(`  ${colors.brand.textTertiary('PID:')} ${pid}`);
-      }
     } else {
       output.warn('TDD server process exists but not responding to health checks');
     }
   } catch (error) {
     if (error.code === 'ESRCH') {
+      cleanupDaemonTarget(target);
+      if (globalOptions.json) {
+        output.data({
+          status: 'stale',
+          running: false,
+          message: 'TDD server process not found; cleaned up stale files'
+        });
+        return;
+      }
       output.warn('TDD server process not found (cleaning up stale files)');
-      cleanupDaemonState();
     } else {
       output.error('Error checking TDD server status', error);
     }

package/dist/commands/tdd.js

@@ -5,6 +5,7 @@
 
 import { spawn as defaultSpawn } from 'node:child_process';
 import { createBuild as defaultCreateApiBuild, createApiClient as defaultCreateApiClient, finalizeBuild as defaultFinalizeApiBuild, getBuild as defaultGetBuild } from '../api/index.js';
+import { CONFIG_DEFAULTS } from '../config/core.js';
 import { VizzlyError } from '../errors/vizzly-error.js';
 import { createServerManager as defaultCreateServerManager } from '../server-manager/index.js';
 import { createAuthService as defaultCreateAuthService } from '../services/auth-service.js';
@@ -13,7 +14,7 @@ import { createConfigService as defaultCreateConfigService } from '../services/c
 import { createProjectService as defaultCreateProjectService } from '../services/project-service.js';
 import { initializeDaemon as defaultInitializeDaemon, runTests as defaultRunTests } from '../test-runner/index.js';
 import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
-import { detectBranch as defaultDetectBranch, detectCommit as defaultDetectCommit } from '../utils/git.js';
+import { detectBranch as defaultDetectBranch, detectCommit as defaultDetectCommit, detectCommitMessage as defaultDetectCommitMessage, detectPullRequestNumber as defaultDetectPullRequestNumber, generateBuildNameWithGit as defaultGenerateBuildNameWithGit } from '../utils/git.js';
 import * as defaultOutput from '../utils/output.js';
 function buildLocalContextCommand() {
   return 'vizzly context build current --source local --agent';
@@ -43,6 +44,9 @@ export async function tddCommand(testCommand, options = {}, globalOptions = {},
     runTests = defaultRunTests,
     detectBranch = defaultDetectBranch,
     detectCommit = defaultDetectCommit,
+    detectCommitMessage = defaultDetectCommitMessage,
+    detectPullRequestNumber = defaultDetectPullRequestNumber,
+    generateBuildNameWithGit = defaultGenerateBuildNameWithGit,
     spawn = defaultSpawn,
     output = defaultOutput
   } = deps;
@@ -76,7 +80,7 @@ export async function tddCommand(testCommand, options = {}, globalOptions = {},
     let config = await loadConfig(globalOptions.config, allOptions);
 
     // Dev mode works locally by default - only needs token for baseline download
-    let needsToken = options.baselineBuild || options.baselineComparison;
+    let needsToken = options.baselineBuild || options.baselineComparison || config.baselineBuildId || config.baselineComparisonId;
     if (!config.apiKey && needsToken) {
       throw new Error('API token required when using --baseline-build or --baseline-comparison flags');
     }
@@ -85,8 +89,12 @@ export async function tddCommand(testCommand, options = {}, globalOptions = {},
     config.allowNoToken = true;
 
     // Collect git metadata
-    let branch = await detectBranch(options.branch);
-    let commit = await detectCommit(options.commit);
+    let configuredBuildName = config.build.name && config.build.name !== CONFIG_DEFAULTS.build.name ? config.build.name : undefined;
+    let branch = await detectBranch(options.branch || config.build.branch);
+    let commit = await detectCommit(options.commit || config.build.commit);
+    let message = options.message || config.build.message || (await detectCommitMessage());
+    let buildName = await generateBuildNameWithGit(options.buildName || configuredBuildName);
+    let pullRequestNumber = detectPullRequestNumber();
 
     // Show header (skip in daemon mode)
     if (!options.daemon) {
@@ -132,15 +140,28 @@ export async function tddCommand(testCommand, options = {}, globalOptions = {},
       tdd: true,
       daemon: options.daemon || false,
       setBaseline: options.setBaseline || false,
+      failOnDiff: options.failOnDiff || false,
+      name: buildName,
+      buildName,
       branch,
       commit,
+      message,
       environment: config.build.environment,
+      pullRequestNumber,
+      parallelId: config.parallelId,
+      metadata: {
+        comparison: {
+          threshold: config.comparison.threshold,
+          minClusterSize: config.comparison.minClusterSize
+        }
+      },
       threshold: config.comparison.threshold,
       minClusterSize: config.comparison.minClusterSize,
       allowNoToken: config.allowNoToken || false,
       baselineBuildId: config.baselineBuildId,
       baselineComparisonId: config.baselineComparisonId,
-      wait: false
+      wait: false,
+      json: globalOptions.json
     };
 
     // In daemon mode, just start the server without running tests