remote-pi-app 0.7.1

package/dist/daemon/install.js

@@ -0,0 +1,547 @@
+import { execFileSync } from "node:child_process";
+import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { delimiter } from "node:path";
+import { homedir, platform, tmpdir, userInfo } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function detectPlatform() {
+    switch (platform()) {
+        case "darwin": return "macos";
+        case "linux": return "linux";
+        case "win32": return "windows";
+        default: return "unsupported";
+    }
+}
+// ── Path resolution ────────────────────────────────────────────────────────
+/**
+ * Absolute path to the supervisor's compiled entry. We resolve from
+ * `import.meta.url` (this file's location) since wherever the daemon
+ * module lives, `bin/supervisord.js` is a sibling of `daemon/` under
+ * `dist/`.
+ *
+ * After build: `dist/daemon/install.js` → `dist/bin/supervisord.js`.
+ * In dev (`tsx`): same path resolution still lands inside `src/`, which
+ * isn't directly runnable by `node` — dev install isn't expected.
+ */
+export function findSupervisorScript() {
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const daemonDir = dirname(here); // dist/daemon
+    const distRoot = dirname(daemonDir); // dist
+    return resolve(distRoot, "bin/supervisord.js");
+}
+/**
+ * Absolute path to the extension's CLI entry (`dist/index.js`). This is
+ * the file we symlink to `~/.local/bin/remote-pi` so the user can run
+ * `remote-pi <subcommand>` from any shell after installing the extension
+ * through Pi (`pi install npm:remote-pi`).
+ *
+ * Same resolution strategy as `findSupervisorScript`: from
+ * `dist/daemon/install.js` → `dist/index.js`.
+ */
+export function findRemotePiScript() {
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const daemonDir = dirname(here); // dist/daemon
+    const distRoot = dirname(daemonDir); // dist
+    return resolve(distRoot, "index.js");
+}
+export function findNodeBinary() {
+    // `process.execPath` is always absolute and points at the current Node
+    // binary. Embedding it in the service unit means the user gets the
+    // exact same Node version they invoked `remote-pi install` with — no
+    // PATH ambiguity at boot time.
+    return process.execPath;
+}
+export function findTemplate(name) {
+    // Templates ship next to the compiled `dist/` (via `files` in package.json).
+    // From `dist/daemon/install.js` go up two levels and into
+    // `service-templates/`. In the published npm tarball the layout is the
+    // same — `service-templates/` is sibling to `dist/`.
+    const here = fileURLToPath(import.meta.url); // dist/daemon/install.js
+    const pkgRoot = resolve(dirname(dirname(dirname(here)))); // package root
+    const file = name === "systemd" ? "systemd.service.template" :
+        name === "launchd" ? "launchd.plist.template" :
+            name === "vbs-launcher" ? "task-launcher.vbs.template" :
+                "task-scheduler.xml.template";
+    return resolve(pkgRoot, "service-templates", file);
+}
+// ── Service paths ──────────────────────────────────────────────────────────
+export function systemdUnitPath() {
+    return join(homedir(), ".config", "systemd", "user", "remote-pi-supervisord.service");
+}
+export function launchdPlistPath() {
+    return join(homedir(), "Library", "LaunchAgents", "dev.remotepi.supervisord.plist");
+}
+export const LAUNCHD_LABEL = "dev.remotepi.supervisord";
+/** systemd --user unit name (with `.service`) for the supervisor. */
+export const SYSTEMD_UNIT = "remote-pi-supervisord.service";
+/** Windows Task Scheduler task name (plan/40). */
+export const WINDOWS_TASK_NAME = "RemotePiSupervisor";
+/** Path of the rendered Task Scheduler XML (input to `schtasks /Create /XML`). */
+export function taskXmlPath() {
+    return join(homedir(), ".pi", "remote", "RemotePiSupervisor.xml");
+}
+/**
+ * Path of the rendered VBScript launcher the Task Scheduler action invokes
+ * via `wscript.exe` (plan/40, Windows). Launching node through this hidden
+ * wrapper is what keeps the supervisor from flashing a console window.
+ */
+export function vbsLauncherPath() {
+    return join(homedir(), ".pi", "remote", "RemotePiSupervisorLauncher.vbs");
+}
+/**
+ * Combined stdout/stderr log for the Windows supervisor. The Task Scheduler
+ * launches it hidden via wscript, so without this redirect its output (and the
+ * forwarded daemon-child stderr) would vanish — mirrors launchd/systemd, which
+ * already log to `~/.pi/remote/supervisord.log`.
+ */
+export function supervisordLogPath() {
+    return join(homedir(), ".pi", "remote", "supervisord.log");
+}
+export function defaultRenderVars() {
+    return {
+        node: findNodeBinary(),
+        supervisor: findSupervisorScript(),
+        home: homedir(),
+        user: userInfo().username,
+        path: process.env["PATH"] ?? "/usr/local/bin:/usr/bin:/bin",
+        vbs: vbsLauncherPath(),
+        logPath: supervisordLogPath(),
+    };
+}
+/** Replace `{NODE}` / `{SUPERVISOR}` / `{USER}` / `{HOME}` / `{PATH}` / `{VBS}` / `{LOG}`. */
+export function renderTemplate(template, vars) {
+    return template
+        .replace(/\{NODE\}/g, vars.node)
+        .replace(/\{SUPERVISOR\}/g, vars.supervisor)
+        .replace(/\{USER\}/g, vars.user)
+        .replace(/\{HOME\}/g, vars.home)
+        .replace(/\{PATH\}/g, vars.path)
+        .replace(/\{VBS\}/g, vars.vbs)
+        .replace(/\{LOG\}/g, vars.logPath);
+}
+/**
+ * Writes the unit/plist, runs the platform's activation command. Throws
+ * on unsupported OS or when the supervisor script isn't found.
+ *
+ * Idempotent: re-running re-writes the unit (paths could have changed)
+ * and re-activates via the platform tool's idempotent flag.
+ */
+export function installService(vars = defaultRenderVars()) {
+    const plat = detectPlatform();
+    const log = [];
+    if (plat === "unsupported") {
+        throw new Error(`unsupported platform: ${platform()}. Only macOS, Linux, and Windows.`);
+    }
+    // Sanity: supervisor script must exist on disk.
+    if (!existsSync(vars.supervisor)) {
+        throw new Error(`supervisor script not found at ${vars.supervisor}. ` +
+            "Run `pnpm build` (dev) or `npm install -g remote-pi` (prod) first.");
+    }
+    const templateName = plat === "macos" ? "launchd" : plat === "linux" ? "systemd" : "taskscheduler";
+    const templatePath = findTemplate(templateName);
+    if (!existsSync(templatePath)) {
+        throw new Error(`service template missing: ${templatePath}`);
+    }
+    const tpl = readFileSync(templatePath, "utf8");
+    const rendered = renderTemplate(tpl, vars);
+    const unitPath = plat === "macos" ? launchdPlistPath() : plat === "linux" ? systemdUnitPath() : taskXmlPath();
+    mkdirSync(dirname(unitPath), { recursive: true });
+    if (plat === "windows") {
+        // `schtasks /Create /XML` requires UTF-16LE + BOM. A UTF-8 file fails with
+        // "(1,40)::ERROR: unable to switch the encoding" — the bytes must match the
+        // template's `encoding="UTF-16"` declaration. (plan/40 risk #5.)
+        const bom = Buffer.from([0xff, 0xfe]); // UTF-16LE byte-order mark
+        writeFileSync(unitPath, Buffer.concat([bom, Buffer.from(rendered, "utf16le")]));
+    }
+    else {
+        writeFileSync(unitPath, rendered); // launchd/systemd → UTF-8
+    }
+    log.push(`wrote ${unitPath}`);
+    if (plat === "macos") {
+        // Unload first in case a stale entry exists from a prior install —
+        // `launchctl bootstrap` errors out otherwise. `bootout` is the modern
+        // API; `unload` is the legacy fallback. Either may fail silently.
+        const uid = userInfo().uid;
+        _tryExec("launchctl", ["bootout", `gui/${uid}`, unitPath], log);
+        _tryExec("launchctl", ["unload", unitPath], log);
+        _exec("launchctl", ["bootstrap", `gui/${uid}`, unitPath], log);
+        log.push(`activated via launchctl bootstrap gui/${uid}`);
+    }
+    else if (plat === "linux") {
+        _exec("systemctl", ["--user", "daemon-reload"], log);
+        _exec("systemctl", ["--user", "enable", "--now", "remote-pi-supervisord.service"], log);
+        log.push("activated via systemctl --user enable --now");
+    }
+    else {
+        // windows — Task Scheduler (plan/40). The action runs `wscript.exe
+        // <launcher.vbs>` (not node directly) so the supervisor starts hidden,
+        // with no console window. Render + write that launcher first.
+        const vbsTpl = findTemplate("vbs-launcher");
+        if (!existsSync(vbsTpl))
+            throw new Error(`vbs launcher template missing: ${vbsTpl}`);
+        const vbsPath = vars.vbs;
+        writeFileSync(vbsPath, renderTemplate(readFileSync(vbsTpl, "utf8"), vars));
+        log.push(`wrote ${vbsPath}`);
+        // Only `schtasks /Create` modifies the root task store → that single op
+        // needs admin (elevate it via UAC). `/End` (stop a prior instance) and
+        // `/Run` (start it) act on a task we already own and work un-elevated — the
+        // very ops `remote-pi restart-supervisor` runs without elevation. Keeping
+        // them un-elevated narrows the admin surface to the one operation that
+        // truly requires it.
+        _tryExec("schtasks", ["/End", "/TN", WINDOWS_TASK_NAME], log);
+        _execElevatedWindows([
+            `schtasks /Create /XML "${unitPath}" /TN ${WINDOWS_TASK_NAME} /F`,
+        ], log);
+        _exec("schtasks", ["/Run", "/TN", WINDOWS_TASK_NAME], log);
+        log.push(`activated via schtasks /Create (elevated) + /Run (${WINDOWS_TASK_NAME})`);
+    }
+    return { platform: plat, unitPath, log };
+}
+export function uninstallService() {
+    const plat = detectPlatform();
+    const log = [];
+    if (plat === "unsupported") {
+        throw new Error(`unsupported platform: ${platform()}. Only macOS, Linux, and Windows.`);
+    }
+    const unitPath = plat === "macos" ? launchdPlistPath() : plat === "linux" ? systemdUnitPath() : taskXmlPath();
+    if (plat === "macos") {
+        const uid = userInfo().uid;
+        _tryExec("launchctl", ["bootout", `gui/${uid}`, unitPath], log);
+        _tryExec("launchctl", ["unload", unitPath], log);
+        log.push("deactivated via launchctl bootout");
+    }
+    else if (plat === "linux") {
+        _tryExec("systemctl", ["--user", "disable", "--now", "remote-pi-supervisord.service"], log);
+        log.push("deactivated via systemctl --user disable --now");
+    }
+    else {
+        // windows — Task Scheduler (plan/40): stop + delete the task. Only
+        // `/Delete` modifies the root task store → that's the op that needs admin.
+        // `/End` stops the running task and works un-elevated (own task), like
+        // restart-supervisor. `exit /b 0` keeps uninstall best-effort: a missing
+        // task (already removed) is success, not an error.
+        _tryExec("schtasks", ["/End", "/TN", WINDOWS_TASK_NAME], log);
+        _execElevatedWindows([
+            `schtasks /Delete /TN ${WINDOWS_TASK_NAME} /F`,
+            `exit /b 0`,
+        ], log);
+        log.push(`deactivated via elevated schtasks /Delete (${WINDOWS_TASK_NAME})`);
+    }
+    let removed = false;
+    if (existsSync(unitPath)) {
+        try {
+            unlinkSync(unitPath);
+            removed = true;
+            log.push(`removed ${unitPath}`);
+        }
+        catch (e) {
+            log.push(`failed to remove ${unitPath}: ${String(e)}`);
+        }
+    }
+    // Windows: also drop the hidden VBScript launcher we wrote alongside the XML.
+    if (plat === "windows") {
+        const vbsPath = vbsLauncherPath();
+        if (existsSync(vbsPath)) {
+            try {
+                unlinkSync(vbsPath);
+                log.push(`removed ${vbsPath}`);
+            }
+            catch (e) {
+                log.push(`failed to remove ${vbsPath}: ${String(e)}`);
+            }
+        }
+    }
+    if (plat === "linux") {
+        _tryExec("systemctl", ["--user", "daemon-reload"], log);
+    }
+    // Hint about the label for users that want to verify manually.
+    if (plat === "macos")
+        log.push(`(label: ${LAUNCHD_LABEL})`);
+    return { platform: plat, unitPath, removed, log };
+}
+// ── Internals ──────────────────────────────────────────────────────────────
+function _exec(cmd, args, log) {
+    try {
+        const out = execFileSync(cmd, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        if (out.trim())
+            log.push(`$ ${cmd} ${args.join(" ")}\n${out.trim()}`);
+        else
+            log.push(`$ ${cmd} ${args.join(" ")}`);
+    }
+    catch (e) {
+        const err = e;
+        const stderr = typeof err.stderr === "string" ? err.stderr : err.stderr?.toString() ?? "";
+        throw new Error(`\`${cmd} ${args.join(" ")}\` exited ${err.status ?? "?"}\n${stderr.trim() || err.message}`);
+    }
+}
+/** Like _exec but swallows errors — used for cleanup steps where failure
+ *  is expected (e.g., "unload" before "load" when nothing was loaded). */
+function _tryExec(cmd, args, log) {
+    try {
+        _exec(cmd, args, log);
+    }
+    catch { /* expected, suppress */ }
+}
+// ── Windows elevation (plan/40) ────────────────────────────────────────────
+//
+// `schtasks /Create` and `/Delete` register/remove the task in the root folder,
+// which requires administrator rights. We can't elevate the current Node
+// process, so we render the schtasks sequence into a temp `.cmd`, run it
+// through an elevated `cmd.exe` via PowerShell `Start-Process -Verb RunAs`
+// (one UAC prompt), and read the output back from a log file the script
+// redirects into.
+/**
+ * Build the batch script run elevated. Each command line redirects its output
+ * to `logFile` so the (separate, elevated) process's output can be read back by
+ * the parent. Control-flow lines (`if`/`exit`/`rem`/`@`) run bare — redirecting
+ * them would swallow the exit code. Pure + exported for tests.
+ */
+export function buildElevatedCmd(lines, logFile) {
+    const redirect = ` >> "${logFile}" 2>&1`;
+    const body = lines.map((ln) => /^\s*(if|exit|rem|@)/i.test(ln) ? ln : ln + redirect);
+    return ["@echo off", ...body].join("\r\n") + "\r\n";
+}
+function _readIfExists(p) {
+    try {
+        return readFileSync(p, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Run a schtasks command sequence elevated (UAC). Throws a clear error when the
+ * prompt is declined or the task operation fails (`Start-Process -Verb RunAs`
+ * throws → PowerShell exits non-zero → `execFileSync` throws). Captured schtasks
+ * output is appended to `log` either way.
+ */
+function _execElevatedWindows(lines, log) {
+    const base = join(tmpdir(), `remote-pi-elevate-${process.pid}`);
+    const cmdPath = `${base}.cmd`;
+    const logFile = `${base}.log`;
+    writeFileSync(cmdPath, buildElevatedCmd(lines, logFile));
+    try {
+        unlinkSync(logFile);
+    }
+    catch { /* none yet */ }
+    let thrown = null;
+    try {
+        execFileSync("powershell", [
+            "-NoProfile", "-NonInteractive", "-Command",
+            `$p = Start-Process -FilePath cmd.exe -ArgumentList '/c','"${cmdPath}"' ` +
+                "-Verb RunAs -Wait -PassThru -WindowStyle Hidden; exit $p.ExitCode",
+        ], { stdio: ["ignore", "pipe", "pipe"] });
+    }
+    catch (e) {
+        thrown = e;
+    }
+    const out = _readIfExists(logFile).trim();
+    if (out)
+        log.push(out);
+    try {
+        unlinkSync(cmdPath);
+    }
+    catch { /* best-effort */ }
+    try {
+        unlinkSync(logFile);
+    }
+    catch { /* best-effort */ }
+    if (thrown) {
+        throw new Error("administrator privileges required — the UAC prompt was declined or the " +
+            "schtasks operation failed. Run the command again and accept the Windows " +
+            `elevation prompt.${out ? `\n${out}` : ""}`);
+    }
+}
+export function userLocalBinDir(home = homedir()) {
+    return join(home, ".local", "bin");
+}
+/**
+ * Check whether `dir` is on `process.env.PATH`. Tolerates trailing
+ * slashes and relative entries (which we treat as not matching — `~/.local/bin`
+ * is always absolute on our end).
+ */
+export function isOnPath(dir, envPath = process.env["PATH"] ?? "") {
+    const target = dir.replace(/\/+$/, "");
+    return envPath.split(delimiter).some((entry) => entry.replace(/\/+$/, "") === target);
+}
+/**
+ * Create (or refresh) the `remote-pi` + `pi-supervisord` symlinks in
+ * `~/.local/bin/`. Idempotent — replaces stale links pointing at old
+ * extension paths (Pi can reinstall the extension to a different hash dir
+ * on upgrades, so this MUST overwrite).
+ *
+ * Returns `onPath: false` when `~/.local/bin` isn't in the user's `$PATH`.
+ * The caller is responsible for surfacing the shell-rc instruction —
+ * we don't edit the user's shell config files automatically.
+ */
+export function linkCliBinaries(home = homedir(), paths = {}, opts = {}) {
+    const binDir = userLocalBinDir(home);
+    // Windows (plan/40): no POSIX symlinks. Installing via Pi (`pi install
+    // npm:remote-pi`) never reaches PATH, so write real `.cmd` shims into
+    // `~/.local/bin` and add that dir to the user's PATH (HKCU — no admin).
+    if (platform() === "win32") {
+        return _linkCliBinariesWindows(home, binDir, paths, opts);
+    }
+    const log = [];
+    mkdirSync(binDir, { recursive: true });
+    log.push(`ensured ${binDir}`);
+    const remotePi = paths.remotePi ?? findRemotePiScript();
+    const supervisord = paths.supervisord ?? findSupervisorScript();
+    if (!existsSync(remotePi)) {
+        throw new Error(`remote-pi script not found at ${remotePi}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    if (!existsSync(supervisord)) {
+        throw new Error(`supervisor script not found at ${supervisord}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    // tsc strips the executable bit on its outputs; the shebang at the top
+    // of dist/index.js means the file IS a valid interpreter target once
+    // chmod +x is applied. Same for supervisord.js (no shebang — we rely
+    // on `node` resolving via the symlink at exec time).
+    try {
+        chmodSync(remotePi, 0o755);
+    }
+    catch { /* best-effort */ }
+    try {
+        chmodSync(supervisord, 0o755);
+    }
+    catch { /* best-effort */ }
+    const links = [
+        { name: "remote-pi", path: join(binDir, "remote-pi"), target: remotePi },
+        { name: "pi-supervisord", path: join(binDir, "pi-supervisord"), target: supervisord },
+    ];
+    for (const link of links) {
+        _replaceSymlink(link.path, link.target, log);
+    }
+    const onPath = isOnPath(binDir);
+    if (!onPath) {
+        log.push(`WARNING: ${binDir} is not on $PATH. ` +
+            `Add this line to your shell rc (~/.zshrc, ~/.bashrc, etc.): ` +
+            `export PATH="$HOME/.local/bin:$PATH"`);
+    }
+    return { binDir, links, onPath, log };
+}
+/**
+ * Windows variant of `linkCliBinaries`: writes `remote-pi.cmd` +
+ * `pi-supervisord.cmd` shims into `~/.local/bin` and ensures that dir is on the
+ * user's PATH (User scope — no admin). `opts.node` overrides the node binary
+ * (tests); `opts.mutatePath === false` skips the real PATH mutation (tests).
+ */
+function _linkCliBinariesWindows(home, binDir, paths, opts) {
+    void home;
+    const log = [];
+    mkdirSync(binDir, { recursive: true });
+    log.push(`ensured ${binDir}`);
+    const node = opts.node ?? findNodeBinary();
+    const remotePi = paths.remotePi ?? findRemotePiScript();
+    const supervisord = paths.supervisord ?? findSupervisorScript();
+    if (!existsSync(remotePi)) {
+        throw new Error(`remote-pi script not found at ${remotePi}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    if (!existsSync(supervisord)) {
+        throw new Error(`supervisor script not found at ${supervisord}. ` +
+            "Run `pnpm build` (dev) or reinstall the extension.");
+    }
+    const links = [
+        { name: "remote-pi.cmd", path: join(binDir, "remote-pi.cmd"), target: remotePi },
+        { name: "pi-supervisord.cmd", path: join(binDir, "pi-supervisord.cmd"), target: supervisord },
+    ];
+    for (const link of links) {
+        writeFileSync(link.path, buildCmdShim(node, link.target));
+        log.push(`wrote ${link.path}`);
+    }
+    const onPath = isOnPath(binDir);
+    if (!onPath && opts.mutatePath !== false) {
+        try {
+            _addUserPath(binDir);
+            log.push(`added ${binDir} to your user PATH — open a NEW terminal for \`remote-pi\` to resolve.`);
+        }
+        catch (e) {
+            log.push(`WARNING: ${binDir} is not on PATH and auto-add failed (${String(e)}). ` +
+                `Add it manually: setx PATH "%PATH%;${binDir}"`);
+        }
+    }
+    return { binDir, links, onPath, log };
+}
+/** A Windows `.cmd` shim that forwards all args to `node "<target>"`. Pure. */
+export function buildCmdShim(node, target) {
+    return `@echo off\r\n"${node}" "${target}" %*\r\n`;
+}
+/**
+ * Append `dir` to the User-scope PATH via PowerShell (HKCU\Environment — no
+ * admin). Idempotent: skips when `dir` is already an exact PATH segment. Single-
+ * quoted PS literal (backslashes are literal in PS single quotes) with embedded
+ * `'` doubled.
+ */
+function _addUserPath(dir) {
+    const lit = `'${dir.replace(/'/g, "''")}'`;
+    execFileSync("powershell", [
+        "-NoProfile", "-NonInteractive", "-Command",
+        `$d = ${lit}; ` +
+            "$p = [Environment]::GetEnvironmentVariable('Path','User'); " +
+            "if (-not $p) { $p = '' }; " +
+            "$parts = $p.Split(';') | Where-Object { $_ -ne '' }; " +
+            "if ($parts -notcontains $d) { " +
+            "[Environment]::SetEnvironmentVariable('Path', (($parts + $d) -join ';'), 'User') }",
+    ], { stdio: ["ignore", "pipe", "pipe"] });
+}
+export function unlinkCliBinaries(home = homedir()) {
+    const binDir = userLocalBinDir(home);
+    const log = [];
+    // Windows shims are `.cmd` files (linkCliBinaries writes those); POSIX uses
+    // extensionless symlinks. Match what was actually created on this platform.
+    const names = platform() === "win32"
+        ? ["remote-pi.cmd", "pi-supervisord.cmd"]
+        : ["remote-pi", "pi-supervisord"];
+    const removed = [];
+    for (const name of names) {
+        const path = join(binDir, name);
+        let existed = false;
+        try {
+            // lstatSync (not stat) so a symlink targeting a deleted file still
+            // resolves — we want to remove the LINK itself, not chase it.
+            lstatSync(path);
+            existed = true;
+        }
+        catch { /* not present */ }
+        if (existed) {
+            try {
+                unlinkSync(path);
+                log.push(`removed ${path}`);
+            }
+            catch (e) {
+                log.push(`failed to remove ${path}: ${String(e)}`);
+                existed = false;
+            }
+        }
+        removed.push({ name, path, existed });
+    }
+    return { binDir, removed, log };
+}
+/**
+ * Atomic-ish symlink replace. Idiomatic recipe — `symlinkSync` errors
+ * with `EEXIST` if the path is already a symlink/file, so we remove
+ * first. Race window between unlink and symlink is irrelevant for a
+ * single-user install command (no concurrent writers).
+ */
+function _replaceSymlink(linkPath, target, log) {
+    let existing = null;
+    try {
+        existing = readlinkSync(linkPath);
+    }
+    catch { /* not a symlink, or doesn't exist */ }
+    if (existing === target) {
+        log.push(`symlink ${linkPath} → ${target} (unchanged)`);
+        return;
+    }
+    // Either it doesn't exist, or it points elsewhere. Remove + recreate.
+    try {
+        unlinkSync(linkPath);
+    }
+    catch { /* fine if absent */ }
+    symlinkSync(target, linkPath);
+    log.push(`symlink ${linkPath} → ${target}`);
+}
+//# sourceMappingURL=install.js.map

package/dist/daemon/install.js.map

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

package/dist/daemon/registry.d.ts

@@ -0,0 +1,63 @@
+export interface DaemonEntry {
+    /** Absolute realpath of the cwd this daemon manages. */
+    cwd: string;
+    /**
+     * Display name (mesh `agent_name`). Persisted here because the supervisor
+     * now injects the daemon's config via `REMOTE_PI_DIRECT_CONFIG` at spawn
+     * instead of reading a per-cwd `.pi/remote-pi/config.json`. Legacy entries
+     * (cwd only) fall back to `defaultAgentName(cwd)`.
+     */
+    name?: string;
+}
+export interface DaemonRegistry {
+    daemons: DaemonEntry[];
+}
+/**
+ * Normalizes a user-provided path: expands `~`/`~/...`, resolves relative
+ * components against `process.cwd()`, and runs `realpath` to canonicalize
+ * symlinks. Throws if the resulting path doesn't exist on disk.
+ *
+ * `/remote-pi create` always stores normalized paths so two registrations
+ * of the same logical folder via different aliases produce a single entry.
+ */
+export declare function normalizeCwd(input: string): string;
+/** Reads the registry, returning an empty one when the file is absent. */
+export declare function loadRegistry(): DaemonRegistry;
+export declare function saveRegistry(reg: DaemonRegistry): void;
+/**
+ * Adds a daemon entry. Refuses duplicates (same normalized cwd already
+ * present). Returns the derived id + normalized cwd so the caller can
+ * report it back to the user.
+ */
+export declare function addDaemon(rawCwd: string, name?: string): {
+    id: string;
+    cwd: string;
+    name: string;
+};
+/**
+ * Removes the daemon entry whose derived id matches `id`. Returns the
+ * removed cwd (if any). Does NOT touch the cwd's local config — `create`
+ * the same cwd later restores the registration idempotently.
+ */
+export declare function removeDaemon(id: string): {
+    removed: boolean;
+    cwd?: string;
+};
+/** Snapshot of all registered daemons with derived ids. Order matches the
+ *  file's insertion order — first-registered first. */
+export declare function listDaemons(): Array<{
+    id: string;
+    cwd: string;
+    name: string;
+}>;
+/**
+ * One-shot migration: backfill `name` (folder-derived) into legacy entries
+ * that predate the name field, persisting the change to `daemons.json`.
+ * Idempotent — writes only when something was missing. Returns how many
+ * entries were backfilled. The supervisor runs this on start.
+ */
+export declare function migrateRegistryNames(): number;
+/** Test/diag-only: returns the on-disk path. Exported so tests can poke
+ *  at it (e.g. tmpdir override is done via env, but for now the path is
+ *  hardcoded to ~/.pi/remote/daemons.json). */
+export declare function registryPath(): string;