port-doctor-cli 1.0.0

package/dist/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAO7C,wBAAgB,kBAAkB,IAAI,eAAe,CAqBpD;AAED,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/platform/index.js

@@ -0,0 +1,26 @@
+import { DarwinPlatformAdapter } from './darwin.js';
+import { LinuxPlatformAdapter } from './linux.js';
+import { WindowsPlatformAdapter } from './windows.js';
+let cachedAdapter = null;
+export function getPlatformAdapter() {
+    if (cachedAdapter)
+        return cachedAdapter;
+    const currentPlatform = process.platform;
+    switch (currentPlatform) {
+        case 'darwin':
+            cachedAdapter = new DarwinPlatformAdapter();
+            break;
+        case 'linux':
+            cachedAdapter = new LinuxPlatformAdapter();
+            break;
+        case 'win32':
+            cachedAdapter = new WindowsPlatformAdapter();
+            break;
+        default:
+            // Fallback to Linux adapter (POSIX-compatible)
+            cachedAdapter = new LinuxPlatformAdapter();
+            break;
+    }
+    return cachedAdapter;
+}
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,IAAI,aAAa,GAA2B,IAAI,CAAC;AAEjD,MAAM,UAAU,kBAAkB;IAChC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IACzC,QAAQ,eAAe,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,aAAa,GAAG,IAAI,qBAAqB,EAAE,CAAC;YAC5C,MAAM;QACR,KAAK,OAAO;YACV,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC3C,MAAM;QACR,KAAK,OAAO;YACV,aAAa,GAAG,IAAI,sBAAsB,EAAE,CAAC;YAC7C,MAAM;QACR;YACE,+CAA+C;YAC/C,aAAa,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC3C,MAAM;IACV,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/platform/linux.d.ts

@@ -0,0 +1,22 @@
+import { PlatformAdapter, RawPortMatch } from './types.js';
+import { ProcessInfo } from '../types/index.js';
+export declare function parseLinuxStat(rawStat: string): {
+    pid?: number;
+    name?: string;
+    ppid?: number;
+    state?: string;
+};
+export declare class LinuxPlatformAdapter implements PlatformAdapter {
+    readonly platformName = "linux";
+    findListeningPorts(ports?: number[]): Promise<RawPortMatch[]>;
+    getProcessInfo(pid: number): Promise<Partial<ProcessInfo>>;
+    getProcessTree(pid: number): Promise<Array<{
+        pid: number;
+        ppid: number;
+        name: string;
+        command?: string;
+    }>>;
+    isPortListening(port: number): Promise<boolean>;
+    kill(pid: number, signal: 'SIGINT' | 'SIGTERM' | 'SIGKILL'): Promise<boolean>;
+}
+//# sourceMappingURL=linux.d.ts.map

package/dist/platform/linux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../src/platform/linux.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB9G;AAED,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,QAAQ,CAAC,YAAY,WAAW;IAE1B,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoF7D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAwD1D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAyC1G,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CASpF"}

package/dist/platform/linux.js

