livedesk 0.1.591 → 0.1.593

package/bin/livedesk.js

@@ -101,7 +101,7 @@ function prepareUpdateNeutralCwd(kind, operationId) {
   if (unexpectedEntry) {
     const shadowPath = join(neutralCwd, unexpectedEntry);
     throw new Error(
-      `LiveDesk update neutral working directory is shadowed by ${shadowPath}: ${neutralCwd}`
+      `VuvoDesk update neutral working directory is shadowed by ${shadowPath}: ${neutralCwd}`
     );
   }
   return neutralCwd;
@@ -135,7 +135,7 @@ function restoreUpdateOriginalCwd() {
     process.chdir(UPDATE_ORIGINAL_CWD);
   } catch (error) {
     throw new Error(
-      `LiveDesk could not restore the pre-update working directory ${UPDATE_ORIGINAL_CWD}: `
+      `VuvoDesk could not restore the pre-update working directory ${UPDATE_ORIGINAL_CWD}: `
       + `${error instanceof Error ? error.message : String(error)}`
     );
   }
@@ -190,12 +190,12 @@ async function assertNoActiveMacPhysicalDiagnosticLease() {
       return;
     }
     throw new Error(
-      `Mac physical diagnostic is running (pid ${lease.pid}); normal LiveDesk startup was not started. `
+      `Mac physical diagnostic is running (pid ${lease.pid}); normal VuvoDesk startup was not started. `
       + 'Wait for its owned cleanup to finish or stop the diagnostic with Ctrl+C.'
     );
   }
   throw new Error(
-    `Mac physical diagnostic ownership is unreadable at ${lease.path}; normal LiveDesk startup was not started `
+    `Mac physical diagnostic ownership is unreadable at ${lease.path}; normal VuvoDesk startup was not started `
     + 'to avoid overlapping a capture runtime.'
   );
 }
@@ -254,11 +254,11 @@ async function waitForHubRestartUpdateHostClaim(updateHost, jobId, expected) {
       timeoutMs: Math.min(2_000, Math.max(250, claimDeadline - Date.now()))
     });
     if (!job) {
-      throw new Error(`LiveDesk Update Host lost job ${jobId} before handoff.`);
+      throw new Error(`VuvoDesk Update Host lost job ${jobId} before handoff.`);
     }
     if (['failed', 'cancelled'].includes(String(job.state || ''))) {
       throw new Error(
-        `LiveDesk Update Host job ${jobId} failed before handoff: ${job.error || `state=${job.state}`}`
+        `VuvoDesk Update Host job ${jobId} failed before handoff: ${job.error || `state=${job.state}`}`
       );
     }
     workerPid = Number(job.workerPid || 0);
@@ -300,7 +300,7 @@ async function waitForHubRestartUpdateHostClaim(updateHost, jobId, expected) {
     await delay(Math.max(50, HUB_UPDATE_SUPERVISOR_HANDSHAKE_POLL_MS));
   }
   throw new Error(
-    `LiveDesk Update Host job ${jobId} did not publish an atomic handoff for `
+    `VuvoDesk Update Host job ${jobId} did not publish an atomic handoff for `
     + `operation ${expected.operationId} within ${expected.timeoutMs}ms.`
   );
 }
