@jonnyhoo/ccs 1.0.0

package/dist/management/oauth-port-diagnostics.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OAuth Port Diagnostics Module
+ *
+ * Pre-flight checks for OAuth callback ports to detect conflicts
+ * before users attempt authentication.
+ *
+ * OAuth flows require specific localhost ports for callbacks:
+ * - Gemini: 8085
+ * - Codex: 1455
+ * - Agy: 51121
+ * - iFlow: 11451
+ * - Kiro: 9876
+ * - Claude: 54545
+ * - Qwen: Device Code Flow (no port needed)
+ * - GHCP: Device Code Flow (no port needed)
+ */
+import { PortProcess } from '../utils/port-utils';
+import { CLIProxyProvider } from '../cliproxy/types';
+/**
+ * OAuth callback ports for each provider
+ * Extracted from CLIProxyAPI source
+ */
+export declare const OAUTH_CALLBACK_PORTS: Record<CLIProxyProvider, number | null>;
+/**
+ * OAuth flow types
+ */
+export type OAuthFlowType = 'authorization_code' | 'device_code';
+/**
+ * OAuth flow type per provider
+ */
+export declare const OAUTH_FLOW_TYPES: Record<CLIProxyProvider, OAuthFlowType>;
+/**
+ * Port diagnostic result
+ */
+export interface OAuthPortDiagnostic {
+    /** Provider name */
+    provider: CLIProxyProvider;
+    /** OAuth flow type */
+    flowType: OAuthFlowType;
+    /** Callback port (null for device code flow) */
+    port: number | null;
+    /** Port status */
+    status: 'free' | 'occupied' | 'cliproxy' | 'not_applicable';
+    /** Process occupying the port (if any) */
+    process: PortProcess | null;
+    /** Human-readable status message */
+    message: string;
+    /** Recommendation for fixing (if issue detected) */
+    recommendation: string | null;
+}
+/**
+ * Check OAuth port availability for a single provider
+ */
+export declare function checkOAuthPort(provider: CLIProxyProvider): Promise<OAuthPortDiagnostic>;
+/**
+ * Check OAuth ports for all providers
+ */
+export declare function checkAllOAuthPorts(): Promise<OAuthPortDiagnostic[]>;
+/**
+ * Check OAuth ports for providers that use Authorization Code flow only
+ */
+export declare function checkAuthCodePorts(): Promise<OAuthPortDiagnostic[]>;
+/**
+ * Get providers with port conflicts
+ */
+export declare function getPortConflicts(): Promise<OAuthPortDiagnostic[]>;
+/**
+ * Format OAuth port diagnostics for display
+ */
+export declare function formatOAuthPortDiagnostics(diagnostics: OAuthPortDiagnostic[]): string[];
+/**
+ * Enhanced pre-flight check result with detailed diagnostics
+ */
+export interface EnhancedPreflightResult {
+    ready: boolean;
+    issues: string[];
+    checks: PreflightCheck[];
+    firewallWarning?: string;
+    firewallFixCommand?: string;
+}
+/**
+ * Individual pre-flight check result
+ */
+export interface PreflightCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    message: string;
+    fixCommand?: string;
+}
+/**
+ * Pre-flight check before OAuth - returns issues or empty array if OK
+ * @deprecated Use enhancedPreflightOAuthCheck for more detailed diagnostics
+ */
+export declare function preflightOAuthCheck(provider: CLIProxyProvider): Promise<{
+    ready: boolean;
+    issues: string[];
+}>;
+/**
+ * Enhanced pre-flight check with detailed step-by-step diagnostics
+ * Returns structured results for real-time display
+ */
+export declare function enhancedPreflightOAuthCheck(provider: CLIProxyProvider): Promise<EnhancedPreflightResult>;
+declare const _default: {
+    OAUTH_CALLBACK_PORTS: Record<CLIProxyProvider, number | null>;
+    OAUTH_FLOW_TYPES: Record<CLIProxyProvider, OAuthFlowType>;
+    checkOAuthPort: typeof checkOAuthPort;
+    checkAllOAuthPorts: typeof checkAllOAuthPorts;
+    checkAuthCodePorts: typeof checkAuthCodePorts;
+    getPortConflicts: typeof getPortConflicts;
+    formatOAuthPortDiagnostics: typeof formatOAuthPortDiagnostics;
+    preflightOAuthCheck: typeof preflightOAuthCheck;
+    enhancedPreflightOAuthCheck: typeof enhancedPreflightOAuthCheck;
+};
+export default _default;
+//# sourceMappingURL=oauth-port-diagnostics.d.ts.map

