lockin-mcp 1.0.4 → 1.0.7

package/dist/installer/background-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-service.js","sourceRoot":"","sources":["../../src/installer/background-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAW9C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA+B;IAE/B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC3D,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACnD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,iCAAiC,SAAS,GAAG,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;gBACxC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;gBACnE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;YACzD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,iCAAiC,QAAQ,GAAG,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAC;YAC7D,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,8BAA8B,UAAU,GAAG,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA+B;IAE/B,IACE,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC7B,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC5B,OAAO,CAAC,QAAQ,KAAK,OAAO,EAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC;QACjC,OAAO,EAAE,OAAO,QAAQ,uCAAuC;QAC/D,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"background-service.js","sourceRoot":"","sources":["../../src/installer/background-service.ts"],"names":[],"mappings":"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"}

package/dist/installer/dev-reset.d.ts

@@ -0,0 +1,16 @@
+export interface DevResetOptions {
+    /** Remove license.json — you'll need to sign in / enter key again. */
+    wipeLicense?: boolean;
+    /** Delete all of ~/.lockin (implies wipeLicense). */
+    wipeAll?: boolean;
+    /** Remove LockIn blocks from /etc/hosts. Default true. */
+    clearHosts?: boolean;
+    /** Remove LockIn from Claude Desktop config. Only with --full. */
+    clearClaudeDesktop?: boolean;
+}
+/** Stop any LockIn MCP HTTP server bound to the standard port range. */
+export declare function killLockInHttpServers(): Promise<string[]>;
+export declare function parseDevResetArgs(argv: string[]): DevResetOptions;
+export declare function printDevResetHelp(): void;
+export declare function runDevReset(options?: DevResetOptions): Promise<void>;
+//# sourceMappingURL=dev-reset.d.ts.map

package/dist/installer/dev-reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-reset.d.ts","sourceRoot":"","sources":["../../src/installer/dev-reset.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAmCD,wEAAwE;AACxE,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAyB/D;AAsED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAiCjE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAsBxC;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE9E"}

package/dist/installer/dev-reset.js

