@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/host/windows/paths.js

@@ -0,0 +1,148 @@
+/**
+ * Windows Chrome run — path mapping, locate, and profile/profile-root helpers.
+ *
+ * The pure half of the run: the drive-letter spelling mapped onto the WSL
+ * interop mount, the located executable, the Windows-native profile directory
+ * (never one rooted in the WSL checkout — 9P cannot carry Chrome's SQLite/
+ * singleton locks), the LOCALAPPDATA root the profile hangs under, and the
+ * project directory that roots the workspace `.chrome` view. Every one is
+ * injectable or takes its own answer so a test never depends on the machine it
+ * runs on. The orchestrator lives in ./run.ts; the workspace-view link in
+ * ./link.ts; the raw net/spawn seams in ./spawn.ts; the connect address and
+ * connect-mode flag in ./connect-flags.ts.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { WINDOWS_CHROME_CANDIDATES, WINDOWS_CHROME_PROFILE_DIRNAME } from "../constants.js";
+/**
+ * The Windows spelling mapped onto the interop mount (`C:\Program Files\…` →
+ * `/mnt/c/Program Files/…`), which is the form WSL can stat. A path already
+ * spelled as the mount maps to itself — the mount spelling is what the WSL side
+ * can stat and therefore what a saved row or the row config may carry — and a
+ * path that is neither maps nowhere and yields "".
+ *
+ * A path may have been written or copied shell-style, where a space is escaped
+ * (`Program\ Files`). Such a backslash escapes the space that follows it and is
+ * not a separator, so it folds away to the plain space first; every other
+ * backslash is a Windows separator and folds to a slash. Turning one space
+ * escape blindly into a slash produced `Program/ Files` — a path that exists
+ * nowhere and answers `not-found` for a Chrome the run had actually located
+ * (measured live 2026-10-12 against a saved mount-spelled selection).
+ */
+export function windowsPathToMount(path) {
+    if (typeof path !== "string")
+        return "";
+    const candidate = path.trim().replace(/\\ /gu, " ").replace(/\\/gu, "/");
+    const windows = candidate.match(/^([a-z]):\/(.*)$/iu);
+    if (windows !== null)
+        return `/mnt/${windows[1].toLowerCase()}/${windows[2]}`;
+    const mounted = candidate.match(/^\/mnt\/([a-z])\/(.*)$/iu);
+    if (mounted === null)
+        return "";
+    return `/mnt/${mounted[1].toLowerCase()}/${mounted[2]}`;
+}
+/**
+ * Locate the Windows-side Chrome through the interop mount: the first candidate
+ * whose mount path exists, "" when this machine carries none of them. The
+ * returned path keeps its **Windows** spelling — it is what the `start`
+ * invocation takes and what the card names.
+ */
+export function findWindowsChromeExecutable(exists = (path) => existsSync(path), candidates = WINDOWS_CHROME_CANDIDATES) {
+    return findWindowsChromeExecutables(exists, candidates)[0] ?? "";
+}
+/**
+ * Every Windows-side executable this host carries, in the list's own preference
+ * order and in its **Windows** spelling — the whole located set, not only the
+ * first. This is what the executable run folds into its candidate list, so the
+ * picker offers the Windows browser instead of hiding it. A machine that carries
+ * none of them answers nothing, so the list is what is installed here, never a
+ * fixed set of install locations. Nothing on the list is ever spawned from WSL
+ * (see `blockedForPlatform`); it is offered so that the **Prelaunch Windows
+ * Chrome** run can be pointed at the one the picker selected.
+ */
+export function findWindowsChromeExecutables(exists = (path) => existsSync(path), candidates = WINDOWS_CHROME_CANDIDATES) {
+    const found = [];
+    for (const candidate of Array.isArray(candidates) ? candidates : []) {
+        const path = typeof candidate === "string" ? candidate.trim() : "";
+        if (path === "" || found.includes(path))
+            continue;
+        if (exists(windowsPathToMount(path)))
+            found.push(path);
+    }
+    return found;
+}
+/** Cached answer of the Windows-side profile root (`windowsChromeLocalAppData`). */
+let cachedLocalAppData;
+/**
+ * The Windows-side profile directory: `<localAppData>\<dir>\.chrome[-<port>]`.
+ * The profile has to live on the Windows filesystem — Chrome takes real locks
+ * for its SQLite tables and its singleton socket, and the WSL-side directories
+ * Windows sees through the interop mount (9P) cannot carry them: a profile
+ * rooted there creates every table as a zero-byte file, never answers the
+ * singleton lock, and shows "an error occurred while opening your profile" on
+ * every launch (measured live 2026-10-04 against Chrome 154). "" answers when
+ * LOCALAPPDATA is not there.
+ */
+export function windowsChromeProfileDir(localAppData, leaf = ".chrome") {
+    const root = typeof localAppData === "string" ? localAppData.trim().replace(/[\\/]+$/u, "") : "";
+    if (root === "")
+        return "";
+    const profile = String(leaf ?? "").replace(/[\\/]+/gu, "");
+    if (profile === "")
+        return "";
+    return `${root}\\${WINDOWS_CHROME_PROFILE_DIRNAME}\\${profile}`;
+}
+/**
+ * Resolves `%LOCALAPPDATA%` on the Windows side through the Known Folder API
+ * (never the inherited environment — the interop hand-off drops it, so
+ * `echo %LOCALAPPDATA%` comes back empty), cached across the process:
+ * powershell answers it exactly once per host.
+ */
+export function windowsChromeLocalAppData() {
+    if (typeof cachedLocalAppData === "string")
+        return cachedLocalAppData;
+    try {
+        const out = execFileSync("/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", "[Environment]::GetFolderPath('LocalApplicationData')"], { encoding: "utf8", timeout: 5000 });
+        const value = String(out).trim();
+        cachedLocalAppData = value;
+        return value;
+    }
+    catch {
+        cachedLocalAppData = "";
+        return "";
+    }
+}
+/**
+ * The directory the Windows run roots its profile view under — the project
+ * whose checkout the run answers: the row-config `cwd`, else the **live
+ * session workspace** (the run answers to the GUI the user is driving, not to
+ * whatever directory `dsh web` happened to be launched from — a run rooted at
+ * `~` links `~/.chrome` instead of the workspace), else the host's own cwd.
+ * @param configCwd - the row-config `cwd`, "" when unset.
+ * @param sessions - the sessions service, resolved optionally.
+ * @param hostCwd - the host process' cwd.
+ */
+export function windowsChromeProjectDir(configCwd, sessions, hostCwd) {
+    if (typeof configCwd === "string" && configCwd.trim() !== "")
+        return configCwd.trim();
+    if (sessions === null || typeof sessions !== "object")
+        return hostCwd;
+    const list = sessions.list;
+    if (typeof list !== "function")
+        return hostCwd;
+    let live = "";
+    let best = -1;
+    for (const session of (list.call(sessions) ?? [])) {
+        const header = session?.header;
+        const cwd = typeof header?.cwd === "string" ? header.cwd.trim() : "";
+        if (cwd === "")
+            continue;
+        const createdAt = Number.isFinite(header?.createdAt) ? Number(header?.createdAt) : 0;
+        if (createdAt >= best) {
+            best = createdAt;
+            live = cwd;
+        }
+    }
+    return live !== "" ? live : hostCwd;
+}
+//# sourceMappingURL=paths.js.map