package/dist/management/oauth-port-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-port-diagnostics.d.ts","sourceRoot":"","sources":["../../src/management/oauth-port-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,WAAW,EAMZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CASxE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,aAAa,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,aAAa,CASpE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;IAC5D,0CAA0C;IAC1C,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuD7F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAUzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAkCvF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAC7E,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAMD;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CA4FlC;;;;;;;;;;;;AAED,wBAUE"}

package/dist/management/oauth-port-diagnostics.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * OAuth Port Diagnostics Module
+ *
+ * Pre-flight checks for OAuth callback ports to detect conflicts
+ * before users attempt authentication.
+ *
+ * OAuth flows require specific localhost ports for callbacks:
+ * - Gemini: 8085
+ * - Codex: 1455
+ * - Agy: 51121
+ * - iFlow: 11451
+ * - Kiro: 9876
+ * - Claude: 54545
+ * - Qwen: Device Code Flow (no port needed)
+ * - GHCP: Device Code Flow (no port needed)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhancedPreflightOAuthCheck = exports.preflightOAuthCheck = exports.formatOAuthPortDiagnostics = exports.getPortConflicts = exports.checkAuthCodePorts = exports.checkAllOAuthPorts = exports.checkOAuthPort = exports.OAUTH_FLOW_TYPES = exports.OAUTH_CALLBACK_PORTS = void 0;
+const port_utils_1 = require("../utils/port-utils");
+const profile_detector_1 = require("../auth/profile-detector");
+/**
+ * OAuth callback ports for each provider
+ * Extracted from CLIProxyAPI source
+ */
+exports.OAUTH_CALLBACK_PORTS = {
+    gemini: 8085,
+    codex: 1455,
+    agy: 51121,
+    qwen: null, // Device Code Flow - no callback port
+    iflow: 11451, // Authorization Code Flow
+    kiro: 9876, // Authorization Code Flow
+    ghcp: null, // Device Code Flow - no callback port
+    claude: 54545, // Authorization Code Flow (Anthropic OAuth)
+};
+/**
+ * OAuth flow type per provider
+ */
+exports.OAUTH_FLOW_TYPES = {
+    gemini: 'authorization_code',
+    codex: 'authorization_code',
+    agy: 'authorization_code',
+    qwen: 'device_code',
+    iflow: 'authorization_code',
+    kiro: 'authorization_code',
+    ghcp: 'device_code',
+    claude: 'authorization_code',
+};
+/**
+ * Check OAuth port availability for a single provider
+ */
+async function checkOAuthPort(provider) {
+    const port = exports.OAUTH_CALLBACK_PORTS[provider];
+    const flowType = exports.OAUTH_FLOW_TYPES[provider];
+    // Device code flow doesn't need callback port
+    if (port === null) {
+        return {
+            provider,
+            flowType,
+            port: null,
+            status: 'not_applicable',
+            process: null,
+            message: 'Uses Device Code Flow (no callback port needed)',
+            recommendation: null,
+        };
+    }
+    // Check if port is in use
+    const portProcess = await (0, port_utils_1.getPortProcess)(port);
+    if (!portProcess) {
+        return {
+            provider,
+            flowType,
+            port,
+            status: 'free',
+            process: null,
+            message: `Port ${port} is available`,
+            recommendation: null,
+        };
+    }
+    // Check if it's CLIProxy (expected if proxy is running)
+    if ((0, port_utils_1.isCLIProxyProcess)(portProcess)) {
+        return {
+            provider,
+            flowType,
+            port,
+            status: 'cliproxy',
+            process: portProcess,
+            message: `Port ${port} in use by CLIProxy (expected)`,
+            recommendation: null,
+        };
+    }
+    // Port is occupied by another process
+    return {
+        provider,
+        flowType,
+        port,
+        status: 'occupied',
+        process: portProcess,
+        message: `Port ${port} occupied by ${portProcess.processName}`,
+        recommendation: `Kill process: kill ${portProcess.pid} (or close ${portProcess.processName})`,
+    };
+}
+exports.checkOAuthPort = checkOAuthPort;
+/**
+ * Check OAuth ports for all providers
+ */
+async function checkAllOAuthPorts() {
+    const providers = [...profile_detector_1.CLIPROXY_PROFILES];
+    const results = [];
+    for (const provider of providers) {
+        const diagnostic = await checkOAuthPort(provider);
+        results.push(diagnostic);
+    }
+    return results;
+}
+exports.checkAllOAuthPorts = checkAllOAuthPorts;
+/**
+ * Check OAuth ports for providers that use Authorization Code flow only
+ */
+async function checkAuthCodePorts() {
+    // Filter providers that use authorization_code flow (DRY: derive from OAUTH_FLOW_TYPES)
+    const providers = profile_detector_1.CLIPROXY_PROFILES.filter((p) => exports.OAUTH_FLOW_TYPES[p] === 'authorization_code');
+    const results = [];
+    for (const provider of providers) {
+        const diagnostic = await checkOAuthPort(provider);
+        results.push(diagnostic);
+    }
+    return results;
+}
+exports.checkAuthCodePorts = checkAuthCodePorts;
+/**
+ * Get providers with port conflicts
+ */
+async function getPortConflicts() {
+    const allPorts = await checkAllOAuthPorts();
+    return allPorts.filter((d) => d.status === 'occupied');
+}
+exports.getPortConflicts = getPortConflicts;
+/**
+ * Format OAuth port diagnostics for display
+ */
+function formatOAuthPortDiagnostics(diagnostics) {
+    const lines = [];
+    for (const diag of diagnostics) {
+        const providerName = diag.provider.charAt(0).toUpperCase() + diag.provider.slice(1);
+        const portStr = diag.port !== null ? `(${diag.port})` : '';
+        let statusIcon;
+        switch (diag.status) {
+            case 'free':
+                statusIcon = '[OK]';
+                break;
+            case 'cliproxy':
+                statusIcon = '[OK]';
+                break;
+            case 'occupied':
+                statusIcon = '[!]';
+                break;
+            case 'not_applicable':
+                statusIcon = '[i]';
+                break;
+            default:
+                statusIcon = '[?]';
+        }
+        const label = `${providerName} ${portStr}`.padEnd(20);
+        lines.push(`${statusIcon} ${label} ${diag.message}`);
+        if (diag.recommendation) {
+            lines.push(`                        → ${diag.recommendation}`);
+        }
+    }
+    return lines;
+}
+exports.formatOAuthPortDiagnostics = formatOAuthPortDiagnostics;
+/**
+ * Pre-flight check before OAuth - returns issues or empty array if OK
+ * @deprecated Use enhancedPreflightOAuthCheck for more detailed diagnostics
+ */
+async function preflightOAuthCheck(provider) {
+    const result = await enhancedPreflightOAuthCheck(provider);
+    return {
+        ready: result.ready,
+        issues: result.issues,
+    };
+}
+exports.preflightOAuthCheck = preflightOAuthCheck;
+/**
+ * Enhanced pre-flight check with detailed step-by-step diagnostics
+ * Returns structured results for real-time display
+ */
+async function enhancedPreflightOAuthCheck(provider) {
+    const port = exports.OAUTH_CALLBACK_PORTS[provider];
+    const flowType = exports.OAUTH_FLOW_TYPES[provider];
+    const checks = [];
+    const issues = [];
+    // Device code flow doesn't need port checks
+    if (flowType === 'device_code' || port === null) {
+        checks.push({
+            name: 'OAuth Flow',
+            status: 'ok',
+            message: 'Uses Device Code Flow (no callback port needed)',
+        });
+        return { ready: true, issues: [], checks };
+    }
+    // Check 1: Port availability via process detection
+    const portProcess = await (0, port_utils_1.getPortProcess)(port);
+    if (portProcess && !(0, port_utils_1.isCLIProxyProcess)(portProcess)) {
+        checks.push({
+            name: 'Port Availability',
+            status: 'fail',
+            message: `Port ${port} blocked by ${portProcess.processName} (PID ${portProcess.pid})`,
+            fixCommand: process.platform === 'win32'
+                ? `taskkill /F /PID ${portProcess.pid}`
+                : `kill ${portProcess.pid}`,
+        });
+        issues.push(`Port ${port} is blocked by ${portProcess.processName} (PID ${portProcess.pid})`);
+    }
+    else if (portProcess && (0, port_utils_1.isCLIProxyProcess)(portProcess)) {
+        checks.push({
+            name: 'Port Availability',
+            status: 'ok',
+            message: `Port ${port} in use by CLIProxy (OK)`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'Port Availability',
+            status: 'ok',
+            message: `Port ${port} is available`,
+        });
+    }
+    // Check 2: Localhost binding test (verifies we can actually listen)
+    const bindingResult = await (0, port_utils_1.testLocalhostBinding)(port);
+    if (!bindingResult.success && !portProcess) {
+        // Only fail if no process found but binding failed (weird state)
+        checks.push({
+            name: 'Localhost Binding',
+            status: 'warn',
+            message: bindingResult.message,
+        });
+    }
+    else if (bindingResult.success) {
+        checks.push({
+            name: 'Localhost Binding',
+            status: 'ok',
+            message: 'Can bind to localhost',
+        });
+    }
+    // Check 3: Windows Firewall (only on Windows)
+    let firewallWarning;
+    let firewallFixCommand;
+    if (process.platform === 'win32') {
+        const firewallResult = await (0, port_utils_1.checkWindowsFirewall)(port);
+        if (firewallResult.mayBlock) {
+            checks.push({
+                name: 'Windows Firewall',
+                status: 'warn',
+                message: firewallResult.message,
+                fixCommand: firewallResult.fixCommand,
+            });
+            firewallWarning = firewallResult.message;
+            firewallFixCommand = firewallResult.fixCommand;
+            // Don't add to issues - just a warning, not a blocker
+        }
+        else if (firewallResult.checked) {
+            checks.push({
+                name: 'Windows Firewall',
+                status: 'ok',
+                message: 'Firewall rules allow port',
+            });
+        }
+    }
+    return {
+        ready: issues.length === 0,
+        issues,
+        checks,
+        firewallWarning,
+        firewallFixCommand,
+    };
+}
+exports.enhancedPreflightOAuthCheck = enhancedPreflightOAuthCheck;
+exports.default = {
+    OAUTH_CALLBACK_PORTS: exports.OAUTH_CALLBACK_PORTS,
+    OAUTH_FLOW_TYPES: exports.OAUTH_FLOW_TYPES,
+    checkOAuthPort,
+    checkAllOAuthPorts,
+    checkAuthCodePorts,
+    getPortConflicts,
+    formatOAuthPortDiagnostics,
+    preflightOAuthCheck,
+    enhancedPreflightOAuthCheck,
+};
+//# sourceMappingURL=oauth-port-diagnostics.js.map