@@ -0,0 +1,239 @@
+import { execFile } from "node:child_process";
+import { access, mkdir, rm, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import * as clack from "@clack/prompts";
+import color from "picocolors";
+import { syncHostsFile } from "../hosts-manager.js";
+import { claudeDesktopConfigPath, LOCKIN_CLAUDE_MCP_SERVER_KEY, } from "./claude-desktop-config.js";
+import { getDataDirPath } from "./data-dir.js";
+import { uninstallLegacyTunnelLaunchAgents } from "./legacy-tunnels.js";
+import { stopLockInMcpLaunchAgent } from "./mcp-cleanup.js";
+import { DEFAULT_LOCKIN_MCP_PORT, fetchLockInHealth, stopLockInListenersOnPort, } from "./port.js";
+const execFileAsync = promisify(execFile);
+const LICENSE_FILE = "license.json";
+const PARTIAL_RESET_FILES = [
+    "setup-manifest.json",
+    "relay-credentials.json",
+    "state.json",
+    "mcp.stdout.log",
+    "mcp.stderr.log",
+    "install.log",
+];
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function listenerPidsOnPort(port) {
+    const selfPid = process.pid;
+    try {
+        const { stdout } = await execFileAsync("lsof", [
+            "-nP",
+            `-iTCP:${port}`,
+            "-sTCP:LISTEN",
+            "-t",
+        ]);
+        return stdout
+            .trim()
+            .split("\n")
+            .filter(Boolean)
+            .map((value) => Number(value))
+            .filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== selfPid);
+    }
+    catch {
+        return [];
+    }
+}
+/** Stop any LockIn MCP HTTP server bound to the standard port range. */
+export async function killLockInHttpServers() {
+    const killed = [];
+    for (let offset = 0; offset < 20; offset += 1) {
+        const port = DEFAULT_LOCKIN_MCP_PORT + offset;
+        if (!(await fetchLockInHealth(port))) {
+            continue;
+        }
+        const listenerPids = await listenerPidsOnPort(port);
+        if (listenerPids.length === 0) {
+            continue;
+        }
+        for (const pid of listenerPids) {
+            killed.push(`pid ${pid} (port ${port})`);
+        }
+        await stopLockInListenersOnPort(port);
+    }
+    if (killed.length > 0) {
+        await sleep(600);
+    }
+    return killed;
+}
+async function removeClaudeDesktopEntry() {
+    const configPath = claudeDesktopConfigPath();
+    if (!(await pathExists(configPath))) {
+        return false;
+    }
+    const { readFile, writeFile } = await import("node:fs/promises");
+    const raw = await readFile(configPath, "utf8");
+    const config = JSON.parse(raw);
+    const servers = config.mcpServers && typeof config.mcpServers === "object"
+        ? config.mcpServers
+        : null;
+    if (!servers || !(LOCKIN_CLAUDE_MCP_SERVER_KEY in servers)) {
+        return false;
+    }
+    delete servers[LOCKIN_CLAUDE_MCP_SERVER_KEY];
+    config.mcpServers = servers;
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`);
+    return true;
+}
+async function wipeDataDir(options) {
+    const dataDir = getDataDirPath();
+    const removed = [];
+    if (options.wipeAll) {
+        if (await pathExists(dataDir)) {
+            await rm(dataDir, { recursive: true, force: true });
+            removed.push(dataDir);
+        }
+        await mkdir(dataDir, { recursive: true, mode: 0o700 });
+        return removed;
+    }
+    for (const name of PARTIAL_RESET_FILES) {
+        const path = join(dataDir, name);
+        if (await pathExists(path)) {
+            await unlink(path);
+            removed.push(path);
+        }
+    }
+    if (options.wipeLicense) {
+        const licensePath = join(dataDir, LICENSE_FILE);
+        if (await pathExists(licensePath)) {
+            await unlink(licensePath);
+            removed.push(licensePath);
+        }
+    }
+    return removed;
+}
+async function removeHostsSudoersHint() {
+    const sudoersPath = "/etc/sudoers.d/lockin-mcp-hosts";
+    if (process.platform !== "darwin" || !(await pathExists(sudoersPath))) {
+        return;
+    }
+    clack.log.info(color.dim(`Optional: remove passwordless hosts sudo — sudo rm ${sudoersPath}`));
+}
+export function parseDevResetArgs(argv) {
+    const options = {
+        clearHosts: true,
+    };
+    for (const arg of argv) {
+        switch (arg) {
+            case "--full":
+                options.wipeAll = true;
+                options.wipeLicense = true;
+                options.clearClaudeDesktop = true;
+                break;
+            case "--wipe-license":
+                options.wipeLicense = true;
+                break;
+            case "--no-hosts":
+                options.clearHosts = false;
+                break;
+            case "--help":
+            case "-h":
+                printDevResetHelp();
+                process.exit(0);
+                break;
+            default:
+                throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    if (options.wipeAll) {
+        options.wipeLicense = true;
+    }
+    return options;
+}
+export function printDevResetHelp() {
+    console.log(`\
+LockIn MCP — developer reset
+
+Stops background daemons and dev servers, then wipes local install state so
+the next install behaves like a fresh user machine.
+
+Usage:
+  npx lockin-mcp dev-reset [options]
+  npm run dev:reset
+
+Options:
+  --full           Delete all of ~/.lockin including license (true fresh user)
+  --wipe-license   Also remove license.json (re-auth on next install)
+  --no-hosts       Leave /etc/hosts unchanged
+  -h, --help       Show this help
+
+Workflow:
+  npm run install:fresh        # reset + wipe license + install (new-user flow)
+  npm run install:fresh:full # full ~/.lockin wipe + Claude Desktop + install
+  npm run dev:reset            # reset relay/state only (keeps license for fast iteration)
+`);
+}
+export async function runDevReset(options = {}) {
+    const clearHosts = options.clearHosts !== false;
+    clack.intro(color.bold("LockIn developer reset"));
+    const killed = await killLockInHttpServers();
+    if (killed.length > 0) {
+        clack.log.success(`Stopped LockIn HTTP server(s): ${killed.join(", ")}`);
+    }
+    else {
+        clack.log.info("No LockIn HTTP servers found on ports 3847–3866");
+    }
+    await uninstallLegacyTunnelLaunchAgents();
+    const stoppedAgent = await stopLockInMcpLaunchAgent();
+    if (stoppedAgent) {
+        clack.log.success("Stopped com.lockin.mcp LaunchAgent");
+    }
+    const removedPaths = await wipeDataDir(options);
+    if (removedPaths.length > 0) {
+        clack.log.success(options.wipeAll
+            ? `Removed ${color.cyan("~/.lockin")} and recreated empty directory`
+            : `Removed ${removedPaths.length} file(s) from ${color.cyan("~/.lockin")}`);
+    }
+    if (options.clearClaudeDesktop) {
+        const cleared = await removeClaudeDesktopEntry();
+        if (cleared) {
+            clack.log.success("Removed LockIn from Claude Desktop config");
+        }
+    }
+    if (clearHosts) {
+        try {
+            const sync = await syncHostsFile([]);
+            if (sync.method === "unchanged") {
+                clack.log.info("Hosts file had no LockIn entries");
+            }
+            else {
+                clack.log.success(`Cleared LockIn entries from /etc/hosts (${sync.method})`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            clack.log.warn(`Could not clear hosts file: ${message}`);
+        }
+    }
+    await removeHostsSudoersHint();
+    const licenseNote = options.wipeAll || options.wipeLicense
+        ? color.dim("License removed — install will prompt for sign-in or key.")
+        : color.dim("License kept — use --wipe-license or install:fresh for a new-user flow.");
+    clack.outro([
+        "Ready for a clean install.",
+        licenseNote,
+        "",
+        `  ${color.cyan("npm run install:local")}     — install from this repo`,
+        `  ${color.cyan("npm run install:prod")}     — install against production`,
+        `  ${color.cyan("npx lockin-mcp install")}  — install published package`,
+    ].join("\n"));
+}
+//# sourceMappingURL=dev-reset.js.map

package/dist/installer/dev-reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-reset.js","sourceRoot":"","sources":["../../src/installer/dev-reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,YAAY,GAAG,cAAc,CAAC;AACpC,MAAM,mBAAmB,GAAG;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,YAAY;IACZ,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;CACL,CAAC;AAaX,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;YAC7C,KAAK;YACL,SAAS,IAAI,EAAE;YACf,cAAc;YACd,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,uBAAuB,GAAG,MAAM,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,UAAU,IAAI,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,wBAAwB;IACrC,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,MAAM,OAAO,GACX,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACxD,CAAC,CAAE,MAAM,CAAC,UAAsC;QAChD,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,4BAA4B,IAAI,OAAO,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAwB;IACjD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAChD,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,sBAAsB;IACnC,MAAM,WAAW,GAAG,iCAAiC,CAAC;IACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO;IACT,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,CACZ,KAAK,CAAC,GAAG,CACP,sDAAsD,WAAW,EAAE,CACpE,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,OAAO,GAAoB;QAC/B,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;gBACvB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC3B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBAClC,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC3B,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC;gBAC3B,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,iBAAiB,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;CAoBb,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAA2B,EAAE;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC;IAEhD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,kCAAkC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,iCAAiC,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,wBAAwB,EAAE,CAAC;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,GAAG,CAAC,OAAO,CACf,OAAO,CAAC,OAAO;YACb,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,gCAAgC;YACpE,CAAC,CAAC,WAAW,YAAY,CAAC,MAAM,iBAAiB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,wBAAwB,EAAE,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,2CAA2C,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,sBAAsB,EAAE,CAAC;IAE/B,MAAM,WAAW,GACf,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW;QACpC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC;QACxE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;IAE3F,KAAK,CAAC,KAAK,CACT;QACE,4BAA4B;QAC5B,WAAW;QACX,EAAE;QACF,KAAK,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,+BAA+B;QACvE,KAAK,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,mCAAmC;QAC1E,KAAK,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,+BAA+B;KACzE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

package/dist/installer/dev-reset.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-reset.test.d.ts.map

package/dist/installer/dev-reset.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-reset.test.d.ts","sourceRoot":"","sources":["../../src/installer/dev-reset.test.ts"],"names":[],"mappings":""}

package/dist/installer/dev-reset.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { parseDevResetArgs } from "./dev-reset.js";
+describe("parseDevResetArgs", () => {
+    it("defaults to partial reset with hosts cleanup", () => {
+        expect(parseDevResetArgs([])).toEqual({
+            clearHosts: true,
+        });
+    });
+    it("enables full wipe flags", () => {
+        expect(parseDevResetArgs(["--full"])).toEqual({
+            wipeAll: true,
+            wipeLicense: true,
+            clearHosts: true,
+            clearClaudeDesktop: true,
+        });
+    });
+    it("can skip hosts cleanup", () => {
+        expect(parseDevResetArgs(["--no-hosts"])).toEqual({
+            clearHosts: false,
+        });
+    });
+});
+//# sourceMappingURL=dev-reset.test.js.map

package/dist/installer/dev-reset.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-reset.test.js","sourceRoot":"","sources":["../../src/installer/dev-reset.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,IAAI;YAChB,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAChD,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/installer/port.d.ts

@@ -1,5 +1,13 @@
 export declare const DEFAULT_LOCKIN_MCP_PORT = 3847;
+export interface LockInHealthSnapshot {
+    service: string;
+    relayConnected: boolean;
+}
+export declare function fetchLockInHealthSnapshot(port: number): Promise<LockInHealthSnapshot | null>;
 export declare function fetchLockInHealth(port: number): Promise<boolean>;
+/** Stop a LockIn MCP listener so launchd or a fresh install can recover the port. */
+export declare function stopLockInListenersOnPort(port: number): Promise<void>;
+export declare function waitForLocalRelayHealth(port: number, attempts?: number, delayMs?: number): Promise<LockInHealthSnapshot>;
 export declare function isPortAvailable(port: number): Promise<boolean>;
 export declare function describePortConflict(port: number): Promise<string | null>;
 export declare function resolveMcpPort(preferred: number): Promise<number>;

package/dist/installer/port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/installer/port.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAatE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASpE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB/E;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BvE"}
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/installer/port.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAsBtC;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtE;AAuBD,qFAAqF;AACrF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B3E;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAK,EACb,OAAO,SAAM,GACZ,OAAO,CAAC,oBAAoB,CAAC,CAY/B;AAMD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASpE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB/E;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BvE"}

package/dist/installer/port.js

@@ -1,20 +1,92 @@
+import { execFile } from "node:child_process";
 import { createServer } from "node:net";
+import { promisify } from "node:util";
 import { localHttpRequest } from "../local-http.js";
+const execFileAsync = promisify(execFile);
 export const DEFAULT_LOCKIN_MCP_PORT = 3847;
-export async function fetchLockInHealth(port) {
+export async function fetchLockInHealthSnapshot(port) {
     try {
         const response = await localHttpRequest(`http://127.0.0.1:${port}/health`, {
             timeoutMs: 2000,
         });
         if (!response.ok) {
-            return false;
+            return null;
         }
         const body = (await response.json());