@@ -0,0 +1,217 @@
+import * as fs from 'node:fs/promises';
+import { safeExec, safeExecFile } from '../utils/exec.js';
+import { redactSensitiveData } from '../utils/redaction.js';
+export function parseLinuxStat(rawStat) {
+    const firstOpen = rawStat.indexOf('(');
+    const lastClose = rawStat.lastIndexOf(')');
+    if (firstOpen === -1 || lastClose === -1 || lastClose < firstOpen) {
+        return {};
+    }
+    const pidStr = rawStat.substring(0, firstOpen).trim();
+    const pid = parseInt(pidStr, 10);
+    const name = rawStat.substring(firstOpen + 1, lastClose);
+    const afterClose = rawStat.substring(lastClose + 1).trim();
+    const fields = afterClose.split(/\s+/);
+    const state = fields[0];
+    const ppid = parseInt(fields[1], 10);
+    return {
+        pid: isNaN(pid) ? undefined : pid,
+        name,
+        state,
+        ppid: isNaN(ppid) ? undefined : ppid,
+    };
+}
+export class LinuxPlatformAdapter {
+    platformName = 'linux';
+    async findListeningPorts(ports) {
+        const matches = [];
+        // 1. Try ss -tulpn (fastest & standard on modern Linux)
+        const ssRes = await safeExec('ss -tulpn -H');
+        if (ssRes.exitCode === 0 && ssRes.stdout) {
+            const lines = ssRes.stdout.split('\n');
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                // Example format: tcp LISTEN 0 511 0.0.0.0:3000 0.0.0.0:* users:(("node",pid=8212,fd=23))
+                const cols = line.trim().split(/\s+/);
+                if (cols.length < 5)
+                    continue;
+                const protocol = cols[0].toLowerCase().includes('udp') ? 'udp' : 'tcp';
+                const localAddr = cols[3] || cols[4];
+                const portMatch = localAddr.match(/:(\d+)$/);
+                if (!portMatch)
+                    continue;
+                const port = parseInt(portMatch[1], 10);
+                if (ports && ports.length > 0 && !ports.includes(port))
+                    continue;
+                // Parse PID and process name from users:(("node",pid=8212,fd=23))
+                const usersCol = line.match(/users:\(\((.*?)\)\)/);
+                let pid = 0;
+                let processName = '';
+                if (usersCol) {
+                    const pidMatch = usersCol[1].match(/pid=(\d+)/);
+                    if (pidMatch)
+                        pid = parseInt(pidMatch[1], 10);
+                    const nameMatch = usersCol[1].match(/"([^"]+)"/);
+                    if (nameMatch)
+                        processName = nameMatch[1];
+                }
+                const address = localAddr.substring(0, localAddr.lastIndexOf(':')).replace(/^\[|\]$/g, '') || '0.0.0.0';
+                if (port && !matches.some((m) => m.port === port && m.pid === pid && m.address === address)) {
+                    matches.push({
+                        port,
+                        pid,
+                        protocol,
+                        address,
+                        processName,
+                    });
+                }
+            }
+            if (matches.length > 0)
+                return matches;
+        }
+        // 2. Fallback to lsof if ss didn't return or lacked permissions
+        const lsofRes = await safeExec('lsof -nP -iTCP -sTCP:LISTEN');
+        if (lsofRes.exitCode === 0 && lsofRes.stdout) {
+            const lines = lsofRes.stdout.split('\n');
+            for (let i = 1; i < lines.length; i++) {
+                const line = lines[i].trim();
+                if (!line)
+                    continue;
+                const parts = line.split(/\s+/);
+                if (parts.length < 9)
+                    continue;
+                const processName = parts[0];
+                const pid = parseInt(parts[1], 10);
+                const nameCol = parts[8] || '';
+                const portMatch = nameCol.match(/:(\d+)$/);
+                if (!portMatch)
+                    continue;
+                const port = parseInt(portMatch[1], 10);
+                if (ports && ports.length > 0 && !ports.includes(port))
+                    continue;
+                const address = nameCol.substring(0, nameCol.lastIndexOf(':')).replace(/^\[|\]$/g, '') || '0.0.0.0';
+                if (!matches.some((m) => m.port === port && m.pid === pid && m.address === address)) {
+                    matches.push({
+                        port,
+                        pid,
+                        protocol: 'tcp',
+                        address,
+                        processName,
+                    });
+                }
+            }
+        }
+        return matches;
+    }
+    async getProcessInfo(pid) {
+        if (!Number.isInteger(pid) || pid <= 0)
+            return {};
+        const info = { pid };
+        // 1. Read /proc/<pid>/cwd
+        try {
+            info.cwd = await fs.readlink(`/proc/${pid}/cwd`);
+        }
+        catch {
+            // Permission denied or process exited
+        }
+        // 2. Read /proc/<pid>/cmdline
+        try {
+            const rawCmd = await fs.readFile(`/proc/${pid}/cmdline`, 'utf8');
+            const cmdArgs = rawCmd.split('\0').filter(Boolean).join(' ');
+            if (cmdArgs) {
+                info.fullCommand = redactSensitiveData(cmdArgs);
+                info.command = info.fullCommand.length > 120 ? `${info.fullCommand.slice(0, 117)}...` : info.fullCommand;
+            }
+        }
+        catch {
+            // ignore
+        }
+        // 3. Read /proc/<pid>/stat with robust parser
+        try {
+            const stat = await fs.readFile(`/proc/${pid}/stat`, 'utf8');
+            const parsedStat = parseLinuxStat(stat);
+            if (parsedStat.name) {
+                info.name = parsedStat.name;
+            }
+            if (parsedStat.ppid !== undefined) {
+                info.ppid = parsedStat.ppid;
+            }
+        }
+        catch {
+            // Fallback via ps
+            const psRes = await safeExecFile('ps', ['-p', String(pid), '-o', 'comm=,ppid=,etime=,user=,rss=,%cpu=,args=']);
+            if (psRes.exitCode === 0 && psRes.stdout) {
+                const match = psRes.stdout.trim().match(/^(\S+)\s+(\d+)\s+(\S+)\s+(\S+)\s+(\d+)\s+([\d.]+)\s+(.*)$/s);
+                if (match) {
+                    const [, comm, ppidStr, etimeStr, user, rssStr, cpuStr, fullArgs] = match;
+                    info.name = comm.split('/').pop() || comm;
+                    info.ppid = parseInt(ppidStr, 10);
+                    info.user = user;
+                    info.memoryBytes = parseInt(rssStr, 10) * 1024;
+                    info.cpuPercent = parseFloat(cpuStr);
+                    if (!info.fullCommand) {
+                        info.fullCommand = redactSensitiveData(fullArgs.trim());
+                        info.command = info.fullCommand.length > 120 ? `${info.fullCommand.slice(0, 117)}...` : info.fullCommand;
+                    }
+                }
+            }
+        }
+        return info;
+    }
+    async getProcessTree(pid) {
+        if (!Number.isInteger(pid) || pid <= 0)
+            return [];
+        const chain = [];
+        let currentPid = pid;
+        const visited = new Set();
+        while (currentPid > 1 && !visited.has(currentPid) && chain.length < 10) {
+            visited.add(currentPid);
+            try {
+                const stat = await fs.readFile(`/proc/${currentPid}/stat`, 'utf8');
+                const parsedStat = parseLinuxStat(stat);
+                if (!parsedStat.name || parsedStat.ppid === undefined)
+                    break;
+                const name = parsedStat.name;
+                const ppid = parsedStat.ppid;
+                let command = '';
+                try {
+                    const rawCmd = await fs.readFile(`/proc/${currentPid}/cmdline`, 'utf8');
+                    command = redactSensitiveData(rawCmd.split('\0').filter(Boolean).join(' '));
+                }
+                catch {
+                    // ignore
+                }
+                chain.unshift({
+                    pid: currentPid,
+                    ppid,
+                    name,
+                    command,
+                });
+                if (ppid <= 1 || isNaN(ppid))
+                    break;
+                currentPid = ppid;
+            }
+            catch {
+                break;
+            }
+        }
+        return chain;
+    }
+    async isPortListening(port) {
+        const matches = await this.findListeningPorts([port]);
+        return matches.some((m) => m.port === port);
+    }
+    async kill(pid, signal) {
+        try {
+            process.kill(pid, signal);
+            return true;
+        }
+        catch (err) {
+            if (err.code === 'ESRCH')
+                return true;
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=linux.js.map

package/dist/platform/linux.js.map

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

package/dist/platform/types.d.ts

@@ -0,0 +1,40 @@
+import { ProcessInfo } from '../types/index.js';
+export interface RawPortMatch {
+    port: number;
+    pid: number;
+    protocol: 'tcp' | 'udp';
+    address: string;
+    processName?: string;
+    command?: string;
+    user?: string;
+}
+export interface PlatformAdapter {
+    readonly platformName: string;
+    /**
+     * Find listening ports. If ports array is provided, filter for those ports.
+     * If empty or undefined, scan all listening ports.
+     */
+    findListeningPorts(ports?: number[]): Promise<RawPortMatch[]>;
+    /**
+     * Get detailed process information for a specific PID.
+     */
+    getProcessInfo(pid: number): Promise<Partial<ProcessInfo>>;
+    /**
+     * Get process tree ancestry (PPID chain).
+     */
+    getProcessTree(pid: number): Promise<Array<{
+        pid: number;
+        ppid: number;
+        name: string;
+        command?: string;
+    }>>;
+    /**
+     * Check if a specific port is currently open/listening.
+     */
+    isPortListening(port: number): Promise<boolean>;
+    /**
+     * Send signal to a PID.
+     */
+    kill(pid: number, signal: 'SIGINT' | 'SIGTERM' | 'SIGKILL'): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE9D;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3D;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAE3G;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}

package/dist/platform/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/platform/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":""}

package/dist/platform/windows.d.ts

@@ -0,0 +1,17 @@
+import { PlatformAdapter, RawPortMatch } from './types.js';
+import { ProcessInfo } from '../types/index.js';
+export declare function parseWindowsProcessData(rawJson: string): Partial<ProcessInfo>;
+export declare class WindowsPlatformAdapter implements PlatformAdapter {
+    readonly platformName = "win32";
+    findListeningPorts(ports?: number[]): Promise<RawPortMatch[]>;
+    getProcessInfo(pid: number): Promise<Partial<ProcessInfo>>;
+    getProcessTree(pid: number): Promise<Array<{
+        pid: number;
+        ppid: number;
+        name: string;
+        command?: string;
+    }>>;
+    isPortListening(port: number): Promise<boolean>;
+    kill(pid: number, signal: 'SIGINT' | 'SIGTERM' | 'SIGKILL'): Promise<boolean>;
+}
+//# sourceMappingURL=windows.d.ts.map

package/dist/platform/windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../src/platform/windows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B7E;AAED,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,QAAQ,CAAC,YAAY,WAAW;IAE1B,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0C7D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAiB1D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAgC1G,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAWpF"}

package/dist/platform/windows.js

@@ -0,0 +1,138 @@
+import { safeExecFile } from '../utils/exec.js';
+import { redactSensitiveData } from '../utils/redaction.js';
+export function parseWindowsProcessData(rawJson) {
+    const info = {};
+    try {
+        const data = JSON.parse(rawJson);
+        info.name = data.Name || '';
+        info.ppid = data.ParentProcessId ? parseInt(data.ParentProcessId, 10) : undefined;
+        if (data.CommandLine) {
+            info.fullCommand = redactSensitiveData(data.CommandLine);
+            info.command = info.fullCommand.length > 120 ? `${info.fullCommand.slice(0, 117)}...` : info.fullCommand;
+        }
+        if (data.ExecutablePath) {
+            info.executablePath = data.ExecutablePath;
+            // IMPORTANT: ExecutablePath is kept separate from cwd.
+        }
+        if (data.WorkingDirectory && typeof data.WorkingDirectory === 'string' && data.WorkingDirectory.trim()) {
+            info.cwd = data.WorkingDirectory.trim();
+        }
+        else if (data.CurrentWorkingDirectory && typeof data.CurrentWorkingDirectory === 'string' && data.CurrentWorkingDirectory.trim()) {
+            info.cwd = data.CurrentWorkingDirectory.trim();
+        }
+        if (data.WorkingSetSize) {
+            info.memoryBytes = parseInt(data.WorkingSetSize, 10);
+        }
+    }
+    catch {
+        // ignore parse error
+    }
+    return info;
+}
+export class WindowsPlatformAdapter {
+    platformName = 'win32';
+    async findListeningPorts(ports) {
+        const matches = [];
+        // 1. Try netstat -ano -p tcp (fast, standard on all Windows versions)
+        const netstatRes = await safeExecFile('netstat', ['-ano', '-p', 'tcp']);
+        if (netstatRes.exitCode === 0 && netstatRes.stdout) {
+            const lines = netstatRes.stdout.split('\n');
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed.toUpperCase().includes('LISTENING'))
+                    continue;
+                // Example: TCP    0.0.0.0:3000           0.0.0.0:0              LISTENING       8212
+                // Example: TCP    [::]:5173              [::]:0                 LISTENING       1234
+                const parts = trimmed.split(/\s+/);
+                if (parts.length < 5)
+                    continue;
+                const localAddr = parts[1];
+                const pid = parseInt(parts[parts.length - 1], 10);
+                if (isNaN(pid) || pid <= 0)
+                    continue;
+                const portMatch = localAddr.match(/:(\d+)$/);
+                if (!portMatch)
+                    continue;
+                const port = parseInt(portMatch[1], 10);
+                if (ports && ports.length > 0 && !ports.includes(port))
+                    continue;
+                const address = localAddr.substring(0, localAddr.lastIndexOf(':')).replace(/^\[|\]$/g, '') || '0.0.0.0';
+                if (!matches.some((m) => m.port === port && m.pid === pid && m.address === address)) {
+                    matches.push({
+                        port,
+                        pid,
+                        protocol: 'tcp',
+                        address,
+                    });
+                }
+            }
+        }
+        return matches;
+    }
+    async getProcessInfo(pid) {
+        if (!Number.isInteger(pid) || pid <= 0)
+            return {};
+        const info = { pid };
+        // Use PowerShell to get process metadata and working directory safely
+        const psFilter = `ProcessId = ${pid}`;
+        const psScript = `$proc = Get-CimInstance Win32_Process -Filter "${psFilter}"; if ($proc) { $cwd = $null; try { $p = Get-Process -Id ${pid} -ErrorAction SilentlyContinue; if ($p -and $p.StartInfo -and $p.StartInfo.WorkingDirectory) { $cwd = $p.StartInfo.WorkingDirectory } } catch {}; [PSCustomObject]@{ Name = $proc.Name; ProcessId = $proc.ProcessId; ParentProcessId = $proc.ParentProcessId; CommandLine = $proc.CommandLine; ExecutablePath = $proc.ExecutablePath; WorkingDirectory = $cwd; WorkingSetSize = $proc.WorkingSetSize } | ConvertTo-Json }`;
+        const res = await safeExecFile('powershell', ['-NoProfile', '-NonInteractive', '-Command', psScript], { timeout: 4000 });
+        if (res.exitCode === 0 && res.stdout) {
+            const parsed = parseWindowsProcessData(res.stdout);
+            Object.assign(info, parsed);
+        }
+        return info;
+    }
+    async getProcessTree(pid) {
+        if (!Number.isInteger(pid) || pid <= 0)
+            return [];
+        const chain = [];
+        let currentPid = pid;
+        const visited = new Set();
+        while (currentPid > 0 && !visited.has(currentPid) && chain.length < 8) {
+            visited.add(currentPid);
+            const psFilter = `ProcessId = ${currentPid}`;
+            const psScript = `Get-CimInstance Win32_Process -Filter "${psFilter}" | Select-Object Name, ProcessId, ParentProcessId, CommandLine | ConvertTo-Json`;
+            const res = await safeExecFile('powershell', ['-NoProfile', '-NonInteractive', '-Command', psScript], { timeout: 3000 });
+            if (res.exitCode !== 0 || !res.stdout)
+                break;
+            try {
+                const data = JSON.parse(res.stdout);
+                const ppid = data.ParentProcessId ? parseInt(data.ParentProcessId, 10) : 0;
+                chain.unshift({
+                    pid: currentPid,
+                    ppid,
+                    name: data.Name || 'unknown',
+                    command: data.CommandLine ? redactSensitiveData(data.CommandLine) : undefined,
+                });
+                if (ppid <= 0)
+                    break;
+                currentPid = ppid;
+            }
+            catch {
+                break;
+            }
+        }
+        return chain;
+    }
+    async isPortListening(port) {
+        if (!Number.isInteger(port) || port <= 0 || port > 65535)
+            return false;
+        const matches = await this.findListeningPorts([port]);
+        return matches.some((m) => m.port === port);
+    }
+    async kill(pid, signal) {
+        if (!Number.isInteger(pid) || pid <= 0)
+            return false;
+        if (signal === 'SIGKILL') {
+            const res = await safeExecFile('taskkill', ['/F', '/PID', String(pid)]);
+            return res.exitCode === 0;
+        }
+        else {
+            // Graceful kill attempt
+            const res = await safeExecFile('taskkill', ['/PID', String(pid)]);
+            return res.exitCode === 0;
+        }
+    }
+}
+//# sourceMappingURL=windows.js.map