package/lib/host/windows/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/host/windows/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,QAAQ,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,QAAQ,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACvC,SAAoC,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EACtE,aAAgC,yBAAyB;IAEzD,OAAO,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CACxC,SAAoC,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EACtE,aAAgC,yBAAyB;IAEzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,IAAI,IAAI,KAAK,EAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAClD,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,oFAAoF;AACpF,IAAI,kBAAsC,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAqB,EAAE,IAAI,GAAG,SAAS;IAC3E,MAAM,IAAI,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjG,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO,GAAG,IAAI,KAAK,8BAA8B,KAAK,OAAO,EAAE,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACrC,IAAI,OAAO,kBAAkB,KAAK,QAAQ;QAAE,OAAO,kBAAkB,CAAC;IACtE,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CACpB,+DAA+D,EAC/D,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,sDAAsD,CAAC,EACrG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CACtC,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,kBAAkB,GAAG,KAAK,CAAC;QAC3B,OAAO,KAAK,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACL,kBAAkB,GAAG,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAkB,EAAE,QAAiB,EAAE,OAAe;IAC1F,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;IACtF,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IACtE,MAAM,IAAI,GAAI,QAAqC,CAAC,IAAI,CAAC;IACzD,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAc,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAI,OAA4C,EAAE,MACR,CAAC;QACvD,MAAM,GAAG,GAAG,OAAO,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACpB,IAAI,GAAG,SAAS,CAAC;YACjB,IAAI,GAAG,GAAG,CAAC;QACf,CAAC;IACL,CAAC;IACD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AACxC,CAAC"}

