copilot-hub 0.1.23 → 0.1.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot-hub",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Copilot Hub CLI and runtime bundle",
   "license": "MIT",
   "repository": {

package/scripts/dist/daemon.mjs

@@ -27,6 +27,7 @@ const nodeBin = process.execPath;
 const agentEngineEnvPath = layout.agentEngineEnvPath;
 const controlPlaneEnvPath = layout.controlPlaneEnvPath;
 const codexInstallCommand = `npm install -g ${codexInstallPackageSpec}`;
+const WINDOWS_BACKGROUND_ENV = "COPILOT_HUB_DAEMON_BACKGROUND";
 const BASE_CHECK_MS = 5000;
 const MAX_BACKOFF_MS = 60000;
 const action = String(process.argv[2] ?? "status")
@@ -62,13 +63,21 @@ async function main() {
     }
 }
 async function startDaemonProcess() {
-    ensureScripts();
-    ensureRuntimeDirs();
     const existingPid = getRunningDaemonPid();
     if (existingPid > 0) {
         console.log(`[daemon] already running (pid ${existingPid})`);
         return;
     }
+    const pid = await spawnDetachedDaemonProcess();
+    console.log(`[daemon] started (pid ${pid})`);
+}
+async function spawnDetachedDaemonProcess() {
+    ensureScripts();
+    ensureRuntimeDirs();
+    const existingPid = getRunningDaemonPid();
+    if (existingPid > 0) {
+        return existingPid;
+    }
     removeDaemonState();
     const logFd = fs.openSync(daemonLogPath, "a");
     let child;
@@ -79,7 +88,10 @@ async function startDaemonProcess() {
             stdio: ["ignore", logFd, logFd],
             windowsHide: true,
             shell: false,
-            env: process.env,
+            env: {
+                ...process.env,
+                [WINDOWS_BACKGROUND_ENV]: "1",
+            },
         });
     }
     finally {
@@ -94,9 +106,13 @@ async function startDaemonProcess() {
     if (ready) {
         throw new Error(`Daemon process exited immediately (pid ${pid}). Check logs: ${daemonLogPath}`);
     }
-    console.log(`[daemon] started (pid ${pid})`);
+    return pid;
 }
 async function runDaemonLoop() {
+    if (shouldDetachInteractiveWindowsDaemon()) {
+        await spawnDetachedDaemonProcess();
+        return;
+    }
     ensureScripts();
     ensureRuntimeDirs();
     const existingPid = getRunningDaemonPid();
@@ -465,6 +481,18 @@ function shouldPauseBeforeExit() {
     }
     return true;
 }
+function shouldDetachInteractiveWindowsDaemon() {
+    if (process.platform !== "win32") {
+        return false;
+    }
+    if (String(process.env[WINDOWS_BACKGROUND_ENV] ?? "").trim() === "1") {
+        return false;
+    }
+    if (!process.stdin || !process.stdout) {
+        return false;
+    }
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
 function detectFatalStartupError(ensureResult) {
     const evidenceChunks = [
         String(ensureResult?.combinedOutput ?? ""),

package/scripts/dist/service.mjs

@@ -7,6 +7,7 @@ import process from "node:process";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { initializeCopilotHubLayout, resolveCopilotHubLayout } from "./install-layout.mjs";
+import { buildWindowsHiddenLauncherCommand, ensureWindowsHiddenLauncher, getWindowsHiddenLauncherScriptPath, resolveWindowsScriptHost, } from "./windows-hidden-launcher.mjs";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const repoRoot = path.resolve(__dirname, "..", "..");
@@ -14,6 +15,7 @@ const layout = resolveCopilotHubLayout({ repoRoot });
 initializeCopilotHubLayout({ repoRoot, layout });
 const nodeBin = process.execPath;
 const daemonScriptPath = path.join(repoRoot, "scripts", "dist", "daemon.mjs");
+const windowsLauncherScriptPath = getWindowsHiddenLauncherScriptPath(layout.runtimeDir);
 const WINDOWS_TASK_NAME = "CopilotHub";
 const WINDOWS_RUN_KEY_PATH = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
 const WINDOWS_RUN_VALUE_NAME = "CopilotHub";
@@ -117,7 +119,13 @@ async function showStatus() {
 }
 async function startService() {
     if (process.platform === "win32") {
-        startWindowsAutoStart();
+        const mode = startWindowsAutoStart();
+        if (mode === "run-key") {
+            console.log("Service started in background (Windows startup registry entry).");
+        }
+        else {
+            console.log("Service started in background (Windows Task Scheduler).");
+        }
         return;
     }
     if (process.platform === "linux") {
@@ -160,7 +168,7 @@ function installWindowsAutoStart() {
         throw new Error(taskCreate.combinedOutput || "Failed to create Windows auto-start task.");
     }
     installWindowsRunKey(command);
-    runDaemon("start");
+    runWindowsHiddenLauncher();
     return "run-key";
 }
 function uninstallWindowsAutoStart() {
@@ -185,6 +193,9 @@ function uninstallWindowsAutoStart() {
     else if (!isRegistryValueNotFoundMessage(runKeyDelete.combinedOutput)) {
         throw new Error(runKeyDelete.combinedOutput || "Failed to remove Windows startup registry entry.");
     }
+    if (fs.existsSync(windowsLauncherScriptPath)) {
+        fs.rmSync(windowsLauncherScriptPath, { force: true });
+    }
     return removed;
 }
 function showWindowsAutoStartStatus() {
@@ -219,12 +230,20 @@ function runWindowsTask() {
     }
 }
 function startWindowsAutoStart() {
+    const command = buildWindowsLaunchCommand();
     const runKey = queryWindowsRunKey();
     if (runKey.installed) {
-        runDaemon("start");
-        return;
+        installWindowsRunKey(command);
+        runWindowsHiddenLauncher();
+        return "run-key";
+    }
+    const task = queryWindowsTask();
+    if (!task.installed) {
+        throw new Error("Service is not installed. Run 'copilot-hub service install' first.");
     }
+    ensureTaskSchedulerAutoStart(command);
     runWindowsTask();
+    return "task";
 }
 function queryWindowsRunKey() {
     const result = runChecked("reg", ["query", WINDOWS_RUN_KEY_PATH, "/v", WINDOWS_RUN_VALUE_NAME], {
@@ -238,6 +257,18 @@ function queryWindowsRunKey() {
     }
     throw new Error(result.combinedOutput || "Failed to query Windows startup registry entry.");
 }
+function queryWindowsTask() {
+    const result = runChecked("schtasks", ["/Query", "/TN", WINDOWS_TASK_NAME], {
+        allowFailure: true,
+    });
+    if (result.ok) {
+        return { installed: true };
+    }
+    if (isNotFoundMessage(result.combinedOutput)) {
+        return { installed: false };
+    }
+    throw new Error(result.combinedOutput || "Failed to query Windows auto-start task.");
+}
 function installWindowsRunKey(command) {
     runChecked("reg", [
         "add",
@@ -251,6 +282,16 @@ function installWindowsRunKey(command) {
         "/f",
     ], { stdio: "pipe" });
 }
+function ensureTaskSchedulerAutoStart(command) {
+    const result = runChecked("schtasks", ["/Create", "/TN", WINDOWS_TASK_NAME, "/SC", "ONLOGON", "/RL", "LIMITED", "/F", "/TR", command], { allowFailure: true });
+    if (result.ok) {
+        return;
+    }
+    if (isNotFoundMessage(result.combinedOutput)) {
+        throw new Error("Service is not installed. Run 'copilot-hub service install' first.");
+    }
+    throw new Error(result.combinedOutput || "Failed to update Windows auto-start task.");
+}
 function installLinuxService() {
     ensureSystemctl();
     const unitPath = getLinuxUnitPath();
@@ -413,6 +454,19 @@ function ensureDaemonScript() {
         ].join("\n"));
     }
 }
+function runWindowsHiddenLauncher() {
+    const launcherScriptPath = ensureWindowsLauncherScript();
+    const scriptHost = resolveWindowsScriptHost(process.env);
+    if (!fs.existsSync(scriptHost)) {
+        throw new Error("Windows Script Host is not available.");
+    }
+    const result = runChecked(scriptHost, ["//B", "//Nologo", launcherScriptPath], {
+        allowFailure: true,
+    });
+    if (!result.ok) {
+        throw new Error(result.combinedOutput || "Failed to launch hidden Windows service starter.");
+    }
+}
 function ensureSystemctl() {
     ensureCommandAvailable("systemctl", ["--version"], "systemd is not available. This command requires Linux with systemd user services.");
 }
@@ -517,7 +571,17 @@ function getErrorMessage(error) {
     return String(error ?? "Unknown error.");
 }
 function buildWindowsLaunchCommand() {
-    return `"${nodeBin}" "${daemonScriptPath}" run`;
+    const launcherScriptPath = ensureWindowsLauncherScript();
+    return buildWindowsHiddenLauncherCommand(launcherScriptPath, process.env);
+}
+function ensureWindowsLauncherScript() {
+    ensureDaemonScript();
+    return ensureWindowsHiddenLauncher({
+        scriptPath: windowsLauncherScriptPath,
+        nodeBin,
+        daemonScriptPath,
+        runtimeDir: layout.runtimeDir,
+    });
 }
 function escapeXml(value) {
     return String(value ?? "")

package/scripts/dist/windows-hidden-launcher.mjs

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+export function resolveWindowsScriptHost(env = process.env) {
+    const systemRoot = String(env.SystemRoot ?? env.SYSTEMROOT ?? "C:\\Windows").trim();
+    const baseDir = systemRoot || "C:\\Windows";
+    return path.win32.join(baseDir, "System32", "wscript.exe");
+}
+export function getWindowsHiddenLauncherScriptPath(runtimeDir) {
+    return path.win32.join(runtimeDir, "windows-daemon-launcher.vbs");
+}
+export function ensureWindowsHiddenLauncher({ scriptPath, nodeBin, daemonScriptPath, runtimeDir, }) {
+    const content = buildWindowsHiddenLauncherContent({
+        nodeBin,
+        daemonScriptPath,
+        runtimeDir,
+    });
+    let current = "";
+    try {
+        current = fs.readFileSync(scriptPath, "utf8");
+    }
+    catch {
+        current = "";
+    }
+    if (current !== content) {
+        fs.mkdirSync(path.dirname(scriptPath), { recursive: true });
+        fs.writeFileSync(scriptPath, content, "utf8");
+    }
+    return scriptPath;
+}
+export function buildWindowsHiddenLauncherCommand(scriptPath, env = process.env) {
+    const scriptHost = resolveWindowsScriptHost(env);
+    return `"${scriptHost}" //B //Nologo "${scriptPath}"`;
+}
+export function buildWindowsHiddenLauncherContent({ nodeBin, daemonScriptPath, runtimeDir, }) {
+    const command = buildWindowsCommandLine([nodeBin, daemonScriptPath, "start"]);
+    return [
+        "Option Explicit",
+        "Dim shell",
+        'Set shell = CreateObject("WScript.Shell")',
+        `shell.CurrentDirectory = "${escapeVbsString(runtimeDir)}"`,
+        `shell.Run "${escapeVbsString(command)}", 0, False`,
+        "Set shell = Nothing",
+        "",
+    ].join("\r\n");
+}
+function buildWindowsCommandLine(args) {
+    return args.map((value) => `"${String(value ?? "")}"`).join(" ");
+}
+function escapeVbsString(value) {
+    return String(value ?? "").replace(/"/g, '""');
+}

package/scripts/src/daemon.mts

@@ -35,6 +35,7 @@ const nodeBin = process.execPath;
 const agentEngineEnvPath = layout.agentEngineEnvPath;
 const controlPlaneEnvPath = layout.controlPlaneEnvPath;
 const codexInstallCommand = `npm install -g ${codexInstallPackageSpec}`;
+const WINDOWS_BACKGROUND_ENV = "COPILOT_HUB_DAEMON_BACKGROUND";
 
 const BASE_CHECK_MS = 5000;
 const MAX_BACKOFF_MS = 60000;
@@ -74,13 +75,23 @@ async function main() {
 }
 
 async function startDaemonProcess() {
+  const existingPid = getRunningDaemonPid();
+  if (existingPid > 0) {
+    console.log(`[daemon] already running (pid ${existingPid})`);
+    return;
+  }
+
+  const pid = await spawnDetachedDaemonProcess();
+  console.log(`[daemon] started (pid ${pid})`);
+}
+
+async function spawnDetachedDaemonProcess() {
   ensureScripts();
   ensureRuntimeDirs();
 
   const existingPid = getRunningDaemonPid();
   if (existingPid > 0) {
-    console.log(`[daemon] already running (pid ${existingPid})`);
-    return;
+    return existingPid;
   }
 
   removeDaemonState();
@@ -94,7 +105,10 @@ async function startDaemonProcess() {
       stdio: ["ignore", logFd, logFd],
       windowsHide: true,
       shell: false,
-      env: process.env,
+      env: {
+        ...process.env,
+        [WINDOWS_BACKGROUND_ENV]: "1",
+      },
     });
   } finally {
     fs.closeSync(logFd);
@@ -111,10 +125,15 @@ async function startDaemonProcess() {
     throw new Error(`Daemon process exited immediately (pid ${pid}). Check logs: ${daemonLogPath}`);
   }
 
-  console.log(`[daemon] started (pid ${pid})`);
+  return pid;
 }
 
 async function runDaemonLoop() {
+  if (shouldDetachInteractiveWindowsDaemon()) {
+    await spawnDetachedDaemonProcess();
+    return;
+  }
+
   ensureScripts();
   ensureRuntimeDirs();
 
@@ -545,6 +564,22 @@ function shouldPauseBeforeExit() {
   return true;
 }
 
+function shouldDetachInteractiveWindowsDaemon() {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  if (String(process.env[WINDOWS_BACKGROUND_ENV] ?? "").trim() === "1") {
+    return false;
+  }
+
+  if (!process.stdin || !process.stdout) {
+    return false;
+  }
+
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
 function detectFatalStartupError(ensureResult) {
   const evidenceChunks = [
     String(ensureResult?.combinedOutput ?? ""),

package/scripts/src/service.mts

@@ -7,6 +7,12 @@ import process from "node:process";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { initializeCopilotHubLayout, resolveCopilotHubLayout } from "./install-layout.mjs";
+import {
+  buildWindowsHiddenLauncherCommand,
+  ensureWindowsHiddenLauncher,
+  getWindowsHiddenLauncherScriptPath,
+  resolveWindowsScriptHost,
+} from "./windows-hidden-launcher.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -15,6 +21,7 @@ const layout = resolveCopilotHubLayout({ repoRoot });
 initializeCopilotHubLayout({ repoRoot, layout });
 const nodeBin = process.execPath;
 const daemonScriptPath = path.join(repoRoot, "scripts", "dist", "daemon.mjs");
+const windowsLauncherScriptPath = getWindowsHiddenLauncherScriptPath(layout.runtimeDir);
 
 const WINDOWS_TASK_NAME = "CopilotHub";
 const WINDOWS_RUN_KEY_PATH = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
@@ -134,7 +141,12 @@ async function showStatus() {
 
 async function startService() {
   if (process.platform === "win32") {
-    startWindowsAutoStart();
+    const mode = startWindowsAutoStart();
+    if (mode === "run-key") {
+      console.log("Service started in background (Windows startup registry entry).");
+    } else {
+      console.log("Service started in background (Windows Task Scheduler).");
+    }
     return;
   }
 
@@ -196,7 +208,7 @@ function installWindowsAutoStart() {
   }
 
   installWindowsRunKey(command);
-  runDaemon("start");
+  runWindowsHiddenLauncher();
   return "run-key";
 }
 
@@ -236,6 +248,10 @@ function uninstallWindowsAutoStart() {
     );
   }
 
+  if (fs.existsSync(windowsLauncherScriptPath)) {
+    fs.rmSync(windowsLauncherScriptPath, { force: true });
+  }
+
   return removed;
 }
 
@@ -281,12 +297,20 @@ function runWindowsTask() {
 }
 
 function startWindowsAutoStart() {
+  const command = buildWindowsLaunchCommand();
   const runKey = queryWindowsRunKey();
   if (runKey.installed) {
-    runDaemon("start");
-    return;
+    installWindowsRunKey(command);
+    runWindowsHiddenLauncher();
+    return "run-key";
+  }
+  const task = queryWindowsTask();
+  if (!task.installed) {
+    throw new Error("Service is not installed. Run 'copilot-hub service install' first.");
   }
+  ensureTaskSchedulerAutoStart(command);
   runWindowsTask();
+  return "task";
 }
 
 function queryWindowsRunKey() {
@@ -302,6 +326,19 @@ function queryWindowsRunKey() {
   throw new Error(result.combinedOutput || "Failed to query Windows startup registry entry.");
 }
 
+function queryWindowsTask() {
+  const result = runChecked("schtasks", ["/Query", "/TN", WINDOWS_TASK_NAME], {
+    allowFailure: true,
+  });
+  if (result.ok) {
+    return { installed: true };
+  }
+  if (isNotFoundMessage(result.combinedOutput)) {
+    return { installed: false };
+  }
+  throw new Error(result.combinedOutput || "Failed to query Windows auto-start task.");
+}
+
 function installWindowsRunKey(command) {
   runChecked(
     "reg",
@@ -320,6 +357,21 @@ function installWindowsRunKey(command) {
   );
 }
 
+function ensureTaskSchedulerAutoStart(command) {
+  const result = runChecked(
+    "schtasks",
+    ["/Create", "/TN", WINDOWS_TASK_NAME, "/SC", "ONLOGON", "/RL", "LIMITED", "/F", "/TR", command],
+    { allowFailure: true },
+  );
+  if (result.ok) {
+    return;
+  }
+  if (isNotFoundMessage(result.combinedOutput)) {
+    throw new Error("Service is not installed. Run 'copilot-hub service install' first.");
+  }
+  throw new Error(result.combinedOutput || "Failed to update Windows auto-start task.");
+}
+
 function installLinuxService() {
   ensureSystemctl();
   const unitPath = getLinuxUnitPath();
@@ -504,6 +556,20 @@ function ensureDaemonScript() {
   }
 }
 
+function runWindowsHiddenLauncher() {
+  const launcherScriptPath = ensureWindowsLauncherScript();
+  const scriptHost = resolveWindowsScriptHost(process.env);
+  if (!fs.existsSync(scriptHost)) {
+    throw new Error("Windows Script Host is not available.");
+  }
+  const result = runChecked(scriptHost, ["//B", "//Nologo", launcherScriptPath], {
+    allowFailure: true,
+  });
+  if (!result.ok) {
+    throw new Error(result.combinedOutput || "Failed to launch hidden Windows service starter.");
+  }
+}
+
 function ensureSystemctl() {
   ensureCommandAvailable(
     "systemctl",
@@ -629,7 +695,18 @@ function getErrorMessage(error) {
 }
 
 function buildWindowsLaunchCommand() {
-  return `"${nodeBin}" "${daemonScriptPath}" run`;
+  const launcherScriptPath = ensureWindowsLauncherScript();
+  return buildWindowsHiddenLauncherCommand(launcherScriptPath, process.env);
+}
+
+function ensureWindowsLauncherScript() {
+  ensureDaemonScript();
+  return ensureWindowsHiddenLauncher({
+    scriptPath: windowsLauncherScriptPath,
+    nodeBin,
+    daemonScriptPath,
+    runtimeDir: layout.runtimeDir,
+  });
 }
 
 function escapeXml(value) {

package/scripts/src/windows-hidden-launcher.mts

@@ -0,0 +1,81 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export function resolveWindowsScriptHost(env: NodeJS.ProcessEnv = process.env): string {
+  const systemRoot = String(env.SystemRoot ?? env.SYSTEMROOT ?? "C:\\Windows").trim();
+  const baseDir = systemRoot || "C:\\Windows";
+  return path.win32.join(baseDir, "System32", "wscript.exe");
+}
+
+export function getWindowsHiddenLauncherScriptPath(runtimeDir: string): string {
+  return path.win32.join(runtimeDir, "windows-daemon-launcher.vbs");
+}
+
+export function ensureWindowsHiddenLauncher({
+  scriptPath,
+  nodeBin,
+  daemonScriptPath,
+  runtimeDir,
+}: {
+  scriptPath: string;
+  nodeBin: string;
+  daemonScriptPath: string;
+  runtimeDir: string;
+}): string {
+  const content = buildWindowsHiddenLauncherContent({
+    nodeBin,
+    daemonScriptPath,
+    runtimeDir,
+  });
+
+  let current = "";
+  try {
+    current = fs.readFileSync(scriptPath, "utf8");
+  } catch {
+    current = "";
+  }
+
+  if (current !== content) {
+    fs.mkdirSync(path.dirname(scriptPath), { recursive: true });
+    fs.writeFileSync(scriptPath, content, "utf8");
+  }
+
+  return scriptPath;
+}
+
+export function buildWindowsHiddenLauncherCommand(
+  scriptPath: string,
+  env: NodeJS.ProcessEnv = process.env,
+): string {
+  const scriptHost = resolveWindowsScriptHost(env);
+  return `"${scriptHost}" //B //Nologo "${scriptPath}"`;
+}
+
+export function buildWindowsHiddenLauncherContent({
+  nodeBin,
+  daemonScriptPath,
+  runtimeDir,
+}: {
+  nodeBin: string;
+  daemonScriptPath: string;
+  runtimeDir: string;
+}): string {
+  const command = buildWindowsCommandLine([nodeBin, daemonScriptPath, "start"]);
+  return [
+    "Option Explicit",
+    "Dim shell",
+    'Set shell = CreateObject("WScript.Shell")',
+    `shell.CurrentDirectory = "${escapeVbsString(runtimeDir)}"`,
+    `shell.Run "${escapeVbsString(command)}", 0, False`,
+    "Set shell = Nothing",
+    "",
+  ].join("\r\n");
+}
+
+function buildWindowsCommandLine(args: string[]): string {
+  return args.map((value) => `"${String(value ?? "")}"`).join(" ");
+}
+
+function escapeVbsString(value: string): string {
+  return String(value ?? "").replace(/"/g, '""');
+}

package/scripts/test/windows-hidden-launcher.test.mjs

@@ -0,0 +1,66 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import {
+  buildWindowsHiddenLauncherCommand,
+  buildWindowsHiddenLauncherContent,
+  ensureWindowsHiddenLauncher,
+  resolveWindowsScriptHost,
+} from "../dist/windows-hidden-launcher.mjs";
+
+test("resolveWindowsScriptHost prefers SystemRoot", () => {
+  const actual = resolveWindowsScriptHost({ SystemRoot: "D:\\Windows" });
+  assert.equal(actual, path.win32.join("D:\\Windows", "System32", "wscript.exe"));
+});
+
+test("buildWindowsHiddenLauncherCommand uses wscript in batch mode", () => {
+  const actual = buildWindowsHiddenLauncherCommand("C:\\runtime\\launcher.vbs", {
+    SystemRoot: "C:\\Windows",
+  });
+  assert.equal(
+    actual,
+    '"C:\\Windows\\System32\\wscript.exe" //B //Nologo "C:\\runtime\\launcher.vbs"',
+  );
+});
+
+test("buildWindowsHiddenLauncherContent starts daemon in hidden mode", () => {
+  const content = buildWindowsHiddenLauncherContent({
+    nodeBin: "C:\\Program Files\\nodejs\\node.exe",
+    daemonScriptPath: "C:\\Program Files\\copilot-hub\\scripts\\dist\\daemon.mjs",
+    runtimeDir: "C:\\Users\\amine\\AppData\\Roaming\\copilot-hub\\runtime",
+  });
+
+  assert.match(content, /CreateObject\("WScript\.Shell"\)/);
+  assert.match(content, /shell\.Run/);
+  assert.match(content, /, 0, False/);
+  assert.match(content, /"start"/);
+});
+
+test("ensureWindowsHiddenLauncher writes and preserves launcher content", () => {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "copilot-hub-launcher-"));
+  const scriptPath = path.join(tempDir, "windows-daemon-launcher.vbs");
+
+  try {
+    ensureWindowsHiddenLauncher({
+      scriptPath,
+      nodeBin: "C:\\node.exe",
+      daemonScriptPath: "C:\\copilot-hub\\daemon.mjs",
+      runtimeDir: "C:\\copilot-hub\\runtime",
+    });
+
+    const first = fs.readFileSync(scriptPath, "utf8");
+    ensureWindowsHiddenLauncher({
+      scriptPath,
+      nodeBin: "C:\\node.exe",
+      daemonScriptPath: "C:\\copilot-hub\\daemon.mjs",
+      runtimeDir: "C:\\copilot-hub\\runtime",
+    });
+    const second = fs.readFileSync(scriptPath, "utf8");
+
+    assert.equal(second, first);
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+});