package/dist/platform/windows.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,101 @@
+export interface PortInfo {
+    port: number;
+    status: 'free' | 'busy' | 'restricted';
+    protocol: 'tcp' | 'udp';
+    address: string;
+    allAddresses?: string[];
+    pid?: number;
+    allPids?: number[];
+    process?: ProcessInfo;
+    project?: ProjectContext;
+    git?: GitContext;
+    framework?: FrameworkInfo;
+    processTree?: ProcessTreeNode[];
+    diagnosis?: PortDiagnosis;
+}
+export interface ProcessInfo {
+    pid: number;
+    ppid?: number;
+    name: string;
+    command: string;
+    fullCommand?: string;
+    executablePath?: string;
+    cwd?: string;
+    user?: string;
+    uptimeSeconds?: number;
+    uptimeFormatted?: string;
+    memoryBytes?: number;
+    cpuPercent?: number;
+    isOrphan?: boolean;
+}
+export interface ProjectContext {
+    name: string;
+    rootDirectory: string;
+    packageJsonPath?: string;
+    version?: string;
+    isMonorepo?: boolean;
+    scripts?: Record<string, string>;
+}
+export interface GitContext {
+    isGitRepo: boolean;
+    repoName?: string;
+    branch?: string;
+    commitHash?: string;
+    isDirty?: boolean;
+    uncommittedFilesCount?: number;
+}
+export interface FrameworkInfo {
+    name: string;
+    category: 'web-framework' | 'api-server' | 'database' | 'tool' | 'runtime' | 'system';
+    confidence: 'high' | 'medium' | 'low';
+    details?: string;
+    defaultPort?: number;
+}
+export interface ProcessTreeNode {
+    pid: number;
+    name: string;
+    command?: string;
+    children?: ProcessTreeNode[];
+}
+export interface PortDiagnosis {
+    type: 'dev_server' | 'database' | 'system_service' | 'orphan_process' | 'port_conflict' | 'free';
+    severity: 'info' | 'warning' | 'error';
+    summary: string;
+    details?: string[];
+    suggestedAction?: string;
+    safeToFree?: boolean;
+}
+export interface ScanOptions {
+    ports?: number[];
+    deep?: boolean;
+    timeoutMs?: number;
+}
+export interface FreeResult {
+    port: number;
+    pid: number;
+    processName: string;
+    projectName?: string;
+    success: boolean;
+    method: 'SIGINT' | 'SIGTERM' | 'SIGKILL' | 'none';
+    timeTakenMs: number;
+    error?: string;
+}
+export interface RunOptions {
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    interactive?: boolean;
+}
+export interface CLIArgs {
+    command?: 'overview' | 'why' | 'free' | 'run' | 'help' | 'version';
+    port?: number;
+    ports?: number[];
+    rawCommand?: string;
+    json?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+    help?: boolean;
+    version?: boolean;
+    timeout?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}