-        return body.service === "lockin-mcp";
+        if (body.service !== "lockin-mcp") {
+            return null;
+        }
+        return {
+            service: body.service,
+            relayConnected: body.relay?.connected === true,
+        };
     }
     catch {
-        return false;
+        return null;
+    }
+}
+export async function fetchLockInHealth(port) {
+    return (await fetchLockInHealthSnapshot(port)) !== null;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function findListenerPids(port) {
+    try {
+        const { stdout } = await execFileAsync("lsof", [
+            "-nP",
+            `-iTCP:${port}`,
+            "-sTCP:LISTEN",
+            "-t",
+        ]);
+        return stdout
+            .split("\n")
+            .map((line) => Number(line.trim()))
+            .filter((pid) => Number.isFinite(pid) && pid > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/** Stop a LockIn MCP listener so launchd or a fresh install can recover the port. */
+export async function stopLockInListenersOnPort(port) {
+    const pids = await findListenerPids(port);
+    for (const pid of pids) {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            // already exited
+        }
     }
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+        if (await isPortAvailable(port)) {
+            return;
+        }
+        await sleep(300);
+    }
+    for (const pid of await findListenerPids(port)) {
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch {
+            // already exited
+        }
+    }
+    await sleep(300);
+}
+export async function waitForLocalRelayHealth(port, attempts = 40, delayMs = 500) {
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+        const snapshot = await fetchLockInHealthSnapshot(port);
+        if (snapshot?.relayConnected) {
+            return snapshot;
+        }
+        await sleep(delayMs);
+    }
+    throw new Error(`LockIn MCP on port ${port} never connected to relay — check ${getDataDirHint()}/mcp.stderr.log`);
+}
+function getDataDirHint() {
+    return process.platform === "win32" ? "%USERPROFILE%\\.lockin" : "~/.lockin";
 }
 export async function isPortAvailable(port) {
     return new Promise((resolve) => {

package/dist/installer/port.js.map

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

package/dist/installer/port.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=port.test.d.ts.map

package/dist/installer/port.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.test.d.ts","sourceRoot":"","sources":["../../src/installer/port.test.ts"],"names":[],"mappings":""}

package/dist/installer/port.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it, vi, afterEach } from "vitest";
+import { fetchLockInHealthSnapshot, waitForLocalRelayHealth, } from "./port.js";
+vi.mock("../local-http.js", () => ({
+    localHttpRequest: vi.fn(),
+}));
+import { localHttpRequest } from "../local-http.js";
+function mockHealthResponse(body) {
+    return {
+        ok: true,
+        status: 200,
+        headers: {},
+        text: async () => JSON.stringify(body),
+        json: async () => body,
+    };
+}
+describe("fetchLockInHealthSnapshot", () => {
+    afterEach(() => {
+        vi.mocked(localHttpRequest).mockReset();
+    });
+    it("returns relay connection state from /health", async () => {
+        vi.mocked(localHttpRequest).mockResolvedValue(mockHealthResponse({
+            service: "lockin-mcp",
+            relay: { connected: true },
+        }));
+        await expect(fetchLockInHealthSnapshot(3848)).resolves.toEqual({
+            service: "lockin-mcp",
+            relayConnected: true,
+        });
+    });
+    it("returns null for non-lockin listeners", async () => {
+        vi.mocked(localHttpRequest).mockResolvedValue(mockHealthResponse({ service: "other-app" }));
+        await expect(fetchLockInHealthSnapshot(3848)).resolves.toBeNull();
+    });
+});
+describe("waitForLocalRelayHealth", () => {
+    afterEach(() => {
+        vi.mocked(localHttpRequest).mockReset();
+    });
+    it("waits until relay.connected is true", async () => {
+        vi.mocked(localHttpRequest)
+            .mockResolvedValueOnce(mockHealthResponse({
+            service: "lockin-mcp",
+            relay: { connected: false },
+        }))
+            .mockResolvedValueOnce(mockHealthResponse({
+            service: "lockin-mcp",
+            relay: { connected: true },
+        }));
+        await expect(waitForLocalRelayHealth(3848, 5, 1)).resolves.toEqual({
+            service: "lockin-mcp",
+            relayConnected: true,
+        });
+    });
+});
+//# sourceMappingURL=port.test.js.map

package/dist/installer/port.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.test.js","sourceRoot":"","sources":["../../src/installer/port.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC1B,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,SAAS,kBAAkB,CAAC,IAAa;IACvC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QACtC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,iBAAiB,CAC3C,kBAAkB,CAAC;YACjB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3B,CAAC,CACH,CAAC;QAEF,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC7D,OAAO,EAAE,YAAY;YACrB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,iBAAiB,CAC3C,kBAAkB,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAC7C,CAAC;QAEF,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC;aACxB,qBAAqB,CACpB,kBAAkB,CAAC;YACjB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;SAC5B,CAAC,CACH;aACA,qBAAqB,CACpB,kBAAkB,CAAC;YACjB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3B,CAAC,CACH,CAAC;QAEJ,MAAM,MAAM,CACV,uBAAuB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CACpC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,YAAY;YACrB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/installer/run.js

@@ -9,9 +9,9 @@ import { canWriteHostsFile } from "../hosts-manager.js";
 import { verifyLicenseInfo } from "../license-check.js";
 import { resolveLicense } from "./license.js";
 import { detectPlatform, ensureNodeVersion } from "./platform.js";
-import { describePortConflict, resolveMcpPort } from "./port.js";
+import { describePortConflict, resolveMcpPort, stopLockInListenersOnPort, fetchLockInHealth } from "./port.js";
 import { buildPokeUrls, POKE_LOCKIN_RECIPE_URL } from "./poke.js";
-import { promptConnectAgent, promptBackgroundService, installBackgroundService } from "./agents.js";
+import { promptConnectAgent, promptBackgroundService, handoffToBackgroundService } from "./agents.js";
 import { promptInstallHostsSudoers } from "./hosts-sudo.js";
 import { uninstallLegacyTunnelLaunchAgents } from "./legacy-tunnels.js";
 import { stopLockInMcpLaunchAgent } from "./mcp-cleanup.js";
@@ -167,6 +167,10 @@ async function runInstallerInner(argv) {
     if (stoppedBackground) {
         clack.log.info("Stopped previous LockIn session for a clean setup.");
     }
+    if (await fetchLockInHealth(options.port)) {
+        await stopLockInListenersOnPort(options.port);
+        clack.log.info("Cleared previous LockIn HTTP server on this port.");
+    }
     const portConflict = await describePortConflict(options.port);
     if (portConflict) {
         const resolvedPort = await resolveMcpPort(options.port);
@@ -294,7 +298,7 @@ async function runInstallerInner(argv) {
     const hasRemoteRelay = !options.skipTunnel && remoteMcpUrl.startsWith("https://");
     const serverEntry = join(dirname(fileURLToPath(import.meta.url)), "..", "index.js");
     if (!options.nonInteractive) {
-        const installedBackground = await promptBackgroundService({
+        const wantsBackground = await promptBackgroundService({
             port: options.port,
             authToken: mcpAuthToken,
             serverEntry,
@@ -302,9 +306,21 @@ async function runInstallerInner(argv) {
             deviceId: relayCredentials?.deviceId,
             relayDeviceToken: relayCredentials?.relayDeviceToken,
         });
-        if (installedBackground) {
-            mcpProcess.kill("SIGTERM");
-            await waitForHttp(`${localMcpUrl}/health`, 20, 500);
+        let installedBackground = false;
+        if (wantsBackground) {
+            await handoffToBackgroundService({
+                mcpProcess,
+                port: options.port,
+                service: {
+                    port: options.port,
+                    authToken: mcpAuthToken,
+                    serverEntry,
+                    relayUrl: relayCredentials?.relayConnectUrl ?? relayCredentials?.relayUrl,
+                    deviceId: relayCredentials?.deviceId,
+                    relayDeviceToken: relayCredentials?.relayDeviceToken,
+                },
+            });
+            installedBackground = true;
         }
         if (hasRemoteRelay) {
             await promptConnectAgent({
@@ -325,20 +341,20 @@ async function runInstallerInner(argv) {
         }
     }
     else if (relayCredentials) {
-        const installedBackground = await installBackgroundService({
+        await handoffToBackgroundService({
+            mcpProcess,
             port: options.port,
-            authToken: mcpAuthToken,
-            serverEntry,
-            relayUrl: relayCredentials.relayConnectUrl ?? relayCredentials.relayUrl,
-            deviceId: relayCredentials.deviceId,
-            relayDeviceToken: relayCredentials.relayDeviceToken,
+            service: {
+                port: options.port,
+                authToken: mcpAuthToken,
+                serverEntry,
+                relayUrl: relayCredentials.relayConnectUrl ?? relayCredentials.relayUrl,
+                deviceId: relayCredentials.deviceId,
+                relayDeviceToken: relayCredentials.relayDeviceToken,
+            },
         });
-        if (installedBackground) {
-            mcpProcess.kill("SIGTERM");
-            await waitForHttp(`${localMcpUrl}/health`, 20, 500);
-            clack.outro(color.dim(`LockIn MCP runs in the background on port ${options.port}. Remote URL: ${remoteMcpUrl}`));
-            process.exit(0);
-        }
+        clack.outro(color.dim(`LockIn MCP runs in the background on port ${options.port}. Remote URL: ${remoteMcpUrl}`));
+        process.exit(0);
     }
     if (hasRemoteRelay) {
         clack.outro(color.dim("LockIn is running. Turn on background mode next time to close this window."));