@plusplusoneplusplus/coc 1.0.1 → 1.0.3

package/node_modules/@plusplusoneplusplus/forge/dist/utils/external-terminal-launcher.js

@@ -0,0 +1,317 @@
+"use strict";
+/**
+ * External Terminal Launcher
+ *
+ * Platform-specific logic for launching external terminal applications
+ * with AI CLI tools (copilot, claude) for interactive sessions.
+ *
+ * Supports:
+ * - macOS: Terminal.app, iTerm2
+ * - Windows: Windows Terminal, cmd.exe, PowerShell
+ * - Linux: gnome-terminal, konsole, xfce4-terminal, xterm
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalTerminalLauncher = void 0;
+exports.getExternalTerminalLauncher = getExternalTerminalLauncher;
+exports.resetExternalTerminalLauncher = resetExternalTerminalLauncher;
+const child_process_1 = require("child_process");
+const cli_utils_1 = require("../ai/cli-utils");
+/**
+ * Terminal configurations by platform and terminal type
+ */
+const TERMINAL_CONFIGS = {
+    darwin: {
+        'iterm': {
+            checkCommand: 'osascript -e \'application "iTerm" exists\'',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'osascript',
+                args: [
+                    '-e', `tell application "iTerm"`,
+                    '-e', `create window with default profile`,
+                    '-e', `tell current session of current window`,
+                    '-e', `write text "cd ${escapeAppleScript(cwd)} && ${escapeAppleScript(command)}"`,
+                    '-e', `end tell`,
+                    '-e', `end tell`
+                ]
+            })
+        },
+        'terminal.app': {
+            checkCommand: 'osascript -e \'application "Terminal" exists\'',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'osascript',
+                args: [
+                    '-e', `tell application "Terminal"`,
+                    '-e', `do script "cd ${escapeAppleScript(cwd)} && ${escapeAppleScript(command)}"`,
+                    '-e', `activate`,
+                    '-e', `end tell`
+                ]
+            })
+        }
+    },
+    win32: {
+        'windows-terminal': {
+            checkCommand: 'where wt',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'wt',
+                args: ['-d', cwd, 'cmd', '/k', command]
+            })
+        },
+        'powershell': {
+            checkCommand: 'where powershell',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'powershell',
+                args: ['-NoExit', '-Command', `Set-Location '${cwd}'; ${command}`]
+            })
+        },
+        'cmd': {
+            checkCommand: 'where cmd',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'cmd',
+                args: ['/k', `cd /d "${cwd}" && ${command}`]
+            })
+        }
+    },
+    linux: {
+        'gnome-terminal': {
+            checkCommand: 'which gnome-terminal',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'gnome-terminal',
+                args: ['--working-directory', cwd, '--', 'bash', '-c', `${command}; exec bash`]
+            })
+        },
+        'konsole': {
+            checkCommand: 'which konsole',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'konsole',
+                args: ['--workdir', cwd, '-e', 'bash', '-c', `${command}; exec bash`]
+            })
+        },
+        'xfce4-terminal': {
+            checkCommand: 'which xfce4-terminal',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'xfce4-terminal',
+                args: ['--working-directory', cwd, '-e', `bash -c "${command}; exec bash"`]
+            })
+        },
+        'xterm': {
+            checkCommand: 'which xterm',
+            buildSpawnArgs: (cwd, command) => ({
+                cmd: 'xterm',
+                args: ['-e', `cd "${cwd}" && ${command} && exec bash`]
+            })
+        }
+    }
+};
+/**
+ * Order of terminal preference by platform
+ */
+const TERMINAL_PREFERENCE_ORDER = {
+    darwin: ['iterm', 'terminal.app'],
+    win32: ['windows-terminal', 'powershell', 'cmd'],
+    linux: ['gnome-terminal', 'konsole', 'xfce4-terminal', 'xterm']
+};
+/**
+ * Escape a string for use in AppleScript double-quoted strings.
+ * Only backslashes and double quotes need escaping.
+ * Single quotes are safe inside AppleScript double-quoted strings.
+ */
+function escapeAppleScript(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"');
+}
+/**
+ * External Terminal Launcher
+ *
+ * Handles platform-specific detection and launching of external terminals
+ * for interactive AI CLI sessions.
+ */
+class ExternalTerminalLauncher {
+    constructor(platform, execSyncFn, spawnFn) {
+        this.terminalCache = new Map();
+        this.platform = platform ?? process.platform;
+        this.execSyncFn = execSyncFn ?? child_process_1.execSync;
+        this.spawnFn = spawnFn ?? child_process_1.spawn;
+    }
+    /**
+     * Get the current platform
+     */
+    getPlatform() {
+        return this.platform;
+    }
+    /**
+     * Check if a specific terminal is available on the system
+     */
+    isTerminalAvailable(terminalType) {
+        // Check cache first
+        const cached = this.terminalCache.get(terminalType);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const platformKey = this.getPlatformKey();
+        const configs = TERMINAL_CONFIGS[platformKey];
+        if (!configs || !configs[terminalType]) {
+            this.terminalCache.set(terminalType, false);
+            return false;
+        }
+        const config = configs[terminalType];
+        try {
+            this.execSyncFn(config.checkCommand, {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 5000
+            });
+            this.terminalCache.set(terminalType, true);
+            return true;
+        }
+        catch {
+            this.terminalCache.set(terminalType, false);
+            return false;
+        }
+    }
+    /**
+     * Detect the best available terminal for the current platform
+     */
+    detectTerminal() {
+        const platformKey = this.getPlatformKey();
+        const preferenceOrder = TERMINAL_PREFERENCE_ORDER[platformKey];
+        if (!preferenceOrder) {
+            return 'unknown';
+        }
+        for (const terminal of preferenceOrder) {
+            if (this.isTerminalAvailable(terminal)) {
+                return terminal;
+            }
+        }
+        return 'unknown';
+    }
+    /**
+     * Get all available terminals for the current platform
+     */
+    getAvailableTerminals() {
+        const platformKey = this.getPlatformKey();
+        const preferenceOrder = TERMINAL_PREFERENCE_ORDER[platformKey];
+        if (!preferenceOrder) {
+            return [];
+        }
+        return preferenceOrder.filter(terminal => this.isTerminalAvailable(terminal));
+    }
+    /**
+     * Launch an external terminal with the specified options
+     */
+    async launch(options) {
+        const { workingDirectory, tool, initialPrompt, preferredTerminal, model, resumeSessionId } = options;
+        // Determine which terminal to use
+        let terminalType;
+        if (preferredTerminal && this.isTerminalAvailable(preferredTerminal)) {
+            terminalType = preferredTerminal;
+        }
+        else {
+            terminalType = this.detectTerminal();
+        }
+        if (terminalType === 'unknown') {
+            return {
+                success: false,
+                terminalType: 'unknown',
+                error: `No supported terminal found for platform: ${this.platform}`
+            };
+        }
+        // Build the CLI command (with optional session resume)
+        const result = (0, cli_utils_1.buildCliCommand)(tool, { prompt: initialPrompt, model, resumeSessionId });
+        const command = result.command;
+        // Get the terminal configuration
+        const platformKey = this.getPlatformKey();
+        const config = TERMINAL_CONFIGS[platformKey]?.[terminalType];
+        if (!config) {
+            return {
+                success: false,
+                terminalType,
+                error: `Terminal configuration not found for: ${terminalType}`
+            };
+        }
+        try {
+            const { cmd, args } = config.buildSpawnArgs(workingDirectory, command);
+            const spawnOptions = {
+                detached: true,
+                stdio: 'ignore',
+                // On Windows, we need shell: true for some commands
+                shell: this.platform === 'win32'
+            };
+            const child = this.spawnFn(cmd, args, spawnOptions);
+            // Unref to allow the parent process to exit independently
+            child.unref();
+            return {
+                success: true,
+                terminalType,
+                pid: child.pid
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                terminalType,
+                error: `Failed to launch terminal: ${errorMessage}`
+            };
+        }
+    }
+    /**
+     * Get the platform key for configuration lookup
+     */
+    getPlatformKey() {
+        // Normalize platform to our supported keys
+        if (this.platform === 'darwin') {
+            return 'darwin';
+        }
+        else if (this.platform === 'win32') {
+            return 'win32';
+        }
+        else {
+            // All other Unix-like systems use linux config
+            return 'linux';
+        }
+    }
+    /**
+     * Clear the terminal availability cache
+     */
+    clearCache() {
+        this.terminalCache.clear();
+    }
+    /**
+     * Get supported terminals for a specific platform
+     */
+    static getSupportedTerminals(platform) {
+        let platformKey;
+        if (platform === 'darwin') {
+            platformKey = 'darwin';
+        }
+        else if (platform === 'win32') {
+            platformKey = 'win32';
+        }
+        else {
+            platformKey = 'linux';
+        }
+        return TERMINAL_PREFERENCE_ORDER[platformKey] ?? [];
+    }
+}
+exports.ExternalTerminalLauncher = ExternalTerminalLauncher;
+/**
+ * Singleton instance for convenience
+ */
+let defaultLauncher;
+/**
+ * Get the default ExternalTerminalLauncher instance
+ */
+function getExternalTerminalLauncher() {
+    if (!defaultLauncher) {
+        defaultLauncher = new ExternalTerminalLauncher();
+    }
+    return defaultLauncher;
+}
+/**
+ * Reset the default launcher (useful for testing)
+ */
+function resetExternalTerminalLauncher() {
+    defaultLauncher = undefined;
+}
+//# sourceMappingURL=external-terminal-launcher.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/external-terminal-launcher.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/utils/file-utils.d.ts