package/dist/management/oauth-port-diagnostics.js.map

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

package/dist/management/recovery-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Auto-recovery for missing or corrupted configuration
+ * Lazy initialization: Creates ~/.ccs/ structure on first CLI run
+ * Mirrors postinstall.js behavior for package managers that skip lifecycle scripts (e.g., bun)
+ */
+/**
+ * Recovery Manager Class
+ */
+declare class RecoveryManager {
+    private readonly homedir;
+    private readonly ccsDir;
+    private readonly claudeDir;
+    private readonly sharedDir;
+    private readonly completionsDir;
+    private recovered;
+    constructor();
+    /**
+     * Ensure ~/.ccs/ directory exists
+     */
+    ensureCcsDirectory(): boolean;
+    /**
+     * Ensure ~/.ccs/config.yaml exists with defaults
+     * This is the primary config format (YAML unified config)
+     */
+    ensureConfigYaml(): boolean;
+    /**
+     * Ensure ~/.claude/settings.json exists
+     */
+    ensureClaudeSettings(): boolean;
+    /**
+     * Ensure ~/.ccs/shared/ directory structure exists
+     */
+    ensureSharedDirectories(): boolean;
+    /**
+     * Install shell completion files
+     */
+    ensureShellCompletions(): boolean;
+    /**
+     * Run all recovery operations (lazy initialization)
+     * Mirrors postinstall.js behavior
+     *
+     * NOTE: GLM/GLMT/Kimi profiles are NOT auto-created.
+     * Users should create them via `ccs api create --preset glm` or the UI.
+     */
+    recoverAll(): boolean;
+    /**
+     * Get recovery summary
+     */
+    getRecoverySummary(): string[];
+    /**
+     * Show recovery hints
+     */
+    showRecoveryHints(): void;
+}
+export default RecoveryManager;
+//# sourceMappingURL=recovery-manager.d.ts.map

package/dist/management/recovery-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-manager.d.ts","sourceRoot":"","sources":["../../src/management/recovery-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,SAAS,CAAW;;IAW5B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAS7B;;;OAGG;IACH,gBAAgB,IAAI,OAAO;IA4C3B;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAsB/B;;OAEG;IACH,uBAAuB,IAAI,OAAO;IAuBlC;;OAEG;IACH,sBAAsB,IAAI,OAAO;IA+CjC;;;;;;OAMG;IACH,UAAU,IAAI,OAAO;IAiBrB;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAgB1B;AAED,eAAe,eAAe,CAAC"}