@@ -339,7 +339,7 @@ function writeJsonAtomic(filePath, value) {
 
 function printHelp() {
   process.stdout.write(`
-LiveDesk
+VuvoDesk
 
 Usage:
   npx -y --prefer-online livedesk@latest
@@ -364,10 +364,10 @@ Hub options:
   --port <port>  Hub HTTP port. Default: 5179
   --remote-port <port>
                  Client connection port. Default: 5197.
-  --clean        Proactively replace verified stale LiveDesk owners on Hub ports.
+  --clean        Proactively replace verified stale VuvoDesk owners on Hub ports.
   --no-clean     Do not attempt automatic port-conflict recovery.
   --no-restart-existing
-                 Keep an existing same-role LiveDesk runtime and open its page.
+                 Keep an existing same-role VuvoDesk runtime and open its page.
 
 Common:
   --force-role <hub|client>
@@ -382,7 +382,7 @@ Common:
 
 function printMacPhysicalDiagnosticHelp() {
   process.stdout.write(`
-LiveDesk macOS physical diagnostic
+VuvoDesk macOS physical diagnostic
 
 Usage:
   npx -y --prefer-online livedesk@latest diagnose mac-physical --confirm-active-motion
@@ -390,16 +390,16 @@ Usage:
 
 Requirements:
   macOS with two connected displays showing visibly different, continuously moving content.
-  Screen Recording permission for the terminal/LiveDesk capture helper.
-  Accessibility permission for the terminal/LiveDesk input helper.
-  Stop every existing LiveDesk Hub, Client, and desktop runtime first.
+  Screen Recording permission for the terminal/VuvoDesk capture helper.
+  Accessibility permission for the terminal/VuvoDesk input helper.
+  Stop every existing VuvoDesk Hub, Client, and desktop runtime first.
   --confirm-active-motion attests that motion is already running on both displays;
   measured decoded-pixel change and native cadence must still prove it.
 
 Behavior:
   Starts one production unified Hub root and one production unified Client root
   with isolated loopback state; the Client starts its normal RemoteFast child.
-  Refuses to overlap a running LiveDesk runtime or capture helper.
+  Refuses to overlap a running VuvoDesk runtime or capture helper.
   Stops only those exact launcher roots after their descendants drain.
   Writes the default report under ~/.livedesk/diagnostics.
 
@@ -425,14 +425,14 @@ async function runDiagnosticCommand(args) {
       'livedesk-transport-physical.mjs'
     );
     if (!existsSync(diagnosticEntry)) {
-      throw new Error(`LiveDesk transport-physical diagnostic is missing from this package: ${diagnosticEntry}`);
+      throw new Error(`VuvoDesk transport-physical diagnostic is missing from this package: ${diagnosticEntry}`);
     }
     const diagnostic = await import(pathToFileURL(diagnosticEntry).href);
     await diagnostic.runTransportPhysicalDiagnosticCli(args.slice(1));
     return;
   }
   if (name !== 'mac-physical') {
-    throw new Error(`Unknown LiveDesk diagnostic: ${name}. Supported diagnostics: mac-physical, transport-physical.`);
+    throw new Error(`Unknown VuvoDesk diagnostic: ${name}. Supported diagnostics: mac-physical, transport-physical.`);
   }
   if (args.slice(1).some(argument => ['--help', '-h', 'help'].includes(String(argument).toLowerCase()))) {
     printMacPhysicalDiagnosticHelp();
@@ -444,21 +444,21 @@ async function runDiagnosticCommand(args) {
     'livedesk-mode3-capture-smoke.mjs'
   );
   if (!existsSync(diagnosticEntry)) {
-    throw new Error(`LiveDesk mac-physical diagnostic is missing from this package: ${diagnosticEntry}`);
+    throw new Error(`VuvoDesk mac-physical diagnostic is missing from this package: ${diagnosticEntry}`);
   }
   await import(pathToFileURL(diagnosticEntry).href);
 }
 
 function printClientHelp() {
   process.stdout.write(`
-LiveDesk Client
+VuvoDesk Client
 
 Usage:
   npx -y --prefer-online livedesk@latest client
   npx -y --prefer-online livedesk@latest client 3
 
 Default flow:
-  Opens a LiveDesk connection page with Google sign-in or a 6-digit PIN.
+  Opens a VuvoDesk connection page with Google sign-in or a 6-digit PIN.
   Omit the number for first-available placement, or pass 1-999 to pin a slot.
   On Windows, enable auto-start from the connection page checkbox.
 
@@ -665,7 +665,7 @@ async function waitForRoleTransitionParentExit(pid, timeoutMs = 120_000) {
     if (!alive) return;
     await new Promise(resolve => setTimeout(resolve, 250));
   }
-  throw new Error(`Previous LiveDesk runtime ${processId} did not exit before the role transition deadline.`);
+  throw new Error(`Previous VuvoDesk runtime ${processId} did not exit before the role transition deadline.`);
 }
 
 async function isManagerAlreadyRunning(url = DEFAULT_MANAGER_URL) {
@@ -743,7 +743,7 @@ async function probeExistingRuntimeIdentity(existing) {
         };
       }
     } catch {
-      // A non-LiveDesk, stopping, or unreachable owner is not runtime proof.
+      // A non-VuvoDesk, stopping, or unreachable owner is not runtime proof.
     } finally {
       clearTimeout(timer);
     }
@@ -904,7 +904,7 @@ async function waitForProcessExit(pid, timeoutMs = EXISTING_RUNTIME_STOP_TIMEOUT
     if (!alive) return;
     await waitMilliseconds(Math.min(PORT_CLEANUP_POLL_MS, Math.max(1, deadline - Date.now())));
   }
-  throw new Error(`Existing LiveDesk runtime ${processId} did not exit before the restart deadline.`);
+  throw new Error(`Existing VuvoDesk runtime ${processId} did not exit before the restart deadline.`);
 }
 
 function normalizeExactWindowsProcessRecord(value, depth = 0) {
@@ -958,7 +958,7 @@ async function queryExactWindowsProcessSnapshot() {
   );
   if (!result.ok || !result.stdout) {
     throw new Error(
-      'LiveDesk could not establish an immutable Windows process snapshot: '
+      'VuvoDesk could not establish an immutable Windows process snapshot: '
       + `${result.stderr || result.error?.message || 'CIM query failed'}`
     );
   }
@@ -966,7 +966,7 @@ async function queryExactWindowsProcessSnapshot() {
   try {
     parsed = JSON.parse(result.stdout);
   } catch (error) {
-    throw new Error(`LiveDesk could not parse the immutable Windows process snapshot: ${error.message}`);
+    throw new Error(`VuvoDesk could not parse the immutable Windows process snapshot: ${error.message}`);
   }
   const records = parsed?.Records == null
     ? []
@@ -977,7 +977,7 @@ async function queryExactWindowsProcessSnapshot() {
 async function captureExactWindowsProcessTree(rootDetails, { rootExitedAtMs = null } = {}) {
   const rootRecord = normalizeExactWindowsProcessRecord(rootDetails, 0);
   if (!rootRecord) {
-    throw new Error('LiveDesk could not establish the launcher CreationDate identity; it was preserved.');
+    throw new Error('VuvoDesk could not establish the launcher CreationDate identity; it was preserved.');
   }
   const snapshot = await queryExactWindowsProcessSnapshot();
   const currentByPid = new Map(snapshot.map(record => [record.pid, record]));
@@ -1056,7 +1056,7 @@ async function exactReclaimedWindowsRecordsStillRunning(records) {
   );
   if (!result.ok || !result.stdout) {
     throw new Error(
-      'LiveDesk could not revalidate the reclaimed Windows process identities: '
+      'VuvoDesk could not revalidate the reclaimed Windows process identities: '
       + `${result.stderr || result.error?.message || 'targeted CIM query failed'}`
     );
   }
@@ -1064,7 +1064,7 @@ async function exactReclaimedWindowsRecordsStillRunning(records) {
   try {
     parsed = JSON.parse(result.stdout);
   } catch (error) {
-    throw new Error(`LiveDesk could not parse reclaimed Windows process identities: ${error.message}`);
+    throw new Error(`VuvoDesk could not parse reclaimed Windows process identities: ${error.message}`);
   }
   const values = parsed?.Records == null
     ? []
@@ -1094,7 +1094,7 @@ async function terminateExactWindowsProcesses(recordOrRecords) {
     .map(record => normalizeExactWindowsProcessRecord(record, record?.depth))
     .filter(Boolean);
   if (targets.length === 0) {
-    throw new Error('LiveDesk refused to terminate Windows processes without immutable CreationDates.');
+    throw new Error('VuvoDesk refused to terminate Windows processes without immutable CreationDates.');
   }
   const targetsJson = JSON.stringify(targets.map(target => ({
     pid: target.pid,
@@ -1175,7 +1175,7 @@ async function drainReclaimedWindowsClientManifest(reclaimedOwner, {
     if (inheritedManifest.missing === true) {
       if (process.env.LIVEDESK_DEBUG === '1') {
         console.log(
-          `[LiveDesk] Reclaimed Windows Client generation ${exactOwner.pid} `
+          `[VuvoDesk] Reclaimed Windows Client generation ${exactOwner.pid} `
           + 'has no exact process manifest; continuing legacy cleanup.'
         );
       }
@@ -1219,7 +1219,7 @@ async function drainReclaimedWindowsClientManifest(reclaimedOwner, {
       }
       if (process.env.LIVEDESK_DEBUG === '1') {
         console.log(
-          `[LiveDesk] Reclaimed Windows Client generation ${exactOwner.pid} `
+          `[VuvoDesk] Reclaimed Windows Client generation ${exactOwner.pid} `
           + `drained ${tracked.length} exact process record(s) and consumed its manifest.`
         );
       }
@@ -1246,7 +1246,7 @@ async function drainReclaimedWindowsClientManifest(reclaimedOwner, {
 }
 
 async function terminateExactWindowsProcessTree(rootDetails, {
-  label = 'LiveDesk process tree',
+  label = 'VuvoDesk process tree',
   maxAttempts = 4,
   additionalRecords = []
 } = {}) {
@@ -1314,7 +1314,7 @@ async function terminateExactWindowsProcessTree(rootDetails, {
 async function stopExistingRuntime(existing) {
   const processId = Number(existing?.pid);
   if (!Number.isInteger(processId) || processId <= 1) {
-    throw new Error('Existing LiveDesk runtime has an invalid process id; it was preserved.');
+    throw new Error('Existing VuvoDesk runtime has an invalid process id; it was preserved.');
   }
   const storedOwnerToken = String(existing?.ownerToken || '').trim();
   const storedOwnerInstanceMarker = String(existing?.ownerInstanceMarker || '').trim();
@@ -1334,7 +1334,7 @@ async function stopExistingRuntime(existing) {
       }
     : null;
   if (processId === process.pid) {
-    throw new Error('Existing LiveDesk runtime resolves to this launcher without an exact stale-owner proof; it was preserved.');
+    throw new Error('Existing VuvoDesk runtime resolves to this launcher without an exact stale-owner proof; it was preserved.');
   }
 
   // The mailbox is non-destructive and authenticates the current lock token.
@@ -1369,7 +1369,7 @@ async function stopExistingRuntime(existing) {
   const cooperativeStop = await cooperativeStopPromise;
   if (cooperativeStop.exited) {
     console.log(
-      `[LiveDesk] Existing ${existing?.role || 'runtime'} launcher pid ${processId} `
+      `[VuvoDesk] Existing ${existing?.role || 'runtime'} launcher pid ${processId} `
       + 'accepted cooperative cleanup and exited before replacement (identity=exact-owner-mailbox).'
     );
     return { runtimeProof: null, staleOwnerProof: null };
@@ -1390,7 +1390,7 @@ async function stopExistingRuntime(existing) {
     && (processInstanceMarker(fallbackDetails) !== processInstanceMarker(details)
       || String(fallbackDetails.startOrder || '') !== String(details.startOrder || ''))) {
     console.warn(
-      `[LiveDesk] Launcher pid ${processId} changed identity while cooperative cleanup was pending; `
+      `[VuvoDesk] Launcher pid ${processId} changed identity while cooperative cleanup was pending; `
       + 'the reused process was preserved.'
     );
     if (exactStaleOwnerProof) {
@@ -1404,7 +1404,7 @@ async function stopExistingRuntime(existing) {
     && currentOwnerStartOrder
     && storedOwnerStartOrder !== currentOwnerStartOrder) {
     console.warn(
-      `[LiveDesk] Runtime lock pid ${processId} was reused by a different process instance; `
+      `[VuvoDesk] Runtime lock pid ${processId} was reused by a different process instance; `
       + 'the current process was preserved and only the exact stale lock may be reclaimed.'
     );
     return { runtimeProof: null, staleOwnerProof: exactStaleOwnerProof };
@@ -1429,7 +1429,7 @@ async function stopExistingRuntime(existing) {
     && !legacyClientTreeConfirmed
     && !runtimeProof
     && !cooperativeOwnerConfirmed) {
-    throw new Error(`Existing runtime pid ${processId} is not a confirmed LiveDesk launcher; it was preserved.`);
+    throw new Error(`Existing runtime pid ${processId} is not a confirmed VuvoDesk launcher; it was preserved.`);
   }
 
   const identityProof = cooperativeOwnerConfirmed
@@ -1459,7 +1459,7 @@ async function stopExistingRuntime(existing) {
       || currentLock.ownerInstanceMarker !== storedOwnerInstanceMarker
       || currentLock.ownerStartOrder !== storedOwnerStartOrder) {
       throw new Error(
-        `LiveDesk runtime-lock ownership changed before fallback for pid ${processId}; `
+        `VuvoDesk runtime-lock ownership changed before fallback for pid ${processId}; `
         + 'the current process and newer lock generation were preserved.'
       );
     }
@@ -1488,16 +1488,16 @@ async function stopExistingRuntime(existing) {
       ? `ack=${cooperativeStop.ackStatus || 'accepted'}`
       : 'no-ack';
     console.warn(
-      `[LiveDesk] Existing ${existing?.role || 'runtime'} launcher pid ${processId} `
+      `[VuvoDesk] Existing ${existing?.role || 'runtime'} launcher pid ${processId} `
       + `did not finish cooperative cleanup within its ${cooperativeTimeoutMs / 1000}-second `
       + `maximum window (${status}); `
       + 'continuing with exact process-identity fallback.'
     );
   }
-  console.log(`[LiveDesk] Stopping existing ${existing?.role || 'runtime'} launcher pid ${processId} before starting a fresh runtime (identity=${identityProof}).`);
+  console.log(`[VuvoDesk] Stopping existing ${existing?.role || 'runtime'} launcher pid ${processId} before starting a fresh runtime (identity=${identityProof}).`);
   if (os.platform() === 'win32') {
     await terminateExactWindowsProcessTree(details, {
-      label: `existing LiveDesk ${existing?.role || 'runtime'} launcher pid=${processId}`,
+      label: `existing VuvoDesk ${existing?.role || 'runtime'} launcher pid=${processId}`,
       additionalRecords: inheritedWindowsProcessRecords
     });
   } else {
@@ -1508,7 +1508,7 @@ async function stopExistingRuntime(existing) {
       await waitForProcessExit(processId);
     } catch (error) {
       console.warn(
-        `[LiveDesk] Confirmed launcher pid ${processId} did not finish graceful Client cleanup; `
+        `[VuvoDesk] Confirmed launcher pid ${processId} did not finish graceful Client cleanup; `
         + 'force-stopping that launcher only. Verified orphan agents/helpers will be audited before restart.'
       );
       try { process.kill(processId, 'SIGKILL'); } catch (killError) {
@@ -1543,7 +1543,7 @@ function startOwnedRuntimeShutdownWatcher(runtimeOwner, onShutdown) {
   if (!exactOwnerIsComplete) {
     if (runtimeOwner?.ownerToken) {
       console.warn(
-        '[LiveDesk] Cooperative shutdown watcher is unavailable because the launcher '
+        '[VuvoDesk] Cooperative shutdown watcher is unavailable because the launcher '
         + 'could not establish a complete process-start identity. Exact fallback remains enabled.'
       );
     }
@@ -1632,7 +1632,7 @@ function assertPortCleanupReady(finalRecords, portStates) {
       .map(formatPortOwner);
     return `TCP ${port.Port}[available=${port.PortAvailable === true},bindable=${port.PortBindable === true},bind-error=${port.BindError || 'none'},owners=${owners.length ? owners.join('; ') : 'owner not visible'}`;
   }).join('], ');
-  throw new Error(`LiveDesk Hub startup cleanup could not release the configured port(s): ${summary}]. Unrelated processes are preserved; stop the owning process manually or choose an explicit --port/--remote-port value.`);
+  throw new Error(`VuvoDesk Hub startup cleanup could not release the configured port(s): ${summary}]. Unrelated processes are preserved; stop the owning process manually or choose an explicit --port/--remote-port value.`);
 }
 
 async function collectWindowsPortRecords(ports) {
@@ -1680,7 +1680,7 @@ async function collectWindowsPortRecords(ports) {
   );
   if (!result.ok && !result.stdout) {
     throw new Error(
-      `Could not inspect existing LiveDesk Windows ports: `
+      `Could not inspect existing VuvoDesk Windows ports: `
       + `${result.stderr || result.error?.message || 'PowerShell failed'}`
     );
   }
@@ -1689,7 +1689,7 @@ async function collectWindowsPortRecords(ports) {
   try {
     parsed = JSON.parse(result.stdout);
   } catch {
-    throw new Error(`Could not parse existing LiveDesk Windows port state: ${result.stdout}`);
+    throw new Error(`Could not parse existing VuvoDesk Windows port state: ${result.stdout}`);
   }
   const records = parsed?.Records == null
     ? []
@@ -1834,7 +1834,7 @@ async function terminateExactWindowsPortOwners(records) {
   );
   if (!result.ok) {
     throw new Error(
-      `Could not stop exact LiveDesk Windows port owner tree: `
+      `Could not stop exact VuvoDesk Windows port owner tree: `
       + `${result.stderr || result.error?.message || 'PowerShell failed'}`
     );
   }
@@ -1874,7 +1874,7 @@ async function stopWindowsProcessesOnPorts(ports) {
     const summary = [...stoppedOwners.values()]
       .map(record => `${record.Pid}:${record.ProcessName || 'node'}`)
       .join(', ');
-    console.log(`Restarting LiveDesk Hub. Stopped stale LiveDesk owner(s) once: ${summary}`);
+    console.log(`Restarting VuvoDesk Hub. Stopped stale VuvoDesk owner(s) once: ${summary}`);
   }
   assertPortCleanupReady(finalRecords, portStates);
 }
@@ -1950,7 +1950,7 @@ async function stopUnixProcessesOnPorts(ports) {
       if (!stoppedOwners.has(String(record.Pid))) stoppedOwners.set(String(record.Pid), record);
     }
     const summary = [...stoppedOwners.values()].map(record => `${record.Pid}:${record.ProcessName || 'node'}`).join(', ');
-    console.log(`Restarting LiveDesk Hub. Stopped stale LiveDesk owner(s) once: ${summary}`);
+    console.log(`Restarting VuvoDesk Hub. Stopped stale VuvoDesk owner(s) once: ${summary}`);
   }
   assertPortCleanupReady(finalRecords, portStates);
 }
@@ -1993,7 +1993,7 @@ async function stopStaleClientAgents() {
       );
       if (!result.ok && !result.stdout) {
         throw new Error(
-          `LiveDesk Client lifecycle audit could not enumerate Windows Agent processes: `
+          `VuvoDesk Client lifecycle audit could not enumerate Windows Agent processes: `
           + `${result.stderr || result.error?.message || 'CIM query failed'}`
         );
       }
@@ -2002,7 +2002,7 @@ async function stopStaleClientAgents() {
 
     // One complete ps snapshot avoids treating pgrep execution errors as
     // "nothing is running". The strict identity classifier below decides
-    // whether each textual candidate is really a packaged LiveDesk process.
+    // whether each textual candidate is really a packaged VuvoDesk process.
     const result = await runQuiet(
       'ps',
       ['-axo', 'pid=,args='],
@@ -2010,7 +2010,7 @@ async function stopStaleClientAgents() {
     );
     if (!result.ok && !result.stdout) {
       throw new Error(
-        `LiveDesk Client lifecycle audit could not enumerate Unix processes: `
+        `VuvoDesk Client lifecycle audit could not enumerate Unix processes: `
         + `${result.stderr || result.error?.message || 'ps failed'}`
       );
     }
@@ -2039,7 +2039,7 @@ async function stopStaleClientAgents() {
       if (!details) {
         if (isPidAlive(pid)) {
           throw new Error(
-            `LiveDesk Client lifecycle audit could not establish the identity of candidate pid=${pid}; `
+            `VuvoDesk Client lifecycle audit could not establish the identity of candidate pid=${pid}; `
             + 'startup was preserved instead of signaling an unknown process.'
           );
         }
@@ -2051,7 +2051,7 @@ async function stopStaleClientAgents() {
       const instanceMarker = processInstanceMarker(details);
       if (!instanceMarker) {
         throw new Error(
-          `LiveDesk Client lifecycle audit could not establish a start marker for verified ${type} pid=${pid}.`
+          `VuvoDesk Client lifecycle audit could not establish a start marker for verified ${type} pid=${pid}.`
         );
       }
       found.push({
@@ -2189,7 +2189,7 @@ async function stopStaleClientAgents() {
   const remainingProcesses = await findStaleProcesses();
   if (remainingProcesses.length > 0) {
     throw new Error(
-      'LiveDesk Client startup was stopped because new stale capture processes appeared during cleanup: '
+      'VuvoDesk Client startup was stopped because new stale capture processes appeared during cleanup: '
       + remainingProcesses.map(record => `${record.type} pid=${record.pid}`).join('; ')
     );
   }
@@ -2197,14 +2197,14 @@ async function stopStaleClientAgents() {
   const staleProcesses = [...stoppedProcesses.values()];
   if (staleProcesses.length === 0) {
     if (process.env.LIVEDESK_DEBUG === '1') {
-      console.log('[LiveDesk] Client lifecycle audit: verified stale agents=0 capture-helpers=0.');
+      console.log('[VuvoDesk] Client lifecycle audit: verified stale agents=0 capture-helpers=0.');
     }
     return;
   }
   const agentPids = staleProcesses.filter(item => item.type === 'agent').map(item => item.pid);
   const helperPids = staleProcesses.filter(item => item.type === 'capture-helper').map(item => item.pid);
   console.log(
-    `[LiveDesk] Client lifecycle audit: verified stale agents=${agentPids.length} `
+    `[VuvoDesk] Client lifecycle audit: verified stale agents=${agentPids.length} `
     + `capture-helpers=${helperPids.length}; confirmed stopped pids=${staleProcesses.map(item => item.pid).join(', ')}.`
   );
 }
@@ -2320,7 +2320,7 @@ function buildHubRestartBootstrapScript() {
     'const captureExactWindowsTrees = (identities, snapshot) => { const currentByPid = new Map(snapshot.map(item => [item.pid, item])); const childrenByParent = new Map(); for (const item of snapshot) { if (!childrenByParent.has(item.parentPid)) childrenByParent.set(item.parentPid, []); childrenByParent.get(item.parentPid).push(item); } const tracked = new Map(); for (const root of identities) { const currentRoot = currentByPid.get(Number(root?.pid || 0)); if (!sameWindowsIdentity(currentRoot, root)) continue; const queue = [{ record: currentRoot, depth: 0 }]; const seen = new Set(); while (queue.length > 0) { const current = queue.shift(); if (seen.has(current.record.pid)) continue; seen.add(current.record.pid); const key = `${current.record.pid}:${current.record.startOrder}`; const previous = tracked.get(key); if (!previous || current.depth > previous.depth) tracked.set(key, { ...current.record, depth: current.depth }); for (const child of childrenByParent.get(current.record.pid) || []) { try { if (BigInt(child.startOrder) < BigInt(current.record.startOrder)) continue; } catch { continue; } queue.push({ record: child, depth: current.depth + 1 }); } } } return [...tracked.values()].sort((left, right) => Number(right.depth || 0) - Number(left.depth || 0)); };',
     'const stopExactWindowsRecords = async records => { if (!Array.isArray(records) || records.length === 0) return; const encoded = Buffer.from(JSON.stringify(records.map(record => ({ pid: record.pid, startOrder: record.startOrder }))), "utf8").toString("base64"); const script = `$ErrorActionPreference = "Stop"; $targetsJson = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String("${encoded}")); $targets = ConvertFrom-Json -InputObject $targetsJson; $failures = [System.Collections.Generic.List[string]]::new(); foreach ($item in $targets) { $targetPid = [int]$item.pid; $expectedStartTicks = [string]$item.startOrder; try { $target = Get-CimInstance Win32_Process -Filter "ProcessId = $targetPid" -Property ProcessId,CreationDate -ErrorAction SilentlyContinue | Select-Object -First 1; if (-not $target) { continue }; $targetStartTicks = if ($target.CreationDate) { [string]$target.CreationDate.ToUniversalTime().Ticks } else { "" }; if ($targetStartTicks -ne $expectedStartTicks) { continue }; Stop-Process -Id $targetPid -Force -ErrorAction Stop } catch { $failures.Add("pid=$targetPid $($_.Exception.Message)") } }; if ($failures.Count -gt 0) { [Console]::Error.WriteLine(($failures -join "; ")); exit 1 }`; await runWindowsPowerShell(script); };',
     'const terminateExactWindowsOwnedTrees = async (identities, { skipStop = false } = {}) => { const roots = (Array.isArray(identities) ? identities : []).filter(identity => Number(identity?.pid || 0) > 1 && /^\\d+$/.test(String(identity?.startOrder || ""))); if (roots.length === 0) throw new Error("No immutable Windows replacement identity is available"); const snapshot = await queryWindowsProcessTable(); const targets = captureExactWindowsTrees(roots, snapshot); if (!skipStop) await stopExactWindowsRecords(targets); const finalSnapshot = await queryWindowsProcessTable(); const currentByPid = new Map(finalSnapshot.map(item => [item.pid, item])); const remaining = targets.filter(target => sameWindowsIdentity(currentByPid.get(target.pid), target)); if (remaining.length > 0) throw new Error(`${skipStop ? "simulated exact stop no-op; " : ""}exact pid(s) still alive: ${remaining.map(item => item.pid).join(", ")}`); };',
-    'const waitForExit = async (pid, timeoutMs) => { const deadline = Date.now() + timeoutMs; while (pid > 1 && Date.now() < deadline) { if (!isAlive(pid)) return; await sleep(250); } if (pid > 1 && isAlive(pid)) throw new Error(`Previous LiveDesk Hub launcher pid=${pid} did not exit within ${timeoutMs}ms.`); };',
+    'const waitForExit = async (pid, timeoutMs) => { const deadline = Date.now() + timeoutMs; while (pid > 1 && Date.now() < deadline) { if (!isAlive(pid)) return; await sleep(250); } if (pid > 1 && isAlive(pid)) throw new Error(`Previous VuvoDesk Hub launcher pid=${pid} did not exit within ${timeoutMs}ms.`); };',
     'const decodeArgs = name => JSON.parse(Buffer.from(process.env[name] || "", "base64").toString("utf8"));',
     'const primary = { command: process.env.LIVEDESK_RESTART_COMMAND || "", args: decodeArgs("LIVEDESK_RESTART_ARGS_BASE64") };',
     'const fallback = { command: process.env.LIVEDESK_RESTART_FALLBACK_COMMAND || "", args: decodeArgs("LIVEDESK_RESTART_FALLBACK_ARGS_BASE64") };',
@@ -2336,7 +2336,7 @@ function buildHubRestartBootstrapScript() {
     'const healthTimeoutMs = terminationFailureOperationId === operationId ? numberFromEnv("LIVEDESK_TEST_HUB_RESTART_TERMINATION_HEALTH_TIMEOUT_MS", 1000, 250) : configuredHealthTimeoutMs;',
     'const pollMs = numberFromEnv("LIVEDESK_RESTART_HEALTH_POLL_MS", 250, 50);',
     'const stabilityMs = numberFromEnv("LIVEDESK_RESTART_STABILITY_MS", 5000, 5000);',
-    'const prepareNeutralCwd = () => { if (!neutralCwd) throw new Error("LiveDesk Hub update neutral working directory is unavailable"); mkdirSync(neutralCwd, { recursive: true }); const unexpectedEntry = readdirSync(neutralCwd)[0]; if (unexpectedEntry) { const shadow = join(neutralCwd, unexpectedEntry); throw new Error(`LiveDesk Hub update neutral working directory is shadowed by ${shadow}: ${neutralCwd}`); } };',
+    'const prepareNeutralCwd = () => { if (!neutralCwd) throw new Error("VuvoDesk Hub update neutral working directory is unavailable"); mkdirSync(neutralCwd, { recursive: true }); const unexpectedEntry = readdirSync(neutralCwd)[0]; if (unexpectedEntry) { const shadow = join(neutralCwd, unexpectedEntry); throw new Error(`VuvoDesk Hub update neutral working directory is shadowed by ${shadow}: ${neutralCwd}`); } };',
     'const buildLaunchEnv = () => { const env = { ...process.env }; const isolated = new Set(["init_cwd", "npm_config_local_prefix", "npm_config_workspace", "npm_config_workspaces", "npm_config_include_workspace_root", "npm_package_json", "npm_lifecycle_event", "npm_lifecycle_script"]); for (const key of Object.keys(env)) if (isolated.has(key.toLowerCase())) delete env[key]; env.INIT_CWD = neutralCwd; env.npm_config_local_prefix = neutralCwd; env.npm_config_workspaces = "false"; env.npm_config_include_workspace_root = "false"; return env; };',
     'const requestJson = async path => { const response = await fetch(new URL(path, healthBaseUrl), { cache: "no-store", signal: AbortSignal.timeout(Math.min(2000, healthTimeoutMs)) }); if (!response.ok) throw new Error(`HTTP ${response.status} from ${path}`); return response.json(); };',
     'const probeRemotePort = () => new Promise((resolve, reject) => { const socket = net.createConnection({ host: remoteHost, port: remotePort }); const timer = setTimeout(() => socket.destroy(new Error("TCP probe timed out")), Math.min(1500, healthTimeoutMs)); timer.unref?.(); socket.once("connect", () => { clearTimeout(timer); socket.destroy(); resolve(); }); socket.once("error", error => { clearTimeout(timer); reject(error); }); });',
@@ -2447,7 +2447,7 @@ function buildHubRestartBootstrapScript() {
     '  await terminateTree(child, lastRuntimePid);',
     '  throw new Error(`${label} attempt=${attempt} did not remain healthy for ${stabilityMs}ms: ${lastError?.message || (exit ? `command exited code=${exit.code ?? "none"} signal=${exit.signal || "none"}` : "health deadline expired")}`);',
     '};',
-    '(async () => { const targetErrors = []; const fallbackErrors = []; if (exitBeforeHandshakeOperationId === operationId) { log("stage=test-exit-before-handshake"); process.exitCode = 86; return; } if (delayHandshakeOperationId === operationId) { const claimDelayMs = numberFromEnv("LIVEDESK_TEST_HUB_RESTART_HANDSHAKE_DELAY_MS", 2000, 1); log(`stage=test-delay-before-handshake delayMs=${claimDelayMs}`); await sleep(claimDelayMs); } writeResult("waiting-for-old-launcher", { outcome: "in-progress" }); log(`stage=waiting-for-old-launcher pid=${waitPid} supervisorPid=${process.pid}`); if (exitAfterHandshakeOperationId === operationId) { log("stage=test-exit-after-handshake"); process.exitCode = 87; return; } await waitForExit(waitPid, 60000); writeResult("old-launcher-exited", { outcome: "in-progress" }); log("stage=old-launcher-exited"); for (let attempt = 1; attempt <= attemptLimit; attempt += 1) { writeResult("target-attempt", { outcome: "in-progress", attempt }); try { const status = await launchAndVerify(primary, "target", expectedVersion, attempt); writeResult("updated", { outcome: "updated", attempt, runtimePid: status.runtimePid, launcherPid: status.launcherPid, appVersion: status.appVersion, completedAt: new Date().toISOString(), error: undefined }); log("stage=completed"); return; } catch (error) { if (["LIVEDESK_HUB_UPDATE_SUPERSEDED", "LIVEDESK_HUB_RESTART_TERMINATION_FAILED"].includes(error?.code)) throw error; targetErrors.push(error.message); writeResult("target-failed", { outcome: "in-progress", attempt, error: error.message }); log(`target attempt=${attempt} stage=failed error=${error.message}`); } } log(`stage=fallback-start target=${fallbackVersion || "current"}`); for (let attempt = 1; attempt <= 2; attempt += 1) { writeResult("fallback-attempt", { outcome: "in-progress", attempt, error: targetErrors.join(" | ") }); try { const status = await launchAndVerify(fallback, "fallback", fallbackVersion, attempt); writeResult("restored", { outcome: "restored", attempt, runtimePid: status.runtimePid, launcherPid: status.launcherPid, appVersion: status.appVersion, completedAt: new Date().toISOString(), error: `Target Hub ${expectedVersion} failed verification: ${targetErrors.join(" | ")}` }); log("stage=completed-with-fallback"); return; } catch (error) { if (["LIVEDESK_HUB_UPDATE_SUPERSEDED", "LIVEDESK_HUB_RESTART_TERMINATION_FAILED"].includes(error?.code)) throw error; fallbackErrors.push(error.message); writeResult("fallback-failed", { outcome: "in-progress", attempt, error: [...targetErrors, ...fallbackErrors].join(" | ") }); log(`fallback attempt=${attempt} stage=failed error=${error.message}`); } } throw new Error(`No verified LiveDesk Hub replacement could be started. Target failures: ${targetErrors.join(" | ") || "none"}. Fallback failures: ${fallbackErrors.join(" | ") || "none"}. Inspect ${logPath || "the Hub restart log"} and start the frozen local LiveDesk Hub manually.`); })().catch(error => { if (error?.code === "LIVEDESK_HUB_UPDATE_SUPERSEDED") { log("stage=bootstrap-superseded error=" + error.message); return; } try { writeResult("failed", { outcome: "failed", completedAt: new Date().toISOString(), error: error.message }); } catch (writeError) { log("stage=result-write-failed resultStage=failed error=" + writeError.message); } log("stage=bootstrap-failed error=" + error.message); process.exitCode = 1; });',
+    '(async () => { const targetErrors = []; const fallbackErrors = []; if (exitBeforeHandshakeOperationId === operationId) { log("stage=test-exit-before-handshake"); process.exitCode = 86; return; } if (delayHandshakeOperationId === operationId) { const claimDelayMs = numberFromEnv("LIVEDESK_TEST_HUB_RESTART_HANDSHAKE_DELAY_MS", 2000, 1); log(`stage=test-delay-before-handshake delayMs=${claimDelayMs}`); await sleep(claimDelayMs); } writeResult("waiting-for-old-launcher", { outcome: "in-progress" }); log(`stage=waiting-for-old-launcher pid=${waitPid} supervisorPid=${process.pid}`); if (exitAfterHandshakeOperationId === operationId) { log("stage=test-exit-after-handshake"); process.exitCode = 87; return; } await waitForExit(waitPid, 60000); writeResult("old-launcher-exited", { outcome: "in-progress" }); log("stage=old-launcher-exited"); for (let attempt = 1; attempt <= attemptLimit; attempt += 1) { writeResult("target-attempt", { outcome: "in-progress", attempt }); try { const status = await launchAndVerify(primary, "target", expectedVersion, attempt); writeResult("updated", { outcome: "updated", attempt, runtimePid: status.runtimePid, launcherPid: status.launcherPid, appVersion: status.appVersion, completedAt: new Date().toISOString(), error: undefined }); log("stage=completed"); return; } catch (error) { if (["LIVEDESK_HUB_UPDATE_SUPERSEDED", "LIVEDESK_HUB_RESTART_TERMINATION_FAILED"].includes(error?.code)) throw error; targetErrors.push(error.message); writeResult("target-failed", { outcome: "in-progress", attempt, error: error.message }); log(`target attempt=${attempt} stage=failed error=${error.message}`); } } log(`stage=fallback-start target=${fallbackVersion || "current"}`); for (let attempt = 1; attempt <= 2; attempt += 1) { writeResult("fallback-attempt", { outcome: "in-progress", attempt, error: targetErrors.join(" | ") }); try { const status = await launchAndVerify(fallback, "fallback", fallbackVersion, attempt); writeResult("restored", { outcome: "restored", attempt, runtimePid: status.runtimePid, launcherPid: status.launcherPid, appVersion: status.appVersion, completedAt: new Date().toISOString(), error: `Target Hub ${expectedVersion} failed verification: ${targetErrors.join(" | ")}` }); log("stage=completed-with-fallback"); return; } catch (error) { if (["LIVEDESK_HUB_UPDATE_SUPERSEDED", "LIVEDESK_HUB_RESTART_TERMINATION_FAILED"].includes(error?.code)) throw error; fallbackErrors.push(error.message); writeResult("fallback-failed", { outcome: "in-progress", attempt, error: [...targetErrors, ...fallbackErrors].join(" | ") }); log(`fallback attempt=${attempt} stage=failed error=${error.message}`); } } throw new Error(`No verified VuvoDesk Hub replacement could be started. Target failures: ${targetErrors.join(" | ") || "none"}. Fallback failures: ${fallbackErrors.join(" | ") || "none"}. Inspect ${logPath || "the Hub restart log"} and start the frozen local VuvoDesk Hub manually.`); })().catch(error => { if (error?.code === "LIVEDESK_HUB_UPDATE_SUPERSEDED") { log("stage=bootstrap-superseded error=" + error.message); return; } try { writeResult("failed", { outcome: "failed", completedAt: new Date().toISOString(), error: error.message }); } catch (writeError) { log("stage=result-write-failed resultStage=failed error=" + writeError.message); } log("stage=bootstrap-failed error=" + error.message); process.exitCode = 1; });',
     ''
   ].join('\n');
 }
@@ -2524,7 +2524,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     hubLogStream.on('error', () => {
       hubLogStream = null;
     });
-    hubLogStream.write(`\n--- LiveDesk Hub ${readVersion()} pid=${process.pid} started ${new Date().toISOString()} debug=${debugConsole} ---\n`);
+    hubLogStream.write(`\n--- VuvoDesk Hub ${readVersion()} pid=${process.pid} started ${new Date().toISOString()} debug=${debugConsole} ---\n`);
   } catch {
     // Console output remains available when the optional diagnostic log cannot be written.
   }
@@ -2570,7 +2570,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     });
   } catch (error) {
     reportLauncherUpdate(
-      `[LiveDesk Hub] Self Agent is unavailable: ${error?.message || error}. Remote Clients remain available.`,
+      `[VuvoDesk Hub] Self Agent is unavailable: ${error?.message || error}. Remote Clients remain available.`,
       true
     );
   }
@@ -2618,7 +2618,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       return;
     }
     reportLauncherUpdate(
-      `[LiveDesk Hub] Launcher received ${signal}; requesting graceful Hub shutdown for pid=${child.pid || 'unknown'}.`
+      `[VuvoDesk Hub] Launcher received ${signal}; requesting graceful Hub shutdown for pid=${child.pid || 'unknown'}.`
     );
     void (async () => {
       const gracefulDeadline = Date.now() + 2_000;
@@ -2633,7 +2633,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           });
           if (!response.ok) throw new Error(`HTTP ${response.status}`);
           reportLauncherUpdate(
-            `[LiveDesk Hub] Owned Hub pid=${child.pid || 'unknown'} acknowledged graceful shutdown.`
+            `[VuvoDesk Hub] Owned Hub pid=${child.pid || 'unknown'} acknowledged graceful shutdown.`
           );
           return;
         } catch (error) {
@@ -2643,7 +2643,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       }
       if (child.exitCode !== null || child.signalCode) return;
       reportLauncherUpdate(
-        `[LiveDesk Hub] Graceful shutdown API remained unavailable for pid=${child.pid || 'unknown'}`
+        `[VuvoDesk Hub] Graceful shutdown API remained unavailable for pid=${child.pid || 'unknown'}`
         + `${lastError?.message ? ` (${lastError.message})` : ''}; exact child fallback remains armed.`,
         true
       );
@@ -2654,7 +2654,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     launcherShutdownHardStopTimer = setTimeout(() => {
       if (child.exitCode !== null || child.signalCode) return;
       reportLauncherUpdate(
-        `[LiveDesk Hub] Owned Hub pid=${child.pid || 'unknown'} exceeded graceful shutdown; `
+        `[VuvoDesk Hub] Owned Hub pid=${child.pid || 'unknown'} exceeded graceful shutdown; `
         + 'force-stopping that exact child root.',
         true
       );
@@ -2671,7 +2671,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
 
   const restartWithLatest = async request => {
     if (!updateHost?.available) {
-      throw new Error('The independent LiveDesk Update Host is unavailable. The unchanged Hub remains running.');
+      throw new Error('The independent VuvoDesk Update Host is unavailable. The unchanged Hub remains running.');
     }
     const requestedVersion = normalizeExactUpdateVersion(request?.latestVersion);
     if (!requestedVersion) {
@@ -2726,7 +2726,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
         updatedAt: restartStartedAt
       });
     } catch (error) {
-      reportLauncherUpdate(`[LiveDesk Hub] Could not persist the restart supervisor state: ${error instanceof Error ? error.message : String(error)}.`, true);
+      reportLauncherUpdate(`[VuvoDesk Hub] Could not persist the restart supervisor state: ${error instanceof Error ? error.message : String(error)}.`, true);
       throw error;
     }
     const workerEnvironment = buildUpdateHostWorkerEnvironment(process.env, {
@@ -2767,10 +2767,10 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       }, { timeoutMs: handshakeTimeoutMs });
       hostJob = submitted?.job || null;
       if (!hostJob || Number(hostJob.workerPid || 0) <= 1) {
-        throw new Error('LiveDesk Update Host accepted the request without a worker identity.');
+        throw new Error('VuvoDesk Update Host accepted the request without a worker identity.');
       }
     } catch (error) {
-      throw new Error(`LiveDesk Update Host rejected the Hub replacement: ${error instanceof Error ? error.message : String(error)}`);
+      throw new Error(`VuvoDesk Update Host rejected the Hub replacement: ${error instanceof Error ? error.message : String(error)}`);
     }
     try {
       await waitForHubRestartUpdateHostClaim(updateHost, hostJobId, {
@@ -2801,7 +2801,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       throw error;
     }
     reportLauncherUpdate(
-      `[LiveDesk Hub] Update handoff claimed target=${requestedVersion} `
+      `[VuvoDesk Hub] Update handoff claimed target=${requestedVersion} `
       + `updateHostPid=${updateHost.host?.pid || 0} workerPid=${hostJob.workerPid || 0} operation=${operationId}. `
       + `The current launcher will now exit. Restart diagnostics: ${hubLogPath}`
     );
@@ -2823,14 +2823,14 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       const requestPid = Number(request?.pid || 0);
       const activeChildPid = Number(activeChild?.pid || 0);
       if (!Number.isInteger(requestPid) || requestPid <= 1) {
-        reportLauncherUpdate('[LiveDesk Hub] Ignored an invalid update restart request without a Hub PID.', true);
+        reportLauncherUpdate('[VuvoDesk Hub] Ignored an invalid update restart request without a Hub PID.', true);
       } else if (requestPid !== activeChildPid) {
-        reportLauncherUpdate(`[LiveDesk Hub] Ignored stale update restart request for pid ${requestPid}; active Hub pid is ${activeChildPid || 'unavailable'}.`, true);
+        reportLauncherUpdate(`[VuvoDesk Hub] Ignored stale update restart request for pid ${requestPid}; active Hub pid is ${activeChildPid || 'unavailable'}.`, true);
       } else {
         const operationId = String(request?.operationId || `hub-update-${Date.now()}`).trim();
         const requestedVersion = normalizeExactUpdateVersion(request?.latestVersion);
         const failPreflight = message => {
-          reportLauncherUpdate(`[LiveDesk Hub] ${message}. The current Hub remains running.`, true);
+          reportLauncherUpdate(`[VuvoDesk Hub] ${message}. The current Hub remains running.`, true);
           try {
             const now = new Date().toISOString();
             writeJsonAtomic(hubUpdateResultPath, {
@@ -2847,7 +2847,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
               error: message
             });
           } catch (persistError) {
-            reportLauncherUpdate(`[LiveDesk Hub] Could not persist the update preflight failure: ${persistError instanceof Error ? persistError.message : String(persistError)}.`, true);
+            reportLauncherUpdate(`[VuvoDesk Hub] Could not persist the update preflight failure: ${persistError instanceof Error ? persistError.message : String(persistError)}.`, true);
           }
         };
         if (!requestedVersion) {
@@ -2870,7 +2870,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           _neutralCwd: neutralCwd,
           _originalCwd: UPDATE_ORIGINAL_CWD
         };
-        reportLauncherUpdate(`[LiveDesk Hub] Restart requested for update ${request.operationId || 'unknown'} target=${requestedVersion}.`);
+        reportLauncherUpdate(`[VuvoDesk Hub] Restart requested for update ${request.operationId || 'unknown'} target=${requestedVersion}.`);
         void stopHubSelfAgent('hub-update');
         const updateChild = activeChild;
         let shutdownFallbackStarted = false;
@@ -2878,18 +2878,18 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           if (!updateChild || updateChild.exitCode !== null || updateChild.signalCode) return;
           if (shutdownFallbackStarted) return;
           shutdownFallbackStarted = true;
-          reportLauncherUpdate(`[LiveDesk Hub] Update shutdown fallback: ${reason}; terminating Hub pid=${requestPid}.`, true);
+          reportLauncherUpdate(`[VuvoDesk Hub] Update shutdown fallback: ${reason}; terminating Hub pid=${requestPid}.`, true);
           try { updateChild.kill('SIGTERM'); } catch { /* child already exited */ }
           updateHardStopTimer = setTimeout(() => {
             if (!updateChild || updateChild.exitCode !== null || updateChild.signalCode) return;
-            reportLauncherUpdate(`[LiveDesk Hub] Update shutdown hard fallback: Hub pid=${requestPid} ignored graceful termination; force-stopping the owned Hub process.`, true);
+            reportLauncherUpdate(`[VuvoDesk Hub] Update shutdown hard fallback: Hub pid=${requestPid} ignored graceful termination; force-stopping the owned Hub process.`, true);
             if (process.platform === 'win32') {
               // updateChild is the exact ChildProcess instance spawned by this
               // launcher. Stop only that owned Hub root; never let taskkill /T
               // follow unverified PPID descendants.
               try { updateChild.kill('SIGKILL'); } catch (error) {
                 if (updateChild.exitCode === null && !updateChild.signalCode) {
-                  reportLauncherUpdate(`[LiveDesk Hub] hard-stop fallback failed for pid=${requestPid}: ${error.message}`, true);
+                  reportLauncherUpdate(`[VuvoDesk Hub] hard-stop fallback failed for pid=${requestPid}: ${error.message}`, true);
                 }
               }
             } else {
@@ -2905,7 +2905,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
           signal: AbortSignal.timeout(2_500)
         }).then(response => {
           if (!response.ok) throw new Error(`HTTP ${response.status}`);
-          reportLauncherUpdate(`[LiveDesk Hub] Update shutdown acknowledged by Hub pid=${requestPid}.`);
+          reportLauncherUpdate(`[VuvoDesk Hub] Update shutdown acknowledged by Hub pid=${requestPid}.`);
         }).catch(error => forceStop(`shutdown API failed (${error?.message || error})`));
       }
     } catch {
@@ -2933,7 +2933,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       hubSelfAgent?.start();
     }).catch(error => {
       reportLauncherUpdate(
-        `[LiveDesk Hub] Self Agent startup wait failed: ${error?.message || error}.`,
+        `[VuvoDesk Hub] Self Agent startup wait failed: ${error?.message || error}.`,
         true
       );
     });
@@ -2955,7 +2955,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     });
 
     child.once('error', error => {
-      console.error(`Failed to start LiveDesk Hub: ${error.message}`);
+      console.error(`Failed to start VuvoDesk Hub: ${error.message}`);
       process.exitCode = 1;
     });
     child.once('exit', (code, signal) => {
@@ -2990,7 +2990,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
         }
         void stopHubSelfAgent('hub-update').then(() => restartWithLatest(request)).catch(error => {
           const message = `The Hub restart handoff failed after shutdown: ${error instanceof Error ? error.message : String(error)}`;
-          reportLauncherUpdate(`[LiveDesk Hub] ${message}. Restarting the unchanged Hub.`, true);
+          reportLauncherUpdate(`[VuvoDesk Hub] ${message}. Restarting the unchanged Hub.`, true);
           try {
             const now = new Date().toISOString();
             const previous = readJsonFile(hubUpdateResultPath);
@@ -3033,7 +3033,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
             runtimeLock?.updateRole?.('client');
           } catch (error) {
             console.error(
-              `[LiveDesk Hub] The shared runtime lock could not transition to Client: ${error?.message || error}. `
+              `[VuvoDesk Hub] The shared runtime lock could not transition to Client: ${error?.message || error}. `
               + 'The launcher will exit so a clean invocation can recover.'
             );
             runtimeShutdownWatcher?.stop();
@@ -3049,15 +3049,15 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
             source: 'supabase',
             isOfflineFallback: false
           }, { stateDir: MANAGER_STATE_DIR });
-          console.log('[LiveDesk Hub] Role transition accepted. Starting the Client runtime.');
+          console.log('[VuvoDesk Hub] Role transition accepted. Starting the Client runtime.');
           runtimeShutdownWatcher?.stop();
           removeLauncherSignalHandlers();
           void runClient([], { ...resolvedRole, role: 'client', source: 'supabase', roleTransition: true }, runtimeLock).catch(error => {
-            console.error(`Failed to start LiveDesk Client runtime: ${error?.message || error}`);
+            console.error(`Failed to start VuvoDesk Client runtime: ${error?.message || error}`);
             process.exitCode = 1;
           });
         }).catch(error => {
-          console.error(`[LiveDesk Hub] Self Agent did not stop for role transition: ${error?.message || error}`);
+          console.error(`[VuvoDesk Hub] Self Agent did not stop for role transition: ${error?.message || error}`);
           process.exit(1);
         });
         return;
@@ -3068,7 +3068,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
         && startupRetryCount < HUB_STARTUP_RETRY_LIMIT
         && isPortConflictOutput(startupOutput)) {
         startupRetryCount += 1;
-        console.warn('[LiveDesk Hub] Startup port conflict detected. Cleaning Hub ports and retrying once.');
+        console.warn('[VuvoDesk Hub] Startup port conflict detected. Cleaning Hub ports and retrying once.');
         void stopProcessesOnPorts([httpPort, remotePort])
           .then(() => startHubProcess())
           .catch(error => {
@@ -3092,7 +3092,7 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
 
   runtimeShutdownWatcher = startOwnedRuntimeShutdownWatcher(runtimeOwner, async request => {
     reportLauncherUpdate(
-      `[LiveDesk Hub] Cooperative replacement request accepted `
+      `[VuvoDesk Hub] Cooperative replacement request accepted `
       + `request=${request.requestId} reason=${request.reason}.`
     );
     requestLauncherShutdown('COOPERATIVE_REPLACEMENT');
@@ -3111,15 +3111,15 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
     }
     void transferSavedClientSessionToHub(hubProbeBaseUrl, MANAGER_STATE_DIR).then(handoff => {
       if (handoff.ok) {
-        reportLauncherUpdate('[LiveDesk Hub] Saved Client sign-in adopted by the Hub.');
+        reportLauncherUpdate('[VuvoDesk Hub] Saved Client sign-in adopted by the Hub.');
         if (!handoff.hostTargetOk) {
-          reportLauncherUpdate('[LiveDesk Hub] Sign-in was adopted; host publication will continue through lease renewal.', true);
+          reportLauncherUpdate('[VuvoDesk Hub] Sign-in was adopted; host publication will continue through lease renewal.', true);
         }
       } else if (!handoff.skipped) {
-        reportLauncherUpdate(`[LiveDesk Hub] Saved Client sign-in could not be adopted: ${handoff.reason}. Continue sign-in in the Hub page.`, true);
+        reportLauncherUpdate(`[VuvoDesk Hub] Saved Client sign-in could not be adopted: ${handoff.reason}. Continue sign-in in the Hub page.`, true);
       }
     }).catch(error => {
-      reportLauncherUpdate(`[LiveDesk Hub] Saved Client sign-in could not be adopted: ${error instanceof Error ? error.message : String(error)}. Continue sign-in in the Hub page.`, true);
+      reportLauncherUpdate(`[VuvoDesk Hub] Saved Client sign-in could not be adopted: ${error instanceof Error ? error.message : String(error)}. Continue sign-in in the Hub page.`, true);
     });
     return true;
   });
@@ -3129,15 +3129,16 @@ async function runManager(args, resolvedRole = null, runtimeLock = null, updateH
       if (ok) {
         openBrowser(openUrl);
       } else {
-        console.warn(`LiveDesk Hub did not answer at ${openUrl} yet. Open it manually when it is ready.`);
+        console.warn(`VuvoDesk Hub did not answer at ${openUrl} yet. Open it manually when it is ready.`);
       }
     });
   }
 }
 
-async function runClient(args, resolvedRole = null, runtimeLock = null) {
-  const runtimeOwner = runtimeLock?.payload || null;
-  const internalClientEntry = resolve(packageRoot, 'client', 'bin', 'livedesk-client.js');
+async function runClient(args, resolvedRole = null, runtimeLock = null) {
+  const runtimeOwner = runtimeLock?.payload || null;
+  const internalClientEntry = resolve(packageRoot, 'client', 'bin', 'livedesk-client.js');
+  const packagedWebDist = resolve(packageRoot, 'web', 'dist');
   if (!existsSync(internalClientEntry)) {
     throw new Error('The published livedesk package is missing its internal Client runtime. Rebuild the package with npm run build.');
   }
@@ -3151,7 +3152,9 @@ async function runClient(args, resolvedRole = null, runtimeLock = null) {
     LIVEDESK_NPM_LAUNCHER_VERSION: readVersion(),
     LIVEDESK_RUNTIME_ROLE: 'client',
     LIVEDESK_UNIFIED_RUNTIME: '1',
-    LIVEDESK_WEB_DIST: resolve(packageRoot, 'web', 'dist'),
+    LIVEDESK_WEB_DIST: existsSync(resolve(packagedWebDist, 'index.html'))
+      ? packagedWebDist
+      : String(process.env.LIVEDESK_WEB_DIST || ''),
     LIVEDESK_CLIENT_RUNTIME_PORT: String(process.env.LIVEDESK_CLIENT_RUNTIME_PORT || process.env.LIVEDESK_LOCAL_RUNTIME_PORT || DEFAULT_MANAGER_HTTP_PORT),
     LIVEDESK_UNIFIED_LAUNCHER_ENTRY: String(process.argv[1] || ''),
     LIVEDESK_ROLE_TRANSITION: resolvedRole?.roleTransition === true || process.env.LIVEDESK_ROLE_TRANSITION === '1'
@@ -3177,7 +3180,7 @@ async function runClient(args, resolvedRole = null, runtimeLock = null) {
   }
   const runtimeShutdownWatcher = startOwnedRuntimeShutdownWatcher(runtimeOwner, async request => {
     console.log(
-      `[LiveDesk Client] Cooperative replacement request accepted `
+      `[VuvoDesk Client] Cooperative replacement request accepted `
       + `request=${request.requestId} reason=${request.reason}. Draining the owned capture tree.`
     );
     if (typeof clientModule.requestClientRuntimeShutdown !== 'function') {
@@ -3193,7 +3196,7 @@ async function runClient(args, resolvedRole = null, runtimeLock = null) {
       recoverHubClientPort: async port => {
         const normalizedPort = normalizePort(port, 0);
         if (!normalizedPort) {
-          throw new Error(`LiveDesk cannot recover an invalid Hub client port: ${port}.`);
+          throw new Error(`VuvoDesk cannot recover an invalid Hub client port: ${port}.`);
         }
         await stopProcessesOnPorts([normalizedPort]);
       }
@@ -3217,7 +3220,7 @@ async function runDesktopRoleBootstrap() {
     onShutdown: () => process.exit(0)
   });
   await bootstrap.start();
-  console.log(`[LiveDesk] Role bootstrap is ready at ${bootstrap.url}. Sign in and choose Hub or Client.`);
+  console.log(`[VuvoDesk] Role bootstrap is ready at ${bootstrap.url}. Sign in and choose Hub or Client.`);
   await new Promise(() => undefined);
 }
 
@@ -3253,7 +3256,7 @@ async function main() {
     const commandArgs = args.slice(1).map(value => String(value || '').trim().toLowerCase());
     if (commandArgs.some(value => value === '--help' || value === '-h' || value === 'help')) {
       if (command === 'client') {
-        console.warn('[LiveDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
+        console.warn('[VuvoDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
         printClientHelp();
       } else {
         printHelp();
@@ -3262,7 +3265,7 @@ async function main() {
     }
     if (commandArgs.some(value => value === '--version' || value === '-v' || value === 'version')) {
       if (command === 'client') {
-        console.warn('[LiveDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
+        console.warn('[VuvoDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
       }
       console.log(readVersion());
       return;
@@ -3285,7 +3288,7 @@ async function main() {
     writeRoleCache({ ...resolvedRole, source: 'local-cache', isOfflineFallback: false }, roleStateOptions);
     runtimeArgs = args.slice(1);
     if (command === 'client') {
-      console.warn('[LiveDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
+      console.warn('[VuvoDesk] Legacy client command detected. Use `npx -y --prefer-online livedesk@latest` for automatic role selection.');
     }
   } else {
     const forceDesktopBootstrap = process.env.LIVEDESK_DESKTOP_HOST === '1'
@@ -3298,7 +3301,7 @@ async function main() {
       });
     if (!resolvedRole.role) {
       if (resolvedRole.disabled) {
-        throw new Error(`LiveDesk device ${resolvedRole.deviceId} is disabled for this account.`);
+        throw new Error(`VuvoDesk device ${resolvedRole.deviceId} is disabled for this account.`);
       }
       if (forceDesktopBootstrap) {
         await runDesktopRoleBootstrap();
@@ -3319,7 +3322,7 @@ async function main() {
   }
 
   if (topLevel.noSingleInstance || process.env.LIVEDESK_DISABLE_SINGLE_INSTANCE === '1') {
-    console.warn('[LiveDesk] Single-instance lock disabled for this run.');
+    console.warn('[VuvoDesk] Single-instance lock disabled for this run.');
   }
   const launcherProcessDetails = await getProcessDetails(process.pid);
   const launcherInstanceMarker = processInstanceMarker(launcherProcessDetails);
@@ -3327,7 +3330,7 @@ async function main() {
   const reportExistingRuntime = existing => {
     const port = DEFAULT_MANAGER_HTTP_PORT;
     openBrowser(`http://127.0.0.1:${port}`);
-    console.log(`[LiveDesk] An existing ${existing.role || 'runtime'} is already running (pid ${existing.pid}). Opened its local page. Hub diagnostics: ${join(MANAGER_STATE_DIR, 'hub.log')}`);
+    console.log(`[VuvoDesk] An existing ${existing.role || 'runtime'} is already running (pid ${existing.pid}). Opened its local page. Hub diagnostics: ${join(MANAGER_STATE_DIR, 'hub.log')}`);
   };
   let lock = topLevel.noSingleInstance || process.env.LIVEDESK_DISABLE_SINGLE_INSTANCE === '1'
     ? { acquired: true, release: () => undefined }
@@ -3382,12 +3385,12 @@ async function main() {
   Object.assign(process.env, updateHostEnvironment(updateHost));
   if (updateHost.available) {
     console.log(
-      `[LiveDesk] Independent Update Host ready pid=${updateHost.host?.pid || 'unknown'} `
+      `[VuvoDesk] Independent Update Host ready pid=${updateHost.host?.pid || 'unknown'} `
       + `source=${updateHost.host?.sourceVersion || readVersion()}.`
     );
   } else if (!updateHost.disabled) {
     console.warn(
-      `[LiveDesk] Independent Update Host is unavailable; updates are disabled for this run: `
+      `[VuvoDesk] Independent Update Host is unavailable; updates are disabled for this run: `
       + `${updateHost.error || 'unknown error'}`
     );
   }
@@ -3413,7 +3416,7 @@ async function main() {
         && process.env.LIVEDESK_DEBUG === '1'
         && Number.isFinite(testHoldAfterDrainMs)
         && testHoldAfterDrainMs > 0) {
-      console.log('[LiveDesk test] Holding after reclaimed manifest drain before Agent startup.');
+      console.log('[VuvoDesk test] Holding after reclaimed manifest drain before Agent startup.');
       await waitMilliseconds(Math.min(60_000, Math.round(testHoldAfterDrainMs)));
     }
   }
@@ -3429,7 +3432,7 @@ async function main() {
     if (!explicitMultiInstance) {
       await stopStaleClientAgents();
     } else if (process.env.LIVEDESK_DEBUG === '1') {
-      console.log('[LiveDesk] Client lifecycle audit skipped for explicit multi-instance mode.');
+      console.log('[VuvoDesk] Client lifecycle audit skipped for explicit multi-instance mode.');
     }
   }