devharness 0.8.0

package/build/runners/native-runner.js

@@ -0,0 +1,370 @@
+/**
+ * Native Runner
+ * Runs processes directly using Node.js spawn (the original behavior)
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { debugLog } from '../debug-logger.js';
+import { getOutputPath } from '../helpers/paths.js';
+import { readProcessStartTime } from '../server-claims.js';
+export class NativeRunner {
+    type = 'native';
+    id;
+    command = '';
+    cwd = '';
+    process = null;
+    pid = -1;
+    port = null;
+    startedAt = null;
+    /** OS-reported start time of `pid`, to detect a recycled pid. */
+    pidStartedAt = '';
+    logCursor = { stdout: 0, stderr: 0 };
+    global = false;
+    constructor(id) {
+        this.id = id;
+    }
+    /**
+     * Set whether this runner uses global storage
+     */
+    setGlobal(global) {
+        this.global = global;
+    }
+    /**
+     * Restore state from persisted data (for recovery)
+     */
+    restore(data) {
+        this.command = data.command;
+        this.cwd = data.cwd;
+        this.pid = data.pid;
+        this.pidStartedAt = data.pidStartedAt ?? '';
+        this.port = data.port ?? null;
+        this.startedAt = new Date(data.startedAt);
+        this.global = data.global ?? false;
+        this.process = null; // Attached, not owned
+    }
+    getLogDir() {
+        return getOutputPath('logs', this.id, { global: this.global });
+    }
+    getStdoutLogPath() {
+        return path.join(this.getLogDir(), 'stdout.log');
+    }
+    getStderrLogPath() {
+        return path.join(this.getLogDir(), 'stderr.log');
+    }
+    async ensureLogDir() {
+        const dir = this.getLogDir();
+        if (!fs.existsSync(dir)) {
+            await fs.promises.mkdir(dir, { recursive: true });
+        }
+    }
+    /**
+     * PROCESS IDENTITY
+     *
+     * `kill(pid, 0)` only answers "is some process wearing this number", which
+     * is not the same question. A dev server that crashed leaves its pid behind
+     * in servers.json, and once the OS recycles that number the dead server
+     * reads as running: it gets recovered instead of restarted, autoRun never
+     * fires, and `server list` reports a corpse as live.
+     *
+     * So a pid recovered from disk is only trusted when the OS still reports the
+     * same start time for it. An unreadable start time on either side cannot
+     * disprove anything, so it counts as alive - the cost of being wrong that way
+     * is a server we decline to touch, rather than one we wrongly declare dead.
+     */
+    isProcessRunning(pid) {
+        if (pid <= 0)
+            return false;
+        try {
+            process.kill(pid, 0);
+        }
+        catch (err) {
+            // EPERM means it exists but belongs to another user - still running.
+            if (err?.code !== 'EPERM')
+                return false;
+        }
+        if (!this.pidStartedAt)
+            return true;
+        const currentStart = readProcessStartTime(pid);
+        if (!currentStart)
+            return true;
+        return currentStart === this.pidStartedAt;
+    }
+    detectPortFromLine(line) {
+        const patterns = [
+            /(?:port|listening on|localhost:|127\.0\.0\.1:)\s*(\d{4,5})/i,
+            /http:\/\/(?:localhost|127\.0\.0\.1):(\d{4,5})/i,
+            /Local:\s*http:\/\/[^:]+:(\d{4,5})/i,
+            /ready on\s+.*:(\d{4,5})/i,
+            /->\s*http:\/\/[^:]+:(\d{4,5})/i,
+            /server.*running.*:(\d{4,5})/i,
+        ];
+        for (const pattern of patterns) {
+            const match = line.match(pattern);
+            if (match) {
+                return parseInt(match[1], 10);
+            }
+        }
+        return null;
+    }
+    async start(options) {
+        const { command, cwd, env } = options;
+        this.command = command;
+        this.cwd = cwd;
+        // Validate cwd exists
+        if (!fs.existsSync(cwd)) {
+            throw new Error(`Working directory does not exist: ${cwd}`);
+        }
+        await debugLog('NativeRunner', `Starting: ${command} in ${cwd}`);
+        // Ensure log directory exists
+        await this.ensureLogDir();
+        // Open log files for writing
+        const stdoutPath = this.getStdoutLogPath();
+        const stderrPath = this.getStderrLogPath();
+        // Add restart marker to logs
+        const timestamp = new Date().toISOString();
+        const marker = `\n--- Server ${this.id} started at ${timestamp} ---\n`;
+        await fs.promises.appendFile(stdoutPath, marker, 'utf-8');
+        await fs.promises.appendFile(stderrPath, marker, 'utf-8');
+        const stdoutFd = fs.openSync(stdoutPath, 'a');
+        const stderrFd = fs.openSync(stderrPath, 'a');
+        // Spawn with stdio redirected to files
+        const serverProcess = spawn(command, [], {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: ['ignore', stdoutFd, stderrFd],
+            shell: true,
+            detached: true,
+        });
+        // Close file descriptors in parent process
+        fs.closeSync(stdoutFd);
+        fs.closeSync(stderrFd);
+        const pid = serverProcess.pid || -1;
+        if (pid === -1) {
+            throw new Error('Failed to spawn server process');
+        }
+        // Unref so parent can exit independently
+        serverProcess.unref();
+        this.process = serverProcess;
+        this.pid = pid;
+        this.pidStartedAt = readProcessStartTime(pid);
+        this.startedAt = new Date();
+        this.logCursor = { stdout: 0, stderr: 0 };
+        await debugLog('NativeRunner', `Started: ${this.id} (PID: ${pid})`);
+        return { pid };
+    }
+    async stop(options) {
+        const timeout = options?.timeout ?? 3000;
+        if (!this.isProcessRunning(this.pid)) {
+            this.pid = -1;
+            this.pidStartedAt = '';
+            this.process = null;
+            return;
+        }
+        await debugLog('NativeRunner', `Stopping ${this.id} (PID: ${this.pid})`);
+        // Kill process group
+        try {
+            process.kill(-this.pid, 'SIGTERM');
+            await debugLog('NativeRunner', `Sent SIGTERM to process group -${this.pid}`);
+        }
+        catch (err) {
+            await debugLog('NativeRunner', `Process group kill failed, trying single process: ${err}`);
+            try {
+                process.kill(this.pid, 'SIGTERM');
+            }
+            catch {
+                // Process may already be dead
+            }
+        }
+        // Wait for exit or force kill
+        await new Promise((resolve) => {
+            const checkDead = () => {
+                if (!this.isProcessRunning(this.pid)) {
+                    resolve();
+                    return true;
+                }
+                return false;
+            };
+            if (checkDead())
+                return;
+            const timeoutId = setTimeout(async () => {
+                clearInterval(interval);
+                if (this.isProcessRunning(this.pid)) {
+                    await debugLog('NativeRunner', `${this.id} didn't exit gracefully, sending SIGKILL`);
+                    try {
+                        process.kill(-this.pid, 'SIGKILL');
+                    }
+                    catch {
+                        try {
+                            process.kill(this.pid, 'SIGKILL');
+                        }
+                        catch {
+                            // Already dead
+                        }
+                    }
+                }
+                resolve();
+            }, timeout);
+            const interval = setInterval(() => {
+                if (checkDead()) {
+                    clearTimeout(timeoutId);
+                    clearInterval(interval);
+                }
+            }, 100);
+        });
+        this.pid = -1;
+        this.pidStartedAt = '';
+        this.process = null;
+        await debugLog('NativeRunner', `Stopped ${this.id}`);
+    }
+    async isRunning() {
+        return this.isProcessRunning(this.pid);
+    }
+    async getStatus() {
+        const running = this.isProcessRunning(this.pid);
+        // A pid that no longer names this server is worse than no pid at all: it
+        // is what gets persisted to servers.json, shown in `server list`, and read
+        // back by the next session. Forget it the moment we know it is stale, so
+        // the recorded state stops pointing at a process that isn't there.
+        if (!running && this.pid > 0) {
+            void debugLog('NativeRunner', `${this.id} is no longer running as PID ${this.pid}; clearing it`);
+            this.pid = -1;
+            this.pidStartedAt = '';
+        }
+        return {
+            running,
+            pid: this.pid,
+            pidStartedAt: this.pidStartedAt || undefined,
+            port: this.port ?? undefined,
+            startedAt: this.startedAt ?? undefined,
+        };
+    }
+    async getLogs(options) {
+        const { type = 'all', lines, since } = options ?? {};
+        const readLogFile = (filePath, cursorPos) => {
+            try {
+                if (!fs.existsSync(filePath))
+                    return [];
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const allLines = content.split('\n').filter(l => l.length > 0);
+                if (lines !== undefined) {
+                    return allLines.slice(-lines);
+                }
+                else if (since !== undefined) {
+                    return allLines.slice(since);
+                }
+                else {
+                    // Delta mode - return lines since cursor
+                    return allLines.slice(cursorPos);
+                }
+            }
+            catch {
+                return [];
+            }
+        };
+        let result = [];
+        if (type === 'stdout' || type === 'all') {
+            const stdoutLogs = readLogFile(this.getStdoutLogPath(), this.logCursor.stdout);
+            result = result.concat(stdoutLogs.map(l => type === 'all' ? `[out] ${l}` : l));
+        }
+        if (type === 'stderr' || type === 'all') {
+            const stderrLogs = readLogFile(this.getStderrLogPath(), this.logCursor.stderr);
+            result = result.concat(stderrLogs.map(l => type === 'all' ? `[err] ${l}` : l));
+        }
+        // Update cursor if delta mode
+        if (lines === undefined && since === undefined) {
+            this.logCursor.stdout = this.countFileLines(this.getStdoutLogPath());
+            this.logCursor.stderr = this.countFileLines(this.getStderrLogPath());
+        }
+        return result;
+    }
+    countFileLines(filePath) {
+        try {
+            if (!fs.existsSync(filePath))
+                return 0;
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return content.split('\n').filter(l => l.length > 0).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async detectPort() {
+        // Always scan logs for the latest port (in case server picked a different port on restart)
+        for (const logPath of [this.getStdoutLogPath(), this.getStderrLogPath()]) {
+            try {
+                if (fs.existsSync(logPath)) {
+                    const content = await fs.promises.readFile(logPath, 'utf-8');
+                    // Scan from the end to find the most recent port
+                    const lines = content.split('\n').reverse();
+                    for (const line of lines) {
+                        const port = this.detectPortFromLine(line);
+                        if (port) {
+                            this.port = port;
+                            return port;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+        return this.port;
+    }
+    async cleanup() {
+        // Nothing special to clean up for native runner
+    }
+    /**
+     * Initialize cursor to end of file (for recovered servers)
+     */
+    async initializeCursorToEOF() {
+        this.logCursor.stdout = this.countFileLines(this.getStdoutLogPath());
+        this.logCursor.stderr = this.countFileLines(this.getStderrLogPath());
+    }
+    /**
+     * Clear log files
+     */
+    async clearLogs() {
+        const logDir = this.getLogDir();
+        const stdoutPath = this.getStdoutLogPath();
+        const stderrPath = this.getStderrLogPath();
+        await fs.promises.writeFile(stdoutPath, '', 'utf-8');
+        await fs.promises.writeFile(stderrPath, '', 'utf-8');
+        this.logCursor = { stdout: 0, stderr: 0 };
+        return { logDir, stdoutPath, stderrPath };
+    }
+    /**
+     * Get log access info
+     */
+    getLogAccess() {
+        return {
+            type: 'file',
+            logDir: this.getLogDir(),
+            stdoutPath: this.getStdoutLogPath(),
+            stderrPath: this.getStderrLogPath(),
+        };
+    }
+    /**
+     * Get log stats for status line
+     */
+    getLogStats() {
+        const stdoutLines = this.countFileLines(this.getStdoutLogPath());
+        const stderrLines = this.countFileLines(this.getStderrLogPath());
+        return {
+            newStdout: Math.max(0, stdoutLines - this.logCursor.stdout),
+            newStderr: Math.max(0, stderrLines - this.logCursor.stderr),
+        };
+    }
+    /** Getters for state persistence */
+    getId() { return this.id; }
+    getCommand() { return this.command; }
+    getCwd() { return this.cwd; }
+    getPid() { return this.pid; }
+    getPidStartedAt() { return this.pidStartedAt; }
+    getPort() { return this.port; }
+    getStartedAt() { return this.startedAt; }
+    /** Setters for port (when detected externally) */
+    setPort(port) { this.port = port; }
+}
+//# sourceMappingURL=native-runner.js.map

package/build/runners/native-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-runner.js","sourceRoot":"","sources":["../../src/runners/native-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAgB,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAY3D,MAAM,OAAO,YAAY;IACd,IAAI,GAAe,QAAQ,CAAC;IAE7B,EAAE,CAAS;IACX,OAAO,GAAW,EAAE,CAAC;IACrB,GAAG,GAAW,EAAE,CAAC;IACjB,OAAO,GAAwB,IAAI,CAAC;IACpC,GAAG,GAAW,CAAC,CAAC,CAAC;IACjB,IAAI,GAAkB,IAAI,CAAC;IAC3B,SAAS,GAAgB,IAAI,CAAC;IACtC,iEAAiE;IACzD,YAAY,GAAW,EAAE,CAAC;IAC1B,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACrC,MAAM,GAAY,KAAK,CAAC;IAEhC,YAAY,EAAU;QACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAA0B;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,sBAAsB;IAC7C,CAAC;IAEO,SAAS;QACf,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IAEO,gBAAgB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACK,gBAAgB,CAAC,GAAW;QAClC,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,qEAAqE;YACrE,IAAI,GAAG,EAAE,IAAI,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,YAAY,KAAK,IAAI,CAAC,YAAY,CAAC;IAC5C,CAAC;IAEO,kBAAkB,CAAC,IAAY;QACrC,MAAM,QAAQ,GAAG;YACf,6DAA6D;YAC7D,gDAAgD;YAChD,oCAAoC;YACpC,0BAA0B;YAC1B,gCAAgC;YAChC,8BAA8B;SAC/B,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAA2B;QACrC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAEtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,sBAAsB;QACtB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,QAAQ,CAAC,cAAc,EAAE,aAAa,OAAO,OAAO,GAAG,EAAE,CAAC,CAAC;QAEjE,8BAA8B;QAC9B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE3C,6BAA6B;QAC7B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,gBAAgB,IAAI,CAAC,EAAE,eAAe,SAAS,QAAQ,CAAC;QACvE,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAE9C,uCAAuC;QACvC,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE;YACvC,GAAG;YACH,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE;YAC/B,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACrC,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,2CAA2C;QAC3C,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvB,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,yCAAyC;QACzC,aAAa,CAAC,KAAK,EAAE,CAAC;QAEtB,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAE1C,MAAM,QAAQ,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC;QAEpE,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA2B;QACpC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;QAEzC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAEzE,qBAAqB;QACrB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC,cAAc,EAAE,kCAAkC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,cAAc,EAAE,qDAAqD,GAAG,EAAE,CAAC,CAAC;YAC3F,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,8BAA8B;YAChC,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,GAAG,EAAE;gBACrB,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,OAAO,EAAE,CAAC;oBACV,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YAEF,IAAI,SAAS,EAAE;gBAAE,OAAO;YAExB,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBACtC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACxB,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,QAAQ,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,EAAE,0CAA0C,CAAC,CAAC;oBACrF,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;oBACrC,CAAC;oBAAC,MAAM,CAAC;wBACP,IAAI,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;wBACpC,CAAC;wBAAC,MAAM,CAAC;4BACP,eAAe;wBACjB,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;gBAChC,IAAI,SAAS,EAAE,EAAE,CAAC;oBAChB,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACd,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,QAAQ,CAAC,cAAc,EAAE,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhD,yEAAyE;QACzE,2EAA2E;QAC3E,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,QAAQ,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,EAAE,gCAAgC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;YACjG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACzB,CAAC;QAED,OAAO;YACL,OAAO;YACP,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS;YAC5C,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;SACvC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAErD,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAY,EAAE;YACpE,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,OAAO,EAAE,CAAC;gBACxC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAE/D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;qBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,yCAAyC;oBACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,MAAM,GAAa,EAAE,CAAC;QAE1B,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/E,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/E,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,8BAA8B;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,QAAgB;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,2FAA2F;QAC3F,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC7D,iDAAiD;oBACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;wBAC3C,IAAI,IAAI,EAAE,CAAC;4BACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;4BACjB,OAAO,IAAI,CAAC;wBACd,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,gDAAgD;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE3C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QAErD,IAAI,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAE1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;YACxB,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAEjE,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAC3D,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,KAAK,KAAa,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,UAAU,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,MAAM,KAAa,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,KAAa,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,eAAe,KAAa,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACvD,OAAO,KAAoB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,YAAY,KAAkB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtD,kDAAkD;IAClD,OAAO,CAAC,IAAY,IAAU,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;CAClD"}

package/build/runners/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Runner Types
+ * Common interfaces and types for process runners (native, docker, docker-compose, etc.)
+ */
+export type RunnerType = 'native' | 'docker' | 'docker-compose';
+export interface RunnerStartOptions {
+    command: string;
+    cwd: string;
+    id: string;
+    env?: Record<string, string>;
+    port?: number;
+}
+export interface RunnerStartResult {
+    /** Process ID (for native) or container ID (for docker) */
+    pid: number;
+    /** Container ID for docker runners */
+    containerId?: string;
+    /** Detected port, if any */
+    port?: number;
+}
+export interface RunnerStopOptions {
+    /** Timeout in ms before force kill */
+    timeout?: number;
+}
+export interface RunnerLogOptions {
+    type?: 'stdout' | 'stderr' | 'all';
+    lines?: number;
+    /** For native runner: return lines since cursor */
+    since?: number;
+    /** Follow mode (tail -f style) - not implemented yet */
+    follow?: boolean;
+}
+export interface RunnerStatus {
+    running: boolean;
+    pid: number;
+    /**
+     * When the OS says `pid` started, so a recycled pid cannot pass for the
+     * server that used to hold it. Empty when unreadable; see
+     * PROCESS IDENTITY in native-runner.ts.
+     */
+    pidStartedAt?: string;
+    containerId?: string;
+    port?: number;
+    startedAt?: Date;
+    /** Additional status info from docker inspect, etc. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Runner interface - abstraction over different process models
+ */
+export interface Runner {
+    readonly type: RunnerType;
+    /**
+     * Start the process/container
+     */
+    start(options: RunnerStartOptions): Promise<RunnerStartResult>;
+    /**
+     * Stop the process/container
+     */
+    stop(options?: RunnerStopOptions): Promise<void>;
+    /**
+     * Check if process/container is running
+     */
+    isRunning(): Promise<boolean>;
+    /**
+     * Get current status
+     */
+    getStatus(): Promise<RunnerStatus>;
+    /**
+     * Get logs from the process/container
+     */
+    getLogs(options?: RunnerLogOptions): Promise<string[]>;
+    /**
+     * Detect port from logs or container inspection
+     */
+    detectPort(): Promise<number | null>;
+    /**
+     * Clean up resources (close file handles, etc.)
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Restore state from persisted data (for recovery after MCP restart)
+     */
+    restore(data: PersistedRunnerState): void;
+    /**
+     * Get the command used to start this runner
+     */
+    getCommand(): string;
+    /**
+     * Get the working directory for this runner
+     */
+    getCwd(): string;
+    /**
+     * Clear logs (optional - only native runner supports this)
+     */
+    clearLogs?(): Promise<{
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    }>;
+    /**
+     * Get log access info - file paths for native runner, command for docker
+     */
+    getLogAccess?(): {
+        type: 'file';
+        logDir: string;
+        stdoutPath: string;
+        stderrPath: string;
+    } | {
+        type: 'command';
+        command: string;
+    };
+}
+/**
+ * Runner state that can be persisted and restored
+ */
+export interface PersistedRunnerState {
+    type: RunnerType;
+    id: string;
+    command: string;
+    cwd: string;
+    pid: number;
+    /**
+     * When the OS says `pid` started. A pid alone cannot be trusted across a
+     * restart: a crashed server leaves its pid here, and once the OS recycles
+     * that number the dead server reads as running. See PROCESS IDENTITY in
+     * native-runner.ts. Absent for records written before this existed, which
+     * are treated as unverifiable rather than dead.
+     */
+    pidStartedAt?: string;
+    containerId?: string;
+    port?: number;
+    autoRun: boolean;
+    startedAt: string;
+    monitorPort?: boolean;
+    /** Whether this server is stored in global ~/.cdp-tools/ */
+    global?: boolean;
+    /** Whether cdp-tools watches this server's files and auto-restarts it on change */
+    watch?: boolean;
+    /** Paths to watch when `watch` is true (default: [cwd]) */
+    watchPaths?: string[];
+}
+/**
+ * Auto-detect runner type from command string
+ */
+export declare function detectRunnerType(command: string): RunnerType;
+//# sourceMappingURL=types.d.ts.map

package/build/runners/types.d.ts.map

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

package/build/runners/types.js

@@ -0,0 +1,25 @@
+/**
+ * Runner Types
+ * Common interfaces and types for process runners (native, docker, docker-compose, etc.)
+ */
+/**
+ * Auto-detect runner type from command string
+ */
+export function detectRunnerType(command) {
+    const trimmed = command.trim().toLowerCase();
+    // Docker Compose patterns
+    if (trimmed.startsWith('docker-compose ') ||
+        trimmed.startsWith('docker compose ') ||
+        /^docker\s+compose\s+/.test(trimmed)) {
+        return 'docker-compose';
+    }
+    // Docker patterns
+    if (trimmed.startsWith('docker run ') ||
+        trimmed.startsWith('docker start ') ||
+        /^docker\s+run\s+/.test(trimmed)) {
+        return 'docker';
+    }
+    // Default to native
+    return 'native';
+}
+//# sourceMappingURL=types.js.map

package/build/runners/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runners/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoJH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,0BAA0B;IAC1B,IACE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACrC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACrC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EACpC,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,IACE,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;QACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;QACnC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAChC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/build/self-restart.d.ts

@@ -0,0 +1,12 @@
+export interface SelfRestartResult {
+    ok: boolean;
+    pid?: number;
+    reason?: 'not-supervised' | 'stale-pid';
+    error?: string;
+}
+export interface SelfRestartDeps {
+    readPidFile: (path: string) => Promise<string>;
+    sendSignal: (pid: number, signal: NodeJS.Signals) => void;
+}
+export declare function requestSelfRestart(deps?: SelfRestartDeps): Promise<SelfRestartResult>;
+//# sourceMappingURL=self-restart.d.ts.map

package/build/self-restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-restart.d.ts","sourceRoot":"","sources":["../src/self-restart.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CAC3D;AAOD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,eAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsBxG"}

package/build/self-restart.js

@@ -0,0 +1,41 @@
+/**
+ * Ask the mcp-supervisor process managing this server to restart it - the
+ * same mechanism `npm run build`'s postbuild hook and a manual
+ * `kill -USR2 $(cat .cdp-tools/mcp-supervisor.pid)` use (see
+ * src/mcp-supervisor.ts). Only works when this server is running as the
+ * supervisor's child, which is the default for both this repo's .mcp.json
+ * and the package's published npx bin entry - a bare `node build/index.js`
+ * has no pidfile to signal.
+ *
+ * Deps are injectable (rather than calling fs/process directly) so this is
+ * unit-testable without touching the real filesystem or process table -
+ * same rationale as RestartCoordinator in supervisor/restart-coordinator.ts.
+ */
+import { readFile } from 'fs/promises';
+import { getOutputPath } from './helpers/paths.js';
+const defaultDeps = {
+    readPidFile: (path) => readFile(path, 'utf-8'),
+    sendSignal: (pid, signal) => process.kill(pid, signal),
+};
+export async function requestSelfRestart(deps = defaultDeps) {
+    const pidFilePath = getOutputPath('mcp-supervisor.pid');
+    let raw;
+    try {
+        raw = await deps.readPidFile(pidFilePath);
+    }
+    catch {
+        return { ok: false, reason: 'not-supervised' };
+    }
+    const pid = parseInt(raw.trim(), 10);
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return { ok: false, reason: 'not-supervised' };
+    }
+    try {
+        deps.sendSignal(pid, 'SIGUSR2');
+    }
+    catch (error) {
+        return { ok: false, pid, reason: 'stale-pid', error: error instanceof Error ? error.message : String(error) };
+    }
+    return { ok: true, pid };
+}
+//# sourceMappingURL=self-restart.js.map

package/build/self-restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-restart.js","sourceRoot":"","sources":["../src/self-restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcnD,MAAM,WAAW,GAAoB;IACnC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAC9C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;CACvD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAwB,WAAW;IAC1E,MAAM,WAAW,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAExD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAChH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/build/self-restart.test.d.ts

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

package/build/self-restart.test.d.ts.map

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