@jonnyhoo/ccs 1.0.0

package/dist/utils/image-analysis/hook-installer.js.map

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

package/dist/utils/image-analysis/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Image Analysis Utilities
+ *
+ * Exports hook installer functions for prompt management
+ */
+export { getPromptsDir, installImageAnalysisPrompts } from './hook-installer';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/image-analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/image-analysis/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/image-analysis/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Image Analysis Utilities
+ *
+ * Exports hook installer functions for prompt management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installImageAnalysisPrompts = exports.getPromptsDir = void 0;
+var hook_installer_1 = require("./hook-installer");
+Object.defineProperty(exports, "getPromptsDir", { enumerable: true, get: function () { return hook_installer_1.getPromptsDir; } });
+Object.defineProperty(exports, "installImageAnalysisPrompts", { enumerable: true, get: function () { return hook_installer_1.installImageAnalysisPrompts; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/image-analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/image-analysis/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mDAA8E;AAArE,+GAAA,aAAa,OAAA;AAAE,6HAAA,2BAA2B,OAAA"}

package/dist/utils/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utils module barrel export
+ * Selective exports of commonly used utilities
+ */
+export * from './ui';
+export * from './time';
+export { execClaude, escapeShellArg } from './shell-executor';
+export { getClaudeCliInfo } from './claude-detector';
+export { ClaudeSymlinkManager } from './claude-symlink-manager';
+export { ClaudeDirInstaller } from './claude-dir-installer';
+export { ProgressIndicator } from './progress-indicator';
+export { getVersion } from './version';
+export { ErrorManager } from './error-manager';
+export { default as getPlatformCommands } from './platform-commands';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,MAAM,CAAC;AAGrB,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Utils module barrel export
+ * Selective exports of commonly used utilities
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformCommands = exports.ErrorManager = exports.getVersion = exports.ProgressIndicator = exports.ClaudeDirInstaller = exports.ClaudeSymlinkManager = exports.getClaudeCliInfo = exports.escapeShellArg = exports.execClaude = void 0;
+// UI utilities (main export)
+__exportStar(require("./ui"), exports);
+// Time utilities
+__exportStar(require("./time"), exports);
+// Shell execution
+var shell_executor_1 = require("./shell-executor");
+Object.defineProperty(exports, "execClaude", { enumerable: true, get: function () { return shell_executor_1.execClaude; } });
+Object.defineProperty(exports, "escapeShellArg", { enumerable: true, get: function () { return shell_executor_1.escapeShellArg; } });
+// Claude detection and management
+var claude_detector_1 = require("./claude-detector");
+Object.defineProperty(exports, "getClaudeCliInfo", { enumerable: true, get: function () { return claude_detector_1.getClaudeCliInfo; } });
+var claude_symlink_manager_1 = require("./claude-symlink-manager");
+Object.defineProperty(exports, "ClaudeSymlinkManager", { enumerable: true, get: function () { return claude_symlink_manager_1.ClaudeSymlinkManager; } });
+var claude_dir_installer_1 = require("./claude-dir-installer");
+Object.defineProperty(exports, "ClaudeDirInstaller", { enumerable: true, get: function () { return claude_dir_installer_1.ClaudeDirInstaller; } });
+// Utilities
+var progress_indicator_1 = require("./progress-indicator");
+Object.defineProperty(exports, "ProgressIndicator", { enumerable: true, get: function () { return progress_indicator_1.ProgressIndicator; } });
+var version_1 = require("./version");
+Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return version_1.getVersion; } });
+var error_manager_1 = require("./error-manager");
+Object.defineProperty(exports, "ErrorManager", { enumerable: true, get: function () { return error_manager_1.ErrorManager; } });
+// Platform utilities
+var platform_commands_1 = require("./platform-commands");
+Object.defineProperty(exports, "getPlatformCommands", { enumerable: true, get: function () { return __importDefault(platform_commands_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;AAEH,6BAA6B;AAC7B,uCAAqB;AAErB,iBAAiB;AACjB,yCAAuB;AAEvB,kBAAkB;AAClB,mDAA8D;AAArD,4GAAA,UAAU,OAAA;AAAE,gHAAA,cAAc,OAAA;AAEnC,kCAAkC;AAClC,qDAAqD;AAA5C,mHAAA,gBAAgB,OAAA;AACzB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAE3B,YAAY;AACZ,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AACnB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,qBAAqB;AACrB,yDAAqE;AAA5D,yIAAA,OAAO,OAAuB"}

package/dist/utils/package-manager-detector.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Package Manager Detector Utilities
+ *
+ * Cross-platform package manager detection utilities for CCS.
+ * Now only supports npm-based installation (npm/yarn/pnpm/bun).
+ */
+/**
+ * Detect which package manager was used for installation
+ */
+export declare function detectPackageManager(): 'npm' | 'yarn' | 'pnpm' | 'bun';
+//# sourceMappingURL=package-manager-detector.d.ts.map

package/dist/utils/package-manager-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager-detector.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CA4DtE"}

package/dist/utils/package-manager-detector.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Package Manager Detector Utilities
+ *
+ * Cross-platform package manager detection utilities for CCS.
+ * Now only supports npm-based installation (npm/yarn/pnpm/bun).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+/**
+ * Detect which package manager was used for installation
+ */
+function detectPackageManager() {
+    const scriptPath = process.argv[1];
+    // Check if script path contains package manager indicators
+    if (scriptPath.includes('.pnpm'))
+        return 'pnpm';
+    if (scriptPath.includes('yarn'))
+        return 'yarn';
+    if (scriptPath.includes('bun'))
+        return 'bun';
+    // Check parent directories for lock files
+    const binDir = path.dirname(scriptPath);
+    let checkDir = binDir;
+    for (let i = 0; i < 5; i++) {
+        if (fs.existsSync(path.join(checkDir, 'pnpm-lock.yaml')))
+            return 'pnpm';
+        if (fs.existsSync(path.join(checkDir, 'yarn.lock')))
+            return 'yarn';
+        if (fs.existsSync(path.join(checkDir, 'bun.lockb')))
+            return 'bun';
+        checkDir = path.dirname(checkDir);
+    }
+    // Check if package managers are available on the system
+    try {
+        const yarnResult = (0, child_process_1.spawnSync)('yarn', ['global', 'list', '--pattern', '@kaitranntt/ccs'], {
+            encoding: 'utf8',
+            shell: true,
+            timeout: 5000,
+        });
+        if (yarnResult.status === 0 && yarnResult.stdout.includes('@kaitranntt/ccs')) {
+            return 'yarn';
+        }
+    }
+    catch (_err) {
+        // Continue to next check
+    }
+    try {
+        const pnpmResult = (0, child_process_1.spawnSync)('pnpm', ['list', '-g', '--pattern', '@kaitranntt/ccs'], {
+            encoding: 'utf8',
+            shell: true,
+            timeout: 5000,
+        });
+        if (pnpmResult.status === 0 && pnpmResult.stdout.includes('@kaitranntt/ccs')) {
+            return 'pnpm';
+        }
+    }
+    catch (_err) {
+        // Continue to next check
+    }
+    try {
+        const bunResult = (0, child_process_1.spawnSync)('bun', ['pm', 'ls', '-g', '--pattern', '@kaitranntt/ccs'], {
+            encoding: 'utf8',
+            shell: true,
+            timeout: 5000,
+        });
+        if (bunResult.status === 0 && bunResult.stdout.includes('@kaitranntt/ccs')) {
+            return 'bun';
+        }
+    }
+    catch (_err) {
+        // Continue to default
+    }
+    return 'npm';
+}
+exports.detectPackageManager = detectPackageManager;
+//# sourceMappingURL=package-manager-detector.js.map

package/dist/utils/package-manager-detector.js.map

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

package/dist/utils/platform-commands.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Platform-aware command suggestions and utilities
+ *
+ * Provides OS-specific commands for troubleshooting messages
+ * to help non-technical users on Windows, macOS, and Linux.
+ */
+/**
+ * Get platform-specific command to check what's using a port
+ */
+export declare function getPortCheckCommand(port: number): string;
+/**
+ * Get platform-specific command to view file contents
+ */
+export declare function getCatCommand(filePath: string): string;
+/**
+ * Get platform-specific command to kill CLIProxy Plus processes
+ */
+export declare function getKillCLIProxyCommand(): string;
+/**
+ * Get platform-specific command to kill a process by PID
+ */
+export declare function getKillPidCommand(pid: number): string;
+/**
+ * Get human-friendly platform name
+ */
+export declare function getPlatformName(): string;
+/**
+ * Kill process by PID (cross-platform)
+ * @returns true if killed successfully, false otherwise
+ */
+export declare function killProcessByPid(pid: number, verbose?: boolean): boolean;
+/**
+ * Kill all CLIProxy Plus processes (cross-platform)
+ * @returns number of processes killed
+ */
+export declare function killAllCLIProxyProcesses(verbose?: boolean): number;
+/**
+ * Kill process on specific port (cross-platform)
+ * @returns true if a process was killed, false otherwise
+ */
+export declare function killProcessOnPort(port: number, verbose?: boolean): boolean;
+declare const _default: {
+    getPortCheckCommand: typeof getPortCheckCommand;
+    getCatCommand: typeof getCatCommand;
+    getKillCLIProxyCommand: typeof getKillCLIProxyCommand;
+    getKillPidCommand: typeof getKillPidCommand;
+    getPlatformName: typeof getPlatformName;
+    killProcessByPid: typeof killProcessByPid;
+    killAllCLIProxyProcesses: typeof killAllCLIProxyProcesses;
+    killProcessOnPort: typeof killProcessOnPort;
+};
+export default _default;
+//# sourceMappingURL=platform-commands.d.ts.map

package/dist/utils/platform-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-commands.d.ts","sourceRoot":"","sources":["../../src/utils/platform-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CActE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,UAAQ,GAAG,MAAM,CA2BhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAiDxE;;;;;;;;;;;AAED,wBASE"}

package/dist/utils/platform-commands.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Platform-aware command suggestions and utilities
+ *
+ * Provides OS-specific commands for troubleshooting messages
+ * to help non-technical users on Windows, macOS, and Linux.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.killProcessOnPort = exports.killAllCLIProxyProcesses = exports.killProcessByPid = exports.getPlatformName = exports.getKillPidCommand = exports.getKillCLIProxyCommand = exports.getCatCommand = exports.getPortCheckCommand = void 0;
+const child_process_1 = require("child_process");
+const isWindows = process.platform === 'win32';
+const isMac = process.platform === 'darwin';
+/**
+ * Get platform-specific command to check what's using a port
+ */
+function getPortCheckCommand(port) {
+    if (isWindows) {
+        return `netstat -ano | findstr :${port}`;
+    }
+    return `lsof -i :${port}`;
+}
+exports.getPortCheckCommand = getPortCheckCommand;
+/**
+ * Get platform-specific command to view file contents
+ */
+function getCatCommand(filePath) {
+    if (isWindows) {
+        // Use type for CMD, Get-Content for PowerShell
+        return `type "${filePath}"`;
+    }
+    return `cat "${filePath}"`;
+}
+exports.getCatCommand = getCatCommand;
+/**
+ * Get platform-specific command to kill CLIProxy Plus processes
+ */
+function getKillCLIProxyCommand() {
+    if (isWindows) {
+        return 'taskkill /F /IM cli-proxy-api-plus.exe';
+    }
+    return 'pkill -f cli-proxy-api-plus';
+}
+exports.getKillCLIProxyCommand = getKillCLIProxyCommand;
+/**
+ * Get platform-specific command to kill a process by PID
+ */
+function getKillPidCommand(pid) {
+    if (isWindows) {
+        return `taskkill /F /PID ${pid}`;
+    }
+    return `kill -9 ${pid}`;
+}
+exports.getKillPidCommand = getKillPidCommand;
+/**
+ * Get human-friendly platform name
+ */
+function getPlatformName() {
+    if (isWindows)
+        return 'Windows';
+    if (isMac)
+        return 'macOS';
+    return 'Linux';
+}
+exports.getPlatformName = getPlatformName;
+/**
+ * Kill process by PID (cross-platform)
+ * @returns true if killed successfully, false otherwise
+ */
+function killProcessByPid(pid, verbose = false) {
+    try {
+        if (isWindows) {
+            (0, child_process_1.execSync)(`taskkill /F /PID ${pid}`, { stdio: 'pipe' });
+        }
+        else {
+            (0, child_process_1.execSync)(`kill -9 ${pid}`, { stdio: 'pipe' });
+        }
+        if (verbose) {
+            console.error(`[cleanup] Killed process ${pid}`);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+exports.killProcessByPid = killProcessByPid;
+/**
+ * Kill all CLIProxy Plus processes (cross-platform)
+ * @returns number of processes killed
+ */
+function killAllCLIProxyProcesses(verbose = false) {
+    let killed = 0;
+    try {
+        if (isWindows) {
+            // Windows: taskkill by image name
+            // Use /T to kill child processes too
+            (0, child_process_1.execSync)('taskkill /F /IM cli-proxy-api-plus.exe /T 2>nul', { stdio: 'pipe' });
+            killed++;
+        }
+        else {
+            // Unix: pkill with pattern matching
+            try {
+                (0, child_process_1.execSync)('pkill -9 -f cli-proxy-api-plus', { stdio: 'pipe' });
+                killed++;
+            }
+            catch {
+                // pkill returns non-zero if no processes matched - that's OK
+            }
+        }
+    }
+    catch {
+        // No processes to kill or command failed
+    }
+    if (verbose && killed > 0) {
+        console.error(`[cleanup] Killed ${killed} CLIProxy Plus process(es)`);
+    }
+    return killed;
+}
+exports.killAllCLIProxyProcesses = killAllCLIProxyProcesses;
+/**
+ * Kill process on specific port (cross-platform)
+ * @returns true if a process was killed, false otherwise
+ */
+function killProcessOnPort(port, verbose = false) {
+    try {
+        if (isWindows) {
+            // Windows: netstat + taskkill
+            const result = (0, child_process_1.execSync)(`netstat -ano | findstr :${port}`, {
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            });
+            const lines = result.trim().split('\n');
+            let killed = false;
+            for (const line of lines) {
+                const parts = line.trim().split(/\s+/);
+                const pid = parts[parts.length - 1];
+                if (pid && /^\d+$/.test(pid)) {
+                    try {
+                        (0, child_process_1.execSync)(`taskkill /F /PID ${pid}`, { stdio: 'pipe' });
+                        if (verbose) {
+                            console.error(`[cleanup] Killed process ${pid} on port ${port}`);
+                        }
+                        killed = true;
+                    }
+                    catch {
+                        // Process may have already exited
+                    }
+                }
+            }
+            return killed;
+        }
+        else {
+            // Unix: lsof + kill
+            const result = (0, child_process_1.execSync)(`lsof -ti:${port}`, { encoding: 'utf-8', stdio: 'pipe' });
+            const pids = result
+                .trim()
+                .split('\n')
+                .filter((p) => p);
+            for (const pid of pids) {
+                try {
+                    (0, child_process_1.execSync)(`kill -9 ${pid}`, { stdio: 'pipe' });
+                    if (verbose) {
+                        console.error(`[cleanup] Killed process ${pid} on port ${port}`);
+                    }
+                }
+                catch {
+                    // Process may have already exited
+                }
+            }
+            return pids.length > 0;
+        }
+    }
+    catch {
+        // No process on port or command failed
+        return false;
+    }
+}
+exports.killProcessOnPort = killProcessOnPort;
+exports.default = {
+    getPortCheckCommand,
+    getCatCommand,
+    getKillCLIProxyCommand,
+    getKillPidCommand,
+    getPlatformName,
+    killProcessByPid,
+    killAllCLIProxyProcesses,
+    killProcessOnPort,
+};
+//# sourceMappingURL=platform-commands.js.map

package/dist/utils/platform-commands.js.map

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

package/dist/utils/port-utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Port utilities for detecting process ownership
+ */
+export interface PortProcess {
+    pid: number;
+    processName: string;
+    commandLine?: string;
+}
+/**
+ * Get process information for a port
+ * @param port Port number to check
+ * @returns Process info or null if port is free
+ */
+export declare function getPortProcess(port: number): Promise<PortProcess | null>;
+/**
+ * Check if process is CLIProxy
+ * Uses prefix matching to handle Linux kernel's 15-char process name truncation
+ * (e.g., 'cli-proxy-api-plus' becomes 'cli-proxy-api-p' in lsof/ps output)
+ */
+export declare function isCLIProxyProcess(process: PortProcess | null): boolean;
+/**
+ * Windows firewall check result
+ */
+export interface FirewallCheckResult {
+    checked: boolean;
+    mayBlock: boolean;
+    message: string;
+    fixCommand?: string;
+}
+/**
+ * Check if Windows Firewall might block a port
+ * Returns immediately on non-Windows platforms
+ */
+export declare function checkWindowsFirewall(port: number): Promise<FirewallCheckResult>;
+/**
+ * Localhost binding test result
+ */
+export interface BindingTestResult {
+    success: boolean;
+    message: string;
+}
+/**
+ * Wait for a port to become free (no process listening)
+ * @param port Port number to wait for
+ * @param timeoutMs Maximum time to wait in milliseconds (default: 5000)
+ * @param pollIntervalMs Interval between checks in milliseconds (default: 200)
+ * @returns True if port became free, false if timeout
+ */
+export declare function waitForPortFree(port: number, timeoutMs?: number, pollIntervalMs?: number): Promise<boolean>;
+/**
+ * Test if we can bind to localhost on a specific port
+ * This verifies network stack is working and port is actually available
+ */
+export declare function testLocalhostBinding(port: number): Promise<BindingTestResult>;
+//# sourceMappingURL=port-utils.d.ts.map

package/dist/utils/port-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-utils.d.ts","sourceRoot":"","sources":["../../src/utils/port-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAa9E;AA8ED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAQtE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiCrF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,SAAO,EAChB,cAAc,SAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4BnF"}