@vybestack/llxprt-code-core 0.1.15 → 0.1.16

package/dist/src/prompt-config/prompt-installer.js

@@ -0,0 +1,723 @@
+/**
+ * Prompt Installer - Creates directory structure and installs default prompt files
+ * while preserving user customizations.
+ *
+ * This is a TDD stub implementation. All methods throw "Not implemented" errors.
+ */
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { existsSync } from 'fs';
+// Constants
+export const DEFAULT_BASE_DIR = '~/.llxprt/prompts';
+export const REQUIRED_DIRECTORIES = [
+    '', // Base directory
+    'env', // Environment-specific prompts
+    'tools', // Tool-specific prompts
+    'providers', // Provider overrides
+];
+// Schema for defaults map
+export const DefaultsMapSchema = z.record(z.string(), z.string());
+/**
+ * PromptInstaller handles installation, validation, and maintenance of prompt files
+ */
+export class PromptInstaller {
+    /**
+     * Install default prompt files
+     * @param baseDir - Base directory for prompts (defaults to DEFAULT_BASE_DIR)
+     * @param defaults - Map of relative path to file content
+     * @param options - Installation options
+     * @returns Installation result with success status and details
+     */
+    async install(baseDir, defaults, options) {
+        const installed = [];
+        const skipped = [];
+        const errors = [];
+        // Prepare installation
+        let expandedBaseDir = baseDir;
+        if (!expandedBaseDir) {
+            expandedBaseDir = this.expandPath(DEFAULT_BASE_DIR);
+        }
+        // Validate baseDir
+        if (expandedBaseDir.includes('..') || !path.isAbsolute(expandedBaseDir)) {
+            return {
+                success: false,
+                installed: [],
+                skipped: [],
+                errors: ['Invalid base directory'],
+                baseDir: expandedBaseDir,
+            };
+        }
+        // Create directory structure
+        for (const dir of REQUIRED_DIRECTORIES) {
+            const fullPath = path.join(expandedBaseDir, dir);
+            if (options?.dryRun) {
+                if (options?.verbose) {
+                    console.log('Would create:', fullPath);
+                }
+            }
+            else {
+                try {
+                    await fs.mkdir(fullPath, { recursive: true, mode: 0o755 });
+                    if (options?.verbose) {
+                        console.log('Created directory:', fullPath);
+                    }
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    if (errorMsg.includes('EACCES') ||
+                        errorMsg.includes('permission denied')) {
+                        errors.push(`Permission denied: ${fullPath}`);
+                    }
+                    else {
+                        errors.push(`Failed to create directory ${fullPath}: ${errorMsg}`);
+                    }
+                }
+            }
+        }
+        // Install default files
+        for (const [relativePath, content] of Object.entries(defaults)) {
+            const fullPath = path.join(expandedBaseDir, relativePath);
+            const fileDir = path.dirname(fullPath);
+            // Create parent directory if needed
+            if (!existsSync(fileDir) && !options?.dryRun) {
+                try {
+                    await fs.mkdir(fileDir, { recursive: true, mode: 0o755 });
+                }
+                catch (error) {
+                    errors.push(`Failed to create directory ${fileDir}: ${error instanceof Error ? error.message : String(error)}`);
+                    continue;
+                }
+            }
+            // Check existing file
+            if (!options?.dryRun && existsSync(fullPath) && !options?.force) {
+                skipped.push(relativePath);
+                if (options?.verbose) {
+                    console.log('Preserving existing:', relativePath);
+                }
+                continue;
+            }
+            // Write file
+            if (options?.dryRun) {
+                if (options?.verbose) {
+                    console.log('Would write:', fullPath);
+                }
+                installed.push(relativePath);
+            }
+            else {
+                const tempPath = `${fullPath}.tmp.${Date.now()}.${Math.random().toString(36).substring(7)}`;
+                try {
+                    // Write to temp file first (atomic write)
+                    await fs.writeFile(tempPath, content, { mode: 0o644 });
+                    // Rename temp to final - this is atomic and will fail if file exists
+                    try {
+                        await fs.rename(tempPath, fullPath);
+                        installed.push(relativePath);
+                        if (options?.verbose) {
+                            console.log('Installed:', relativePath);
+                        }
+                    }
+                    catch (renameError) {
+                        // If rename failed because file already exists, it's OK (race condition)
+                        const renameMsg = renameError instanceof Error
+                            ? renameError.message
+                            : String(renameError);
+                        if (renameMsg.includes('EEXIST') || existsSync(fullPath)) {
+                            skipped.push(relativePath);
+                            // Clean up temp file
+                            await fs.unlink(tempPath);
+                        }
+                        else {
+                            throw renameError;
+                        }
+                    }
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    if (errorMsg.includes('EACCES') ||
+                        errorMsg.includes('Permission denied')) {
+                        errors.push(`Permission denied: ${fullPath}. Try running with elevated permissions or changing the directory ownership.`);
+                    }
+                    else if (errorMsg.includes('ENOSPC')) {
+                        errors.push(`Disk full: Cannot write ${fullPath}. Free up some disk space and try again.`);
+                    }
+                    else {
+                        errors.push(`Failed to write ${fullPath}: ${errorMsg}`);
+                    }
+                    // Clean up temp file if it exists
+                    try {
+                        await fs.unlink(tempPath);
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                }
+            }
+        }
+        // Set permissions on all files (if not dry run)
+        if (!options?.dryRun && errors.length === 0) {
+            try {
+                // Set base directory permissions
+                await fs.chmod(expandedBaseDir, 0o755);
+                // Set permissions on all subdirectories
+                for (const dir of REQUIRED_DIRECTORIES) {
+                    if (dir !== '') {
+                        const dirPath = path.join(expandedBaseDir, dir);
+                        if (existsSync(dirPath)) {
+                            await fs.chmod(dirPath, 0o755);
+                        }
+                    }
+                }
+                // Set permissions on all installed files
+                for (const file of installed) {
+                    const filePath = path.join(expandedBaseDir, file);
+                    if (existsSync(filePath)) {
+                        await fs.chmod(filePath, 0o644);
+                    }
+                }
+            }
+            catch (error) {
+                // Non-critical error, don't fail the installation
+                if (options?.verbose) {
+                    console.log('Could not set permissions:', error);
+                }
+            }
+        }
+        return {
+            success: errors.length === 0,
+            installed,
+            skipped,
+            errors,
+            baseDir: expandedBaseDir,
+        };
+    }
+    /**
+     * Uninstall prompt files
+     * @param baseDir - Base directory for prompts
+     * @param options - Uninstallation options
+     * @returns Uninstallation result with removed files
+     */
+    async uninstall(baseDir, options) {
+        const removed = [];
+        const errors = [];
+        // Validate inputs
+        let expandedBaseDir = baseDir;
+        if (!expandedBaseDir) {
+            expandedBaseDir = this.expandPath(DEFAULT_BASE_DIR);
+        }
+        // If base directory doesn't exist, return success with empty arrays
+        if (!existsSync(expandedBaseDir)) {
+            return {
+                success: true,
+                removed: [],
+                errors: [],
+            };
+        }
+        // Build removal list
+        const toRemove = [];
+        if (options?.removeUserFiles) {
+            // Remove all files
+            try {
+                await this.collectAllFiles(expandedBaseDir, expandedBaseDir, toRemove);
+            }
+            catch (error) {
+                errors.push(`Failed to list files: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        else {
+            // Remove only default files (core.md and files in standard directories)
+            const defaultPaths = [
+                'core.md',
+                'env/development.md',
+                'env/dev.md',
+                'tools/git.md',
+                'providers/openai.md',
+            ];
+            for (const filePath of defaultPaths) {
+                const fullPath = path.join(expandedBaseDir, filePath);
+                if (existsSync(fullPath)) {
+                    toRemove.push(filePath);
+                }
+            }
+        }
+        // Remove files
+        for (const file of toRemove) {
+            const fullPath = path.join(expandedBaseDir, file);
+            if (options?.dryRun) {
+                console.log('Would remove:', fullPath);
+                removed.push(file);
+            }
+            else {
+                try {
+                    await fs.unlink(fullPath);
+                    removed.push(file);
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    if (errorMsg.includes('EBUSY')) {
+                        errors.push(`File in use: ${file}. Close any programs using this file and try again.`);
+                    }
+                    else if (errorMsg.includes('EACCES') ||
+                        errorMsg.includes('Permission denied')) {
+                        errors.push(`Permission denied: ${file}`);
+                    }
+                    else if (!errorMsg.includes('ENOENT')) {
+                        // Ignore "file not found" errors
+                        errors.push(`Failed to remove ${file}: ${errorMsg}`);
+                    }
+                }
+            }
+        }
+        // Remove empty directories (in reverse order to remove children first)
+        if (!options?.dryRun) {
+            const dirsToCheck = [...REQUIRED_DIRECTORIES].reverse();
+            for (const dir of dirsToCheck) {
+                const fullPath = dir === '' ? expandedBaseDir : path.join(expandedBaseDir, dir);
+                try {
+                    const contents = await fs.readdir(fullPath);
+                    if (contents.length === 0) {
+                        await fs.rmdir(fullPath);
+                        removed.push(dir === '' ? 'base directory' : dir);
+                    }
+                }
+                catch {
+                    // Ignore errors when removing directories
+                }
+            }
+        }
+        return {
+            success: errors.length === 0,
+            removed,
+            errors,
+        };
+    }
+    /**
+     * Helper method to recursively collect all files in a directory
+     */
+    async collectAllFiles(baseDir, currentDir, files) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            const relativePath = path.relative(baseDir, fullPath);
+            if (entry.isDirectory()) {
+                await this.collectAllFiles(baseDir, fullPath, files);
+            }
+            else if (entry.isFile()) {
+                files.push(relativePath);
+            }
+        }
+    }
+    /**
+     * Validate prompt installation
+     * @param baseDir - Base directory to validate
+     * @returns Validation result with issues found
+     */
+    async validate(baseDir) {
+        // Setup validation
+        let expandedBaseDir = baseDir;
+        if (!expandedBaseDir) {
+            expandedBaseDir = this.expandPath(DEFAULT_BASE_DIR);
+        }
+        let isValid = true;
+        const errors = [];
+        const warnings = [];
+        const missing = [];
+        // Check base directory
+        if (!existsSync(expandedBaseDir)) {
+            errors.push('Base directory does not exist');
+            isValid = false;
+            return {
+                isValid,
+                errors,
+                warnings,
+                missing,
+                baseDir: expandedBaseDir,
+            };
+        }
+        // Check directory structure
+        for (const dir of REQUIRED_DIRECTORIES) {
+            if (dir === '')
+                continue; // Skip base directory itself
+            const fullPath = path.join(expandedBaseDir, dir);
+            if (!existsSync(fullPath)) {
+                missing.push(dir);
+                warnings.push(`Missing directory: ${dir}`);
+            }
+        }
+        // Check required files
+        const corePath = path.join(expandedBaseDir, 'core.md');
+        if (!existsSync(corePath)) {
+            missing.push('core.md');
+            errors.push('Missing required core.md');
+            isValid = false;
+        }
+        // Check permissions
+        try {
+            // Check read permission
+            await fs.access(expandedBaseDir, fs.constants.R_OK);
+        }
+        catch {
+            errors.push('Cannot read from directory');
+            isValid = false;
+        }
+        try {
+            // Check write permission
+            await fs.access(expandedBaseDir, fs.constants.W_OK);
+        }
+        catch {
+            warnings.push('Cannot write to directory');
+        }
+        // Check file integrity
+        if (existsSync(corePath)) {
+            try {
+                const stats = await fs.stat(corePath);
+                if (stats.size === 0) {
+                    warnings.push('Empty file: core.md');
+                }
+                // Check if file is readable
+                try {
+                    await fs.access(corePath, fs.constants.R_OK);
+                }
+                catch {
+                    errors.push('Cannot read: core.md');
+                }
+            }
+            catch (error) {
+                errors.push(`Error checking core.md: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // Check other default files if they exist
+        const defaultFiles = [
+            'env/development.md',
+            'tools/git.md',
+            'providers/openai.md',
+        ];
+        for (const file of defaultFiles) {
+            const filePath = path.join(expandedBaseDir, file);
+            if (existsSync(filePath)) {
+                try {
+                    const stats = await fs.stat(filePath);
+                    if (stats.size === 0) {
+                        warnings.push(`Empty file: ${file}`);
+                    }
+                    // Check if file is readable
+                    try {
+                        await fs.access(filePath, fs.constants.R_OK);
+                    }
+                    catch {
+                        errors.push(`Cannot read: ${file}`);
+                    }
+                }
+                catch {
+                    // Ignore errors for optional files
+                }
+            }
+        }
+        return {
+            isValid,
+            errors,
+            warnings,
+            missing,
+            baseDir: expandedBaseDir,
+        };
+    }
+    /**
+     * Repair prompt installation
+     * @param baseDir - Base directory to repair
+     * @param defaults - Map of default files to restore
+     * @param options - Repair options
+     * @returns Repair result with fixed issues
+     */
+    async repair(baseDir, defaults, options) {
+        // Run validation first
+        const validation = await this.validate(baseDir);
+        const expandedBaseDir = validation.baseDir;
+        const repaired = [];
+        const errors = [];
+        // Create base directory if it doesn't exist
+        if (!existsSync(expandedBaseDir)) {
+            try {
+                await fs.mkdir(expandedBaseDir, { recursive: true, mode: 0o755 });
+                repaired.push('base directory');
+                if (options?.verbose) {
+                    console.log('Created base directory:', expandedBaseDir);
+                }
+            }
+            catch (error) {
+                errors.push(`Failed to create base directory: ${error instanceof Error ? error.message : String(error)}`);
+                return {
+                    success: false,
+                    repaired,
+                    errors,
+                    stillInvalid: validation.errors,
+                };
+            }
+        }
+        // Fix missing directories
+        for (const missingItem of validation.missing) {
+            // Check if it's a directory (from REQUIRED_DIRECTORIES)
+            if (REQUIRED_DIRECTORIES.includes(missingItem)) {
+                const dirPath = path.join(expandedBaseDir, missingItem);
+                try {
+                    await fs.mkdir(dirPath, { recursive: true, mode: 0o755 });
+                    repaired.push(missingItem);
+                    if (options?.verbose) {
+                        console.log('Created directory:', dirPath);
+                    }
+                }
+                catch (error) {
+                    errors.push(`Failed to create directory ${missingItem}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+        // Fix missing default files
+        for (const missingItem of validation.missing) {
+            // Check if it's a file (has content in defaults)
+            if (defaults[missingItem]) {
+                const filePath = path.join(expandedBaseDir, missingItem);
+                const fileDir = path.dirname(filePath);
+                // Ensure parent directory exists
+                try {
+                    await fs.mkdir(fileDir, { recursive: true, mode: 0o755 });
+                }
+                catch (error) {
+                    errors.push(`Failed to create directory for ${missingItem}: ${error instanceof Error ? error.message : String(error)}`);
+                    continue;
+                }
+                // Write the file
+                const tempPath = `${filePath}.tmp.${Date.now()}`;
+                try {
+                    await fs.writeFile(tempPath, defaults[missingItem], { mode: 0o644 });
+                    await fs.rename(tempPath, filePath);
+                    repaired.push(missingItem);
+                    if (options?.verbose) {
+                        console.log('Restored file:', filePath);
+                    }
+                }
+                catch (error) {
+                    errors.push(`Failed to restore ${missingItem}: ${error instanceof Error ? error.message : String(error)}`);
+                    try {
+                        await fs.unlink(tempPath);
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                }
+            }
+        }
+        // Always fix permissions (even if validation passed)
+        let permissionsFixed = false;
+        try {
+            // Fix directory permissions
+            await fs.chmod(expandedBaseDir, 0o755);
+            // Fix all file and directory permissions recursively
+            await this.fixFilePermissions(expandedBaseDir);
+            permissionsFixed = true;
+            if (options?.verbose) {
+                console.log('Fixed file permissions');
+            }
+        }
+        catch (error) {
+            errors.push(`Failed to fix permissions: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // If we started with a valid installation, don't report permissions as repaired
+        // Only report actual repairs that fixed validation issues
+        if (!validation.isValid && permissionsFixed && errors.length === 0) {
+            repaired.push('file permissions');
+        }
+        // Run validation again
+        const finalValidation = await this.validate(baseDir);
+        return {
+            success: finalValidation.isValid && errors.length === 0,
+            repaired,
+            errors,
+            stillInvalid: finalValidation.errors,
+        };
+    }
+    /**
+     * Create backup of current prompts
+     * @param baseDir - Base directory to backup
+     * @param backupPath - Where to save backup
+     * @returns Backup result with location and stats
+     */
+    async backup(baseDir, backupPath) {
+        // Validate inputs
+        let expandedBaseDir = baseDir;
+        if (!expandedBaseDir) {
+            expandedBaseDir = this.expandPath(DEFAULT_BASE_DIR);
+        }
+        if (!existsSync(expandedBaseDir)) {
+            return {
+                success: false,
+                error: 'Nothing to backup',
+            };
+        }
+        if (!backupPath || backupPath.trim() === '') {
+            return {
+                success: false,
+                error: 'Invalid backup path',
+            };
+        }
+        // Create backup
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        const timestamp = `${year}${month}${day}_${hours}${minutes}${seconds}`;
+        const backupDir = path.join(backupPath, `prompt-backup-${timestamp}`);
+        try {
+            // Create backup directory
+            await fs.mkdir(backupDir, { recursive: true });
+            // Copy files
+            let fileCount = 0;
+            let totalSize = 0;
+            await this.copyDirectory(expandedBaseDir, backupDir, async (filePath) => {
+                fileCount++;
+                const stats = await fs.stat(filePath);
+                totalSize += stats.size;
+            });
+            // Create manifest
+            const manifest = {
+                backupDate: new Date().toISOString(),
+                sourcePath: expandedBaseDir,
+                fileCount,
+                totalSize,
+            };
+            await fs.writeFile(path.join(backupDir, 'backup-manifest.json'), JSON.stringify(manifest, null, 2));
+            // Verify backup
+            const verifyCount = await this.countFiles(backupDir);
+            if (verifyCount !== fileCount + 1) {
+                // +1 for manifest
+                console.warn(`Backup verification warning: expected ${fileCount + 1} files, found ${verifyCount}`);
+            }
+            return {
+                success: true,
+                backupPath: backupDir,
+                fileCount,
+                totalSize,
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            // Clean up partial backup on error
+            try {
+                await fs.rm(backupDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            if (errorMsg.includes('ENOSPC')) {
+                return {
+                    success: false,
+                    error: 'Insufficient space: Not enough disk space for backup. Try a different location.',
+                };
+            }
+            else if (errorMsg.includes('EACCES') ||
+                errorMsg.includes('Permission denied')) {
+                return {
+                    success: false,
+                    error: `Permission denied: Cannot write to backup location. Try a different location or check permissions.`,
+                };
+            }
+            return {
+                success: false,
+                error: `Backup failed: ${errorMsg}`,
+            };
+        }
+    }
+    /**
+     * Helper method to copy a directory recursively
+     */
+    async copyDirectory(source, dest, onFile) {
+        await fs.mkdir(dest, { recursive: true });
+        const entries = await fs.readdir(source, { withFileTypes: true });
+        for (const entry of entries) {
+            const sourcePath = path.join(source, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                await this.copyDirectory(sourcePath, destPath, onFile);
+            }
+            else if (entry.isFile()) {
+                await fs.copyFile(sourcePath, destPath);
+                await fs.chmod(destPath, 0o644);
+                if (onFile) {
+                    await onFile(sourcePath);
+                }
+            }
+        }
+    }
+    /**
+     * Helper method to count files in a directory
+     */
+    async countFiles(dir) {
+        let count = 0;
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                count += await this.countFiles(path.join(dir, entry.name));
+            }
+            else if (entry.isFile()) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Helper method to fix file permissions recursively
+     */
+    async fixFilePermissions(dir) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                try {
+                    if (entry.isDirectory()) {
+                        await fs.chmod(fullPath, 0o755);
+                        await this.fixFilePermissions(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        await fs.chmod(fullPath, 0o644);
+                    }
+                }
+                catch {
+                    // Silently continue with other files - some filesystems don't support chmod
+                }
+            }
+        }
+        catch {
+            // Silently continue - permissions might not be changeable in some environments
+        }
+    }
+    /**
+     * Expand path with home directory and environment variables
+     * @param path - Path to expand
+     * @returns Expanded absolute path
+     */
+    expandPath(inputPath) {
+        // Handle null or empty input
+        if (!inputPath) {
+            return '';
+        }
+        let expandedPath = inputPath;
+        // Expand home directory
+        if (expandedPath.startsWith('~')) {
+            const homeDir = os.homedir();
+            expandedPath = expandedPath.replace(/^~/, homeDir);
+        }
+        // Expand environment variables with curly braces ${VAR}
+        expandedPath = expandedPath.replace(/\$\{([^}]+)\}/g, (match, varName) => process.env[varName] || match);
+        // Expand environment variables without curly braces $VAR
+        expandedPath = expandedPath.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (match, varName) => process.env[varName] || match);
+        // Resolve to absolute path
+        if (!path.isAbsolute(expandedPath)) {
+            expandedPath = path.resolve(expandedPath);
+        }
+        // Normalize path (remove redundant separators, resolve . and ..)
+        return path.normalize(expandedPath);
+    }
+}
+//# sourceMappingURL=prompt-installer.js.map