@codewalla_india/openspec 1.0.1

package/dist/core/completions/installers/fish-installer.d.ts

@@ -0,0 +1,43 @@
+import { InstallationResult } from '../factory.js';
+/**
+ * Installer for Fish completion scripts.
+ * Fish automatically loads completions from ~/.config/fish/completions/
+ */
+export declare class FishInstaller {
+    private readonly homeDir;
+    constructor(homeDir?: string);
+    /**
+     * Get the installation path for Fish completions
+     *
+     * @returns Installation path
+     */
+    getInstallationPath(): string;
+    /**
+     * Backup an existing completion file if it exists
+     *
+     * @param targetPath - Path to the file to backup
+     * @returns Path to the backup file, or undefined if no backup was needed
+     */
+    backupExistingFile(targetPath: string): Promise<string | undefined>;
+    /**
+     * Install the completion script
+     *
+     * @param completionScript - The completion script content to install
+     * @returns Installation result with status and instructions
+     */
+    install(completionScript: string): Promise<InstallationResult>;
+    /**
+     * Uninstall the completion script
+     *
+     * @param options - Optional uninstall options
+     * @param options.yes - Skip confirmation prompt (handled by command layer)
+     * @returns Uninstallation result
+     */
+    uninstall(options?: {
+        yes?: boolean;
+    }): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=fish-installer.d.ts.map

package/dist/core/completions/installers/fish-installer.js

@@ -0,0 +1,151 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+import { FileSystemUtils } from '../../../utils/file-system.js';
+/**
+ * Installer for Fish completion scripts.
+ * Fish automatically loads completions from ~/.config/fish/completions/
+ */
+export class FishInstaller {
+    homeDir;
+    constructor(homeDir = os.homedir()) {
+        this.homeDir = homeDir;
+    }
+    /**
+     * Get the installation path for Fish completions
+     *
+     * @returns Installation path
+     */
+    getInstallationPath() {
+        return path.join(this.homeDir, '.config', 'fish', 'completions', 'openspec.fish');
+    }
+    /**
+     * Backup an existing completion file if it exists
+     *
+     * @param targetPath - Path to the file to backup
+     * @returns Path to the backup file, or undefined if no backup was needed
+     */
+    async backupExistingFile(targetPath) {
+        try {
+            await fs.access(targetPath);
+            // File exists, create a backup
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const backupPath = `${targetPath}.backup-${timestamp}`;
+            await fs.copyFile(targetPath, backupPath);
+            return backupPath;
+        }
+        catch {
+            // File doesn't exist, no backup needed
+            return undefined;
+        }
+    }
+    /**
+     * Install the completion script
+     *
+     * @param completionScript - The completion script content to install
+     * @returns Installation result with status and instructions
+     */
+    async install(completionScript) {
+        try {
+            const targetPath = this.getInstallationPath();
+            // Check if already installed with same content
+            let isUpdate = false;
+            try {
+                const existingContent = await fs.readFile(targetPath, 'utf-8');
+                if (existingContent === completionScript) {
+                    // Already installed and up to date
+                    return {
+                        success: true,
+                        installedPath: targetPath,
+                        message: 'Completion script is already installed (up to date)',
+                        instructions: [
+                            'The completion script is already installed and up to date.',
+                            'Fish automatically loads completions - they should be available immediately.',
+                        ],
+                    };
+                }
+                // File exists but content is different - this is an update
+                isUpdate = true;
+            }
+            catch (error) {
+                // File doesn't exist or can't be read, proceed with installation
+                console.debug(`Unable to read existing completion file at ${targetPath}: ${error.message}`);
+            }
+            if (!(await FileSystemUtils.canWriteFile(targetPath))) {
+                throw new Error(`Path is not writable: ${targetPath}`);
+            }
+            // Ensure the directory exists
+            const targetDir = path.dirname(targetPath);
+            await fs.mkdir(targetDir, { recursive: true });
+            // Backup existing file if updating
+            const backupPath = isUpdate ? await this.backupExistingFile(targetPath) : undefined;
+            // Write the completion script
+            await fs.writeFile(targetPath, completionScript, 'utf-8');
+            // Determine appropriate message
+            let message;
+            if (isUpdate) {
+                message = backupPath
+                    ? 'Completion script updated successfully (previous version backed up)'
+                    : 'Completion script updated successfully';
+            }
+            else {
+                message = 'Completion script installed successfully for Fish';
+            }
+            return {
+                success: true,
+                installedPath: targetPath,
+                backupPath,
+                message,
+                instructions: [
+                    'Fish automatically loads completions from ~/.config/fish/completions/',
+                    'Completions are available immediately - no shell restart needed.',
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to install completion script: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Uninstall the completion script
+     *
+     * @param options - Optional uninstall options
+     * @param options.yes - Skip confirmation prompt (handled by command layer)
+     * @returns Uninstallation result
+     */
+    async uninstall(options) {
+        try {
+            const targetPath = this.getInstallationPath();
+            // Check if installed
+            try {
+                await fs.access(targetPath);
+            }
+            catch {
+                return {
+                    success: false,
+                    message: 'Completion script is not installed',
+                };
+            }
+            const targetDir = path.dirname(targetPath);
+            if (!(await FileSystemUtils.canWriteFile(targetDir))) {
+                throw new Error(`Path is not writable: ${targetDir}`);
+            }
+            // Remove the completion script
+            await fs.unlink(targetPath);
+            return {
+                success: true,
+                message: 'Completion script uninstalled successfully',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to uninstall completion script: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=fish-installer.js.map

package/dist/core/completions/installers/powershell-installer.d.ts

@@ -0,0 +1,102 @@
+import { InstallationResult } from '../factory.js';
+/**
+ * Installer for PowerShell completion scripts.
+ * Works with both Windows PowerShell 5.1 and PowerShell Core 7+
+ */
+export declare class PowerShellInstaller {
+    private readonly homeDir;
+    /**
+     * Markers for PowerShell profile configuration management
+     */
+    private readonly PROFILE_MARKERS;
+    constructor(homeDir?: string);
+    /**
+     * Detect the encoding of a file by inspecting its BOM (Byte Order Mark).
+     * Returns the Node.js BufferEncoding and the raw BOM bytes to preserve on write.
+     */
+    private detectEncoding;
+    /**
+     * Read a profile file, preserving its encoding metadata for round-trip writes.
+     * Throws if the file uses UTF-16 BE (unsupported by Node).
+     */
+    private readProfileFile;
+    /**
+     * Write a profile file, preserving the original BOM and encoding.
+     */
+    private writeProfileFile;
+    /**
+     * Get PowerShell profile path
+     * Prefers $PROFILE environment variable, falls back to platform defaults
+     *
+     * @returns Profile path
+     */
+    getProfilePath(): string;
+    /**
+     * Get all PowerShell profile paths to configure.
+     * On Windows, returns both PowerShell Core and Windows PowerShell 5.1 paths.
+     * On Unix, returns PowerShell Core path only.
+     */
+    private getAllProfilePaths;
+    /**
+     * Get the installation path for the completion script
+     *
+     * @returns Installation path
+     */
+    getInstallationPath(): string;
+    /**
+     * Backup an existing completion file if it exists
+     *
+     * @param targetPath - Path to the file to backup
+     * @returns Path to the backup file, or undefined if no backup was needed
+     */
+    backupExistingFile(targetPath: string): Promise<string | undefined>;
+    /**
+     * Generate PowerShell profile configuration content
+     *
+     * @param scriptPath - Path to the completion script
+     * @returns Configuration content
+     */
+    private generateProfileConfig;
+    /**
+     * Configure PowerShell profile to source the completion script
+     *
+     * @param scriptPath - Path to the completion script
+     * @returns true if configured successfully, false otherwise
+     */
+    configureProfile(scriptPath: string): Promise<boolean>;
+    /**
+     * Remove PowerShell profile configuration
+     * Used during uninstallation
+     *
+     * @returns true if removed successfully, false otherwise
+     */
+    removeProfileConfig(): Promise<boolean>;
+    /**
+     * Install the completion script
+     *
+     * @param completionScript - The completion script content to install
+     * @returns Installation result with status and instructions
+     */
+    install(completionScript: string): Promise<InstallationResult>;
+    /**
+     * Generate user instructions for enabling completions
+     *
+     * @param installedPath - Path where the script was installed
+     * @returns Array of instruction strings
+     */
+    private generateInstructions;
+    /**
+     * Uninstall the completion script
+     *
+     * @param options - Optional uninstall options
+     * @param options.yes - Skip confirmation prompt (handled by command layer)
+     * @returns Uninstallation result
+     */
+    uninstall(options?: {
+        yes?: boolean;
+    }): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=powershell-installer.d.ts.map