package/lib/host/windows/run.d.ts

@@ -0,0 +1,74 @@
+import type { WindowsChromeLinkAnswer, WindowsChromeRun } from "../types/index.js";
+/** Everything {@link runWindowsChromeConnect} consults; every field defaults
+ * to what the running host actually is. */
+export type WindowsChromeRunOptions = {
+    /** Locates the Windows executable through the interop mount. Defaults to
+     * `existsSync`. */
+    exists?: (path: string) => boolean;
+    /** The Windows-side profile root (%LOCALAPPDATA%). Defaults to the Known
+     * Folder API answer, cached per host. */
+    localAppData?: string;
+    /** The workspace `.chrome` view refresh; defaults to `linkWindowsChromeProfile`.
+     * Injected so tests never touch the real filesystem. */
+    linkProfile?: (linkPath: string, profileWin: string) => WindowsChromeLinkAnswer;
+    /** The project directory the Windows-side profile directory hangs under.
+     * Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** The Windows executables to look for, in preference order. */
+    candidates?: readonly string[];
+    /** The extra-flags list the bridge currently launches with. A live
+     * `--browserUrl` entry inside it is re-checked instead of re-launched
+     * (idempotency: a second click never opens a second window or duplicates
+     * the flag). */
+    currentFlags?: readonly string[];
+    /** The debugging-port pool: first entry is the preferred port, later
+     * entries only used when an earlier one already answers reachable. */
+    ports?: readonly number[];
+    /** Ports only Windows listens on — the prereq reachability probe. */
+    prereqPorts?: readonly number[];
+    /** The Windows-side working directory the launch runs with. Omit/skip when
+     * it is not there. */
+    startCwd?: string;
+    /** Answers whether `host:port` accepts a connection right now. */
+    reachable?: (host: string, port: number) => Promise<boolean>;
+    /** Launches the executable and resolves the moment the OS accepted the
+     * process; rejects with the reason when the launch itself failed. */
+    start?: (executable: string, args: string[], cwd: string | undefined) => Promise<void>;
+    /** Writes the landing page beside the profile directory and answers the
+     * `file:///…` URL to open in the launched window ("" = launch with no
+     * page). Defaults to the packaged page rendered with this run's answers;
+     * injected so a unit run never writes through the interop mount. */
+    landing?: (profileDir: string, url: string, port: number) => string;
+    /** How long to wait for the launched browser to bind its port. */
+    waitMs?: number;
+    /** Poll cadence while waiting. */
+    pollMs?: number;
+    /** One reachability sample's timeout. */
+    sampleMs?: number;
+};
+/**
+ * The whole **Prelaunch Windows Chrome** run, in order:
+ *
+ * 1. locate a Windows Chrome/Edge — none answers `not-found`;
+ * 2. prove the prereq — one Windows-only port must answer reachable, or
+ *    nothing is launched and the answer is `unreachable` carrying the one
+ *    manual step (mirrored networking);
+ * 3. pick the port — the preferred one when it is free, else the first free
+ *    entry of the pool (`WINDOWS_CHROME_PORT_POOL`); a listener already
+ *    carrying connect mode means the address is live and nothing is launched;
+ * 4. launch by exec'ing the located executable through the interop mount,
+ *    with `--remote-debugging-port=<P>`, a dedicated profile directory under
+ *    the project (never the default profile: an in-use default profile
+ *    silently ignores the port), the first-run-page flags and the landing page
+ *    that states what the window is for ("" = no page, never a reason for the
+ *    launch not to happen);
+ * 5. wait for the port to come up — `connected` when it does, `unreachable`
+ *    (with its own error) when it never binds.
+ *
+ * The run never kills what it started: closing the browser belongs to the
+ * user, and a bridge in connect mode survives a browser restart.
+ *
+ * @param options - what to consult (every half injectable).
+ */
+export declare function runWindowsChromeConnect(options?: WindowsChromeRunOptions): Promise<WindowsChromeRun>;
+//# sourceMappingURL=run.d.ts.map