@@ -0,0 +1,228 @@
+/**
+ * File Utilities
+ *
+ * Centralized file I/O utilities with consistent error handling.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ *
+ * These utilities provide:
+ * - Consistent error handling across all file operations
+ * - Type-safe return values with explicit error states
+ * - YAML file reading/writing with proper parsing
+ * - Directory operations with recursive support
+ */
+import * as fs from 'fs';
+/**
+ * Result type for file operations that may fail.
+ * Provides explicit success/failure states with error information.
+ */
+export interface FileOperationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    errorCode?: string;
+}
+/**
+ * Options for file reading operations
+ */
+export interface ReadFileOptions {
+    /** Encoding to use (default: 'utf8') */
+    encoding?: BufferEncoding;
+}
+/**
+ * Options for file writing operations
+ */
+export interface WriteFileOptions {
+    /** Encoding to use (default: 'utf8') */
+    encoding?: BufferEncoding;
+    /** Create parent directories if they don't exist (default: true) */
+    createDirs?: boolean;
+}
+/**
+ * Options for YAML operations
+ */
+export interface YAMLOptions {
+    /** Indentation level (default: 2) */
+    indent?: number;
+    /** Line width for wrapping (-1 for no wrap, default: -1) */
+    lineWidth?: number;
+    /** Disable YAML references (default: true) */
+    noRefs?: boolean;
+}
+/**
+ * Safely checks if a file or directory exists.
+ *
+ * @param filePath - Path to check
+ * @returns True if the path exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (safeExists('/path/to/file.txt')) {
+ *     // File exists
+ * }
+ * ```
+ */
+export declare function safeExists(filePath: string): boolean;
+/**
+ * Safely checks if a path is a directory.
+ *
+ * @param dirPath - Path to check
+ * @returns True if the path is a directory, false otherwise
+ */
+export declare function safeIsDirectory(dirPath: string): boolean;
+/**
+ * Safely checks if a path is a file.
+ *
+ * @param filePath - Path to check
+ * @returns True if the path is a file, false otherwise
+ */
+export declare function safeIsFile(filePath: string): boolean;
+/**
+ * Safely reads a file and returns its contents.
+ *
+ * @param filePath - Path to the file to read
+ * @param options - Optional read options
+ * @returns FileOperationResult with the file contents or error information
+ *
+ * @example
+ * ```typescript
+ * const result = safeReadFile('/path/to/file.txt');
+ * if (result.success) {
+ *     console.log(result.data);
+ * } else {
+ *     console.error('Failed to read:', result.error?.message);
+ * }
+ * ```
+ */
+export declare function safeReadFile(filePath: string, options?: ReadFileOptions): FileOperationResult<string>;
+/**
+ * Safely writes content to a file.
+ *
+ * @param filePath - Path to the file to write
+ * @param content - Content to write
+ * @param options - Optional write options
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = safeWriteFile('/path/to/file.txt', 'Hello, World!');
+ * if (!result.success) {
+ *     console.error('Failed to write:', result.error?.message);
+ * }
+ * ```
+ */
+export declare function safeWriteFile(filePath: string, content: string, options?: WriteFileOptions): FileOperationResult<void>;
+/**
+ * Ensures a directory exists, creating it recursively if necessary.
+ *
+ * @param dirPath - Path to the directory
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = ensureDirectoryExists('/path/to/new/directory');
+ * if (result.success) {
+ *     // Directory now exists
+ * }
+ * ```
+ */
+export declare function ensureDirectoryExists(dirPath: string): FileOperationResult<void>;
+/**
+ * Safely reads a directory and returns its entries.
+ *
+ * @param dirPath - Path to the directory to read
+ * @param withFileTypes - If true, returns Dirent objects with file type info
+ * @returns FileOperationResult with directory entries or error information
+ *
+ * @example
+ * ```typescript
+ * const result = safeReadDir('/path/to/directory');
+ * if (result.success) {
+ *     result.data?.forEach(entry => console.log(entry));
+ * }
+ * ```
+ */
+export declare function safeReadDir(dirPath: string): FileOperationResult<string[]>;
+export declare function safeReadDir(dirPath: string, withFileTypes: true): FileOperationResult<fs.Dirent[]>;
+export declare function safeReadDir(dirPath: string, withFileTypes: false): FileOperationResult<string[]>;
+/**
+ * Safely gets file stats.
+ *
+ * @param filePath - Path to the file
+ * @returns FileOperationResult with fs.Stats or error information
+ */
+export declare function safeStats(filePath: string): FileOperationResult<fs.Stats>;
+/**
+ * Reads and parses a YAML file.
+ *
+ * @param filePath - Path to the YAML file
+ * @returns FileOperationResult with parsed YAML content or error information
+ *
+ * @example
+ * ```typescript
+ * interface Config {
+ *     name: string;
+ *     version: number;
+ * }
+ *
+ * const result = readYAML<Config>('/path/to/config.yaml');
+ * if (result.success && result.data) {
+ *     console.log(result.data.name);
+ * }
+ * ```
+ */
+export declare function readYAML<T = unknown>(filePath: string): FileOperationResult<T>;
+/**
+ * Writes data to a YAML file.
+ *
+ * @param filePath - Path to the YAML file
+ * @param data - Data to serialize and write
+ * @param options - Optional YAML serialization options
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const config = { name: 'MyApp', version: 1 };
+ * const result = writeYAML('/path/to/config.yaml', config);
+ * if (!result.success) {
+ *     console.error('Failed to write YAML:', result.error?.message);
+ * }
+ * ```
+ */
+export declare function writeYAML<T>(filePath: string, data: T, options?: YAMLOptions): FileOperationResult<void>;
+/**
+ * Safely copies a file from source to destination.
+ *
+ * @param srcPath - Source file path
+ * @param destPath - Destination file path
+ * @param createDirs - Create parent directories if they don't exist (default: true)
+ * @returns FileOperationResult indicating success or failure
+ */
+export declare function safeCopyFile(srcPath: string, destPath: string, createDirs?: boolean): FileOperationResult<void>;
+/**
+ * Safely renames/moves a file or directory.
+ *
+ * @param oldPath - Current path
+ * @param newPath - New path
+ * @returns FileOperationResult indicating success or failure
+ */
+export declare function safeRename(oldPath: string, newPath: string): FileOperationResult<void>;
+/**
+ * Safely removes a file or directory.
+ *
+ * @param targetPath - Path to remove
+ * @param options - Options for removal
+ * @returns FileOperationResult indicating success or failure
+ */
+export declare function safeRemove(targetPath: string, options?: {
+    recursive?: boolean;
+    force?: boolean;
+}): FileOperationResult<void>;
+/**
+ * Gets a user-friendly error message for common file operation errors.
+ *
+ * @param errorCode - The error code from a file operation
+ * @param context - Optional context about what operation was being performed
+ * @returns A user-friendly error message
+ */
+export declare function getFileErrorMessage(errorCode: string, context?: string): string;
+//# sourceMappingURL=file-utils.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/file-utils.d.ts.map

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