package/lib/host/windows/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/host/windows/run.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQnF;2CAC2C;AAC3C,MAAM,MAAM,uBAAuB,GAAG;IAClC;uBACmB;IACnB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC;6CACyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;4DACwD;IACxD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,uBAAuB,CAAC;IAChF;sCACkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;oBAGgB;IAChB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;0EACsE;IACtE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,qEAAqE;IACrE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;0BACsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D;yEACqE;IACrE,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF;;;wEAGoE;IACpE,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpE,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8J9G"}

package/lib/host/windows/run.js

@@ -0,0 +1,211 @@
+/**
+ * Windows Chrome run — the orchestrator behind the card's **Open Windows
+ * Chrome** button (and the `prelaunch_windows_chrome` tool).
+ *
+ * Driving the Windows browser in connect mode is the only Windows path ever
+ * measured to work: launch it with `--remote-debugging-port=<P>` and a dedicated
+ * profile, then let the bridge connect to `http://127.0.0.1:<P>` instead of
+ * launching anything locally. This module sequences the whole run — locate,
+ * prove the prereq (the mirrored-loopback reachability), pick the port, launch,
+ * wait for the port to bind — and answers through one state union. The pieces it
+ * drives live alongside it: ./paths.ts (map + locate + profile directory),
+ * ./link.ts (the workspace `.chrome` view), ./connect-flags.ts (the address +
+ * the connect-mode flag), ./spawn.ts (the raw reachability sample + interop
+ * launch). Every half is injectable so tests never depend on the machine.
+ *
+ * Launching the Windows `chrome.exe` in *launch* mode stays out entirely (hard
+ * constraint — the debug pipes do not survive the interop boundary), as does
+ * the default profile (an in-use one silently ignores the port) and the
+ * `cmd.exe /c start` wrapper (it never returns while the browser lives). The run
+ * never kills what it started: closing the browser belongs to the user, and a
+ * connect-mode bridge survives a browser restart. The field evidence behind each
+ * choice is `.probe/windows-chrome-connect-probe.log`.
+ *
+ * A launched window also carries its own explanation: the launch hands the
+ * browser a packaged landing page (./landing.ts) rendered with the run's port,
+ * connect address and profile directory. It is not a precondition — every
+ * landing failure is "" and the launch goes ahead exactly as it did before — but
+ * a window that opens with nothing on screen reads as a malfunction, which is
+ * what the page is for.
+ */
+import { existsSync } from "node:fs";
+import { WINDOWS_CHROME_CANDIDATES, WINDOWS_CHROME_FIRST_RUN_FLAGS, WINDOWS_CHROME_POLL_MS, WINDOWS_CHROME_PORT, WINDOWS_CHROME_PORT_POOL, WINDOWS_CHROME_PREREQ_ERROR, WINDOWS_CHROME_PREREQ_PORTS, WINDOWS_CHROME_SAMPLE_MS, WINDOWS_CHROME_START_CWD, WINDOWS_CHROME_WAIT_MS } from "../constants.js";
+import { firstLine } from "../status.js";
+import { browserUrlFlagPort, windowsChromeUrl } from "./connect-flags.js";
+import { windowsChromeLandingUrl } from "./landing.js";
+import { linkWindowsChromeProfile } from "./link.js";
+import { findWindowsChromeExecutable, windowsChromeLocalAppData, windowsChromeProfileDir, windowsPathToMount } from "./paths.js";
+import { defaultReachable, defaultStart } from "./spawn.js";
+/**
+ * The whole **Prelaunch Windows Chrome** run, in order:
+ *
+ * 1. locate a Windows Chrome/Edge — none answers `not-found`;
+ * 2. prove the prereq — one Windows-only port must answer reachable, or
+ *    nothing is launched and the answer is `unreachable` carrying the one
+ *    manual step (mirrored networking);
+ * 3. pick the port — the preferred one when it is free, else the first free
+ *    entry of the pool (`WINDOWS_CHROME_PORT_POOL`); a listener already
+ *    carrying connect mode means the address is live and nothing is launched;
+ * 4. launch by exec'ing the located executable through the interop mount,
+ *    with `--remote-debugging-port=<P>`, a dedicated profile directory under
+ *    the project (never the default profile: an in-use default profile
+ *    silently ignores the port), the first-run-page flags and the landing page
+ *    that states what the window is for ("" = no page, never a reason for the
+ *    launch not to happen);
+ * 5. wait for the port to come up — `connected` when it does, `unreachable`
+ *    (with its own error) when it never binds.
+ *
+ * The run never kills what it started: closing the browser belongs to the
+ * user, and a bridge in connect mode survives a browser restart.
+ *
+ * @param options - what to consult (every half injectable).
+ */
+export async function runWindowsChromeConnect(options = {}) {
+    const exists = typeof options.exists === "function" ? options.exists : (path) => existsSync(path);
+    const cwd = typeof options.cwd === "string" ? options.cwd : process.cwd();
+    const candidates = Array.isArray(options.candidates) ? options.candidates : WINDOWS_CHROME_CANDIDATES;
+    const ports = (Array.isArray(options.ports) ? options.ports : [...WINDOWS_CHROME_PORT_POOL]).map((port) => Math.trunc(port));
+    const prereqPorts = Array.isArray(options.prereqPorts) ? options.prereqPorts : [...WINDOWS_CHROME_PREREQ_PORTS];
+    const startCwd = typeof options.startCwd === "string" ? options.startCwd : WINDOWS_CHROME_START_CWD;
+    const waitMs = Number.isFinite(options.waitMs) ? Number(options.waitMs) : WINDOWS_CHROME_WAIT_MS;
+    const pollMs = Number.isFinite(options.pollMs) ? Number(options.pollMs) : WINDOWS_CHROME_POLL_MS;
+    const sampleMs = Number.isFinite(options.sampleMs) ? Number(options.sampleMs) : WINDOWS_CHROME_SAMPLE_MS;
+    const reachable = (host, port) => typeof options.reachable === "function"
+        ? Promise.resolve(options.reachable(host, port)).then((value) => value === true)
+        : defaultReachable(host, port, sampleMs);
+    const start = (command, args, cwdValue) => typeof options.start === "function" ? Promise.resolve(options.start(command, args, cwdValue)) : defaultStart(command, args, cwdValue);
+    // The profile root (the Windows-side LOCALAPPDATA) is only needed on the
+    // branches that connect, so it resolves lazily and stays cached.
+    const localAppData = () => typeof options.localAppData === "string" ? options.localAppData : windowsChromeLocalAppData();
+    const linkProfile = (linkPath, profileWin) => typeof options.linkProfile === "function" ? options.linkProfile(linkPath, profileWin) : linkWindowsChromeProfile(linkPath, profileWin);
+    const landing = (profileWin, connectUrl, portValue) => typeof options.landing === "function" ? options.landing(profileWin, connectUrl, portValue) : windowsChromeLandingUrl(profileWin, connectUrl, portValue);
+    // The workspace view the successful run keeps pointing at its profile —
+    // the same `<project>/.chrome` the **Flags WSL** recommended flag names.
+    const profileLinkPath = `${cwd.replace(/[\\/]+$/gu, "")}/.chrome`;
+    if (ports.length === 0)
+        ports.push(WINDOWS_CHROME_PORT);
+    // 1. locate.
+    const executable = findWindowsChromeExecutable(exists, candidates);
+    if (executable === "") {
+        return {
+            state: "not-found",
+            port: 0,
+            url: "",
+            error: `no Windows Chrome found (checked: ${Array.isArray(candidates) ? candidates.join(", ") : ""})`,
+            profileDir: ""
+        };
+    }
+    // 2. prereq: the Windows loopback has to be reachable before anything is
+    // launched. Nothing reachable means no launch — the window would be dead
+    // weight, and the run would have paid for a browser it cannot drive.
+    let prereqOk = false;
+    for (const port of prereqPorts) {
+        if (await reachable("127.0.0.1", port)) {
+            prereqOk = true;
+            break;
+        }
+    }
+    if (!prereqOk)
+        return { state: "unreachable", port: 0, url: "", profileDir: "", error: WINDOWS_CHROME_PREREQ_ERROR };
+    // 3. port. A live connect entry already answers — in every spelling
+    // `flags.ts` accepts, not only the one the run itself writes — so it is
+    // re-checked and settled on without a second launch when it still holds.
+    const livePort = browserUrlFlagPort(options.currentFlags);
+    if (livePort > 0 && (await reachable("127.0.0.1", livePort))) {
+        // The already-live session is profiled in the same per-port directory a
+        // launch would have chosen, so the workspace view keeps pointing at
+        // whatever is actually running.
+        const liveLeaf = livePort === WINDOWS_CHROME_PORT ? ".chrome" : `.chrome-${String(livePort)}`;
+        const liveProfileDir = windowsChromeProfileDir(localAppData(), liveLeaf);
+        return {
+            state: "connected",
+            port: livePort,
+            url: windowsChromeUrl(livePort),
+            error: "",
+            profileDir: liveProfileDir,
+            profileLink: linkProfile(profileLinkPath, liveProfileDir)
+        };
+    }
+    const pool = livePort > 0 ? [livePort, ...ports.filter((port) => port !== livePort)] : ports;
+    let port = 0;
+    for (const candidate of pool) {
+        if (!(await reachable("127.0.0.1", candidate))) {
+            port = candidate;
+            break;
+        }
+    }
+    if (port === 0)
+        port = pool[pool.length - 1];
+    // 4. profile + launch. The profile directory is Windows-side (a profile
+    // rooted in the WSL checkout cannot carry Chrome's locks, and a profile
+    // that cannot lock answers "an error occurred while opening your profile");
+    // it is never the default profile (an in-use one silently ignores the
+    // port); and it never goes through the `cmd.exe /c start` wrapper (see
+    // ./spawn.ts: under interop that wrapper never returns while the browser
+    // lives, and the whole run silently stalls). The locate answer is a Windows
+    // spelling (what the card may quote); interop execs through the mount, so
+    // the launch maps it back first.
+    const leaf = port === WINDOWS_CHROME_PORT ? ".chrome" : `.chrome-${String(port)}`;
+    const profileDir = windowsChromeProfileDir(localAppData(), leaf);
+    if (profileDir === "") {
+        return {
+            state: "launch-failed",
+            port,
+            url: "",
+            profileDir: "",
+            error: "cannot derive the Windows-side profile directory: LOCALAPPDATA did not answer"
+        };
+    }
+    // The launch's argv: the port, the profile, the first-run flags, and — last
+    // — one positional URL, the landing page that says what this window is for.
+    // A page that could not be rendered or written answers "" and simply drops
+    // out of argv: the run's answer never depends on prose.
+    const url = windowsChromeUrl(port);
+    const landingUrl = landing(profileDir, url, port);
+    try {
+        await start(windowsPathToMount(executable) || executable, [
+            `--remote-debugging-port=${String(port)}`,
+            `--user-data-dir=${profileDir}`,
+            // A brand-new profile is a first run: without these, Windows
+            // Chrome opens the welcome tab and the search-engine chooser
+            // and connect mode never clicks past them.
+            ...WINDOWS_CHROME_FIRST_RUN_FLAGS,
+            ...(landingUrl === "" ? [] : [landingUrl])
+        ], exists(startCwd) ? startCwd : undefined);
+    }
+    catch (error) {
+        return {
+            state: "launch-failed",
+            port,
+            url: "",
+            profileDir: "",
+            error: `could not start Windows Chrome: ${firstLine(error instanceof Error ? error.message : String(error))}`
+        };
+    }
+    // 5. wait for the browser to bind its port. A browser that never binds it
+    // is not reachable, so the answer is the prereq's failure to be useful.
+    const deadline = Date.now() + waitMs;
+    for (;;) {
+        if (await reachable("127.0.0.1", port)) {
+            return {
+                state: "connected",
+                port,
+                url,
+                error: "",
+                profileDir,
+                profileLink: linkProfile(profileLinkPath, profileDir)
+            };
+        }
+        if (Date.now() >= deadline) {
+            return {
+                state: "unreachable",
+                port,
+                url: "",
+                profileDir: "",
+                error: `Windows Chrome started but did not open a debugging port on 127.0.0.1:${String(port)} — ${WINDOWS_CHROME_PREREQ_ERROR}`
+            };
+        }
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+}
+//# sourceMappingURL=run.js.map

package/lib/host/windows/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/host/windows/run.ts"],"names":[],"mappings":"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"}

package/lib/host/windows/spawn.d.ts

@@ -0,0 +1,22 @@
+/** One TCP sample: connect success answers reachable; anything else (refusal,
+ * timeout) answers unreachable — the NAT host's honest behaviour. */
+export declare function defaultReachable(host: string, port: number, sampleMs?: number): Promise<boolean>;
+/**
+ * Launch the Windows-side browser through the interop mount by exec'ing it
+ * directly, resolving the moment the OS accepted the process (the browser
+ * itself keeps running — the run must never wait for it, and the port wait
+ * below is what turns a silently dead launch into `unreachable`).
+ *
+ * The interop `start` wrapper is deliberately NOT used here even though the
+ * plan quoted `cmd.exe /c start`: measured 2026-10-06 against Windows Chrome
+ * 154 (see .probe/windows-chrome-connect-probe.log), the WSL interop process
+ * for `cmd.exe /c start "" <browser> <args…>` does not exit while the GUI
+ * browser lives, so step 4 could never report its answer and the card sat in
+ * "launching" until the spawn timed out — a silent 30 s. A direct
+ * `execve`/CreateProcess of the executable accepted in 3 ms and bound the
+ * port in ~1 s; this is the only launch shape that returns. It also keeps
+ * Chrome's working directory out of any UNC path (the old `start` warning),
+ * since the launch takes a Windows-side cwd.
+ */
+export declare function defaultStart(executable: string, args: string[], cwd: string | undefined): Promise<void>;
+//# sourceMappingURL=spawn.d.ts.map

package/lib/host/windows/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/host/windows/spawn.ts"],"names":[],"mappings":"AAmBA;qEACqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAiC,GAAG,OAAO,CAAC,OAAO,CAAC,CAe1H;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvG"}

package/lib/host/windows/spawn.js

@@ -0,0 +1,73 @@
+/**
+ * Windows Chrome run — the raw machine seams: a TCP reachability sample and a
+ * direct interop launch.
+ *
+ * The two halves of the run that reach outside the process, injected by
+ * ./run.ts (and replaced wholesale by the tests) so a unit run never opens a
+ * real socket or spawns through the interop mount. The TCP sample answers
+ * reachable only on a genuine connect — a refusal or a timeout both read
+ * unreachable, the honest NAT-host behaviour. The launch is the interop exec of
+ * the located executable (NOT the `cmd.exe /c start` wrapper the plan quoted:
+ * under interop that wrapper never returns while the GUI browser lives, so the
+ * whole run silently stalls — measured 2026-10-06 against Chrome 154), resolving
+ * the moment the OS accepts the process.
+ */
+import { spawn } from "node:child_process";
+import { connect } from "node:net";
+import { WINDOWS_CHROME_SAMPLE_MS } from "../constants.js";
+/** One TCP sample: connect success answers reachable; anything else (refusal,
+ * timeout) answers unreachable — the NAT host's honest behaviour. */
+export function defaultReachable(host, port, sampleMs = WINDOWS_CHROME_SAMPLE_MS) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const socket = connect({ host, port });
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            resolve(value);
+        };
+        socket.setTimeout(sampleMs);
+        socket.on("connect", () => finish(true));
+        socket.on("timeout", () => finish(false));
+        socket.on("error", () => finish(false));
+    });
+}
+/**
+ * Launch the Windows-side browser through the interop mount by exec'ing it
+ * directly, resolving the moment the OS accepted the process (the browser
+ * itself keeps running — the run must never wait for it, and the port wait
+ * below is what turns a silently dead launch into `unreachable`).
+ *
+ * The interop `start` wrapper is deliberately NOT used here even though the
+ * plan quoted `cmd.exe /c start`: measured 2026-10-06 against Windows Chrome
+ * 154 (see .probe/windows-chrome-connect-probe.log), the WSL interop process
+ * for `cmd.exe /c start "" <browser> <args…>` does not exit while the GUI
+ * browser lives, so step 4 could never report its answer and the card sat in
+ * "launching" until the spawn timed out — a silent 30 s. A direct
+ * `execve`/CreateProcess of the executable accepted in 3 ms and bound the
+ * port in ~1 s; this is the only launch shape that returns. It also keeps
+ * Chrome's working directory out of any UNC path (the old `start` warning),
+ * since the launch takes a Windows-side cwd.
+ */
+export function defaultStart(executable, args, cwd) {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(executable, args, {
+                stdio: "ignore",
+                ...(cwd === undefined || cwd === "" ? {} : { cwd })
+            });
+        }
+        catch (error) {
+            reject(new Error(`could not run "${executable} ${args.join(" ")}": ${String(error)}`));
+            return;
+        }
+        // `spawn` is the OS accepting the process; no other half is waited on.
+        child.once("spawn", resolve);
+        child.once("error", (error) => reject(new Error(`could not run "${executable} ${args.join(" ")}": ${String(error)}`)));
+        child.unref();
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/lib/host/windows/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/host/windows/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;qEACqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,WAAmB,wBAAwB;IACpG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;YAC9B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;QACF,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,IAAc,EAAE,GAAuB;IACpF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE;gBAC5B,KAAK,EAAE,QAAQ;gBACf,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;aACtD,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YACvF,OAAO;QACX,CAAC;QACD,uEAAuE;QACvE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE,CACjD,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,KAAK,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}