package-installer-cli 1.2.0 → 1.3.0

data/dist/commands/upgrade-cli.js

@@ -2,41 +2,49 @@
  * Upgrade CLI command - Updates Package Installer CLI to the latest version
  */
 import chalk from 'chalk';
-import gradient from 'gradient-string';
 import boxen from 'boxen';
 import ora from 'ora';
 import inquirer from 'inquirer';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import semver from 'semver';
+import { createStandardHelp } from '../utils/helpFormatter.js';
 const execAsync = promisify(exec);
 /**
  * Display help for upgrade-cli command
  */
 export function showUpgradeHelp() {
-    const piGradient = gradient(['#00c6ff', '#0072ff']);
-    const headerGradient = gradient(['#4facfe', '#00f2fe']);
-    console.log('\n' + boxen(headerGradient('🚀 Package Installer CLI - Upgrade Command Help') + '\n\n' +
-        chalk.white('Update Package Installer CLI to the latest version with intelligent upgrade management.') + '\n' +
-        chalk.white('Includes breaking change detection and version compatibility checks!') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('upgrade-cli')}`) + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.gray('  -h, --help    Display help for this command') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('upgrade-cli')}              # Smart upgrade with breaking change detection`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('upgrade-cli')} ${chalk.hex('#ff6b6b')('--help')}     # Show this help message`) + '\n\n' +
-        chalk.hex('#00d2d3')('💡 Enhanced Features:') + '\n' +
-        chalk.hex('#95afc0')('  • Semantic version analysis and breaking change detection') + '\n' +
-        chalk.hex('#95afc0')('  • Interactive confirmation for major version upgrades') + '\n' +
-        chalk.hex('#95afc0')('  • Automatic @latest tag installation for maximum compatibility') + '\n' +
-        chalk.hex('#95afc0')('  • Package size and release date information') + '\n' +
-        chalk.hex('#95afc0')('  • Comprehensive upgrade verification and rollback guidance'), {
-        padding: 1,
-        borderStyle: 'round',
-        borderColor: 'cyan',
-        backgroundColor: '#0a0a0a'
-    }));
+    const helpConfig = {
+        commandName: 'upgrade-cli',
+        emoji: '🚀',
+        description: 'Update Package Installer CLI to the latest version with intelligent upgrade management.\nIncludes breaking change detection and version compatibility checks!',
+        usage: ['pi upgrade-cli'],
+        options: [
+            { flag: '-h, --help', description: 'Display help for this command' }
+        ],
+        examples: [
+            { command: 'pi upgrade-cli', description: 'Smart upgrade with breaking change detection' },
+            { command: 'pi upgrade-cli --help', description: 'Show this help message' }
+        ],
+        additionalSections: [
+            {
+                title: '💡 Enhanced Features',
+                items: [
+                    '• Semantic version analysis and breaking change detection',
+                    '• Interactive confirmation for major version upgrades',
+                    '• Automatic @latest tag installation for maximum compatibility',
+                    '• Package size and release date information',
+                    '• Comprehensive upgrade verification and rollback guidance'
+                ]
+            }
+        ],
+        tips: [
+            'CLI will prompt for confirmation on major version upgrades',
+            'Breaking changes are automatically detected and explained',
+            'Use npm install -g package-installer-cli@<version> to rollback'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Get current CLI version

data/dist/index.js

@@ -14,7 +14,7 @@ import { addCommand, showAddHelp } from './commands/add.js';
 import { showUpgradeHelp, upgradeCliCommand } from './commands/upgrade-cli.js';
 import { updateCommand, showUpdateHelp } from './commands/update.js';
 import { analyzeCommand, showAnalyzeHelp } from './commands/analyze.js';
-import { deployCommand } from './commands/deploy.js';
+import { deployCommand, showDeployHelp } from './commands/deploy.js';
 import { cleanCommand, showCleanHelp } from './commands/clean.js';
 import { environmentCommand, showEnvironmentHelp } from './commands/env.js';
 import { doctorCommand, showDoctorHelp } from './commands/doctor.js';
@@ -93,12 +93,18 @@ program
     .command('check')
     .description(chalk.hex('#f39c12')('🔍 ') + chalk.hex('#ffa500')('Check package versions and get update suggestions'))
     .argument('[package-name]', chalk.hex('#95afc0')('Specific package to check (optional)'))
+    .option('-v, --verbose', 'Show detailed information for all packages')
+    .option('-h, --help', 'Display help for this command')
     .on('--help', () => {
     showCheckHelp();
 })
-    .action(async (packageName) => {
+    .action(async (packageName, options) => {
     try {
-        await checkCommand(packageName);
+        if (options.help) {
+            showCheckHelp();
+            return;
+        }
+        await checkCommand(packageName, options);
     }
     catch (error) {
         handleCommandError('check packages', error);
@@ -110,10 +116,21 @@ program
     .description(chalk.hex('#00d2d3')('📥 ') + chalk.hex('#00cec9')('Clone repositories from GitHub, GitLab, BitBucket & SourceHut'))
     .argument('[user/repo]', chalk.hex('#95afc0')('Repository in format "user/repo" or "provider:user/repo"'))
     .argument('[project-name]', chalk.hex('#95afc0')('Custom project name (defaults to repo name)'))
+    .option('-h, --help', 'Display help for this command')
+    .option('--offline', 'Use cached templates if available')
+    .option('--no-deps', 'Skip dependency installation')
+    .option('--no-git', 'Skip git initialization')
+    .option('--shallow', 'Create shallow clone (faster)')
+    .option('--branch <name>', 'Clone specific branch')
+    .option('--template', 'Treat as template repository')
     .on('--help', () => {
     showCloneHelp();
 })
-    .action(async (userRepo, projectName) => {
+    .action(async (userRepo, projectName, options) => {
+    if (options.help) {
+        showCloneHelp();
+        return;
+    }
     if (!userRepo) {
         console.log('\n' + chalk.hex('#ff4757')('❌ Error: Repository is required'));
         console.log(chalk.hex('#95afc0')('   Format: user/repo or provider:user/repo'));
@@ -124,7 +141,7 @@ program
         return;
     }
     try {
-        await cloneRepo(userRepo, projectName);
+        await cloneRepo(userRepo, projectName, options);
     }
     catch (error) {
         handleCommandError('clone repository', error);
@@ -167,13 +184,22 @@ program
 // ANALYZE COMMAND - Terminal dashboard with analytics
 program
     .command('analyze')
+    .alias('stats')
     .description(chalk.hex('#667eea')('📊 ') + chalk.hex('#4facfe')('Show CLI usage analytics and framework statistics'))
+    .option('--export', 'Export analytics data to JSON file')
+    .option('--reset', 'Reset analytics history')
+    .option('--detailed', 'Show detailed analytics breakdown')
+    .option('-h, --help', 'Show this help message')
     .on('--help', () => {
     showAnalyzeHelp();
 })
-    .action(async () => {
+    .action(async (options) => {
     try {
-        await analyzeCommand();
+        if (options.help) {
+            showAnalyzeHelp();
+            return;
+        }
+        await analyzeCommand(options);
     }
     catch (error) {
         handleCommandError('show analytics', error);
@@ -183,14 +209,16 @@ program
 program
     .command('update')
     .alias('u')
-    .description(chalk.hex('#ff6b6b')('🔄 ') + chalk.hex('#fd79a8')('Update CLI, dependencies, and cache'))
+    .description(chalk.hex('#ff6b6b')('🔄 ') + chalk.hex('#fd79a8')('Update project dependencies with breaking change detection'))
+    .argument('[packages]', chalk.hex('#95afc0')('Comma-separated list of packages to update (optional)'))
+    .option('--latest', 'Update to latest versions (may include breaking changes)')
     .option('-h, --help', 'Show help for update command')
     .on('--help', () => {
     showUpdateHelp();
 })
-    .action(async (options) => {
+    .action(async (packages, options) => {
     try {
-        await updateCommand(options);
+        await updateCommand(packages, options);
     }
     catch (error) {
         handleCommandError('update', error);
@@ -204,15 +232,20 @@ program
     .option('--node-modules', 'Clean node_modules directories')
     .option('--build', 'Clean build/dist directories')
     .option('--cache', 'Clean package manager caches')
-    .option('--logs', 'Clean log files')
-    .option('--all', 'Clean everything (safe)')
+    .option('--logs', 'Clean log files and debug outputs')
+    .option('--all', 'Clean everything (safe operation)')
     .option('--deep', 'Deep clean (includes lock files)')
     .option('--dry-run', 'Preview what would be cleaned')
+    .option('-h, --help', 'Show help for clean command')
     .on("--help", () => {
     showCleanHelp();
 })
     .action(async (options) => {
     try {
+        if (options.help) {
+            showCleanHelp();
+            return;
+        }
         displayCommandBanner('clean', 'Clean development artifacts and caches');
         await cleanCommand(options);
     }
@@ -270,10 +303,20 @@ program
     .description(chalk.hex('#00d2d3')('🗄️ ') + chalk.hex('#0084ff')('Manage CLI cache system'))
     .argument('[subcommand]', 'Cache subcommand (stats, clear, info, optimize)')
     .argument('[type]', 'Type for clear command (projects, analysis, packages, templates, system, all)')
-    .action(async (subcommand, type) => {
+    .option('--stats', 'Show cache statistics')
+    .option('--clear [type]', 'Clear cache (optionally specify type)')
+    .option('--info', 'Show cache configuration')
+    .option('--optimize', 'Optimize cache performance')
+    .option('--size', 'Show cache size information')
+    .option('-h, --help', 'Show help for cache command')
+    .on('--help', async () => {
+    const { showCacheHelp } = await import('./commands/cache.js');
+    showCacheHelp();
+})
+    .action(async (subcommand, type, options) => {
     try {
         const { cacheCommand } = await import('./commands/cache.js');
-        await cacheCommand(subcommand, type);
+        await cacheCommand(subcommand, type, options);
     }
     catch (error) {
         handleCommandError('cache', error);
@@ -284,7 +327,7 @@ program
     .command('deploy')
     .description(chalk.hex('#ff9a9e')('🚀 ') + chalk.hex('#fd79a8')('Deploy your project (Coming Soon)'))
     .on('--help', () => {
-    // Help is handled in the command file
+    showDeployHelp();
 })
     .action(async () => {
     try {

data/dist/utils/banner.js

@@ -66,7 +66,7 @@ export function displayCommandBanner(commandName, description) {
     const commandGradient = gradient(['#4facfe', '#00f2fe']);
     console.log('\n' + boxen(commandGradient(`🚀 ${commandName.toUpperCase()} COMMAND`) + '\n\n' +
         chalk.white(description) + '\n\n' +
-        chalk.hex('#00d2d3')('💡 Package Installer CLI v3.2.0') + ' • ' +
+        chalk.hex('#00d2d3')(`💡 Package Installer CLI v${getPackageVersion()}`) + ' • ' +
         chalk.hex('#95afc0')('Fast • Smart • Feature-Rich'), {
         padding: 1,
         borderStyle: 'round',

data/dist/utils/cacheManager.js

@@ -1,77 +1,50 @@
 /**
  * Cache Manager - Centralized caching operations for Package Installer CLI
+ * Simplified version focusing on essential caching functionality only
  */
 import { cacheManager as cacheManagerInstance } from './cacheUtils.js';
 import fs from 'fs-extra';
 import path from 'path';
-import chalk from 'chalk';
 // Export the cache manager instance
 export const cacheManager = cacheManagerInstance;
 /**
  * Initialize cache system on CLI startup
  */
 export async function initializeCache() {
-    await cacheManagerInstance.init();
-}
-/**
- * Get cached project
- */
-export async function getCachedProject(projectPath) {
     try {
-        const cache = cacheManagerInstance.getCache();
-        const cached = cache.projects.find((p) => p.path === projectPath);
-        return cached || null;
+        await cacheManagerInstance.init();
     }
     catch (error) {
-        return null;
+        // Silent fail - cache will work in memory mode
     }
 }
 /**
- * Cache project data (simplified)
+ * Get cached template files (simplified - returns null for now)
  */
-export async function cacheProjectData(projectPath, name, language, framework, dependencies, size) {
-    try {
-        // For now, just cache basic project info without complex dependencies
-        console.log(chalk.gray(`📊 Caching project data for ${name}`));
-    }
-    catch (error) {
-        console.warn('Failed to cache project data:', error);
-    }
+export async function getCachedTemplateFiles(templateName) {
+    // Simplified implementation - just return null for now
+    return null;
 }
 /**
- * Get cached template files (simplified)
+ * Cache template files (simplified - no-op for now)
  */
-export async function getCachedTemplateFiles(templateName) {
-    try {
-        const cache = cacheManagerInstance.getCache();
-        const template = cache.templateFiles.find((t) => t.templateName === templateName);
-        return template || null;
-    }
-    catch (error) {
-        return null;
-    }
+export async function cacheTemplateFiles(templateName, templatePath, files) {
+    // Simplified implementation - no-op for now
+    // This reduces complexity and memory usage
 }
 /**
- * Cache template files (simplified)
+ * Update template usage statistics (simplified - no-op for now)
  */
-export async function cacheTemplateFiles(templateName, templatePath, files, size) {
-    try {
-        console.log(chalk.gray(`📊 Caching template files for ${templateName}`));
-    }
-    catch (error) {
-        console.warn('Failed to cache template files:', error);
-    }
+export async function updateTemplateUsage(templateName, framework, language) {
+    // Simplified implementation - no-op for now
+    // This reduces complexity and memory usage
 }
 /**
- * Update template usage statistics (simplified)
+ * Cache project data (simplified - no-op for now)
  */
-export async function updateTemplateUsage(templateName, framework, language, features) {
-    try {
-        console.log(chalk.gray(`📊 Recording template usage: ${templateName}`));
-    }
-    catch (error) {
-        console.warn('Failed to update template usage:', error);
-    }
+export async function cacheProjectData(projectPath, name, type) {
+    // Simplified implementation - no-op for now
+    // This reduces complexity and memory usage
 }
 /**
  * Get directory size utility function
@@ -80,18 +53,24 @@ export async function getDirectorySize(dirPath) {
     try {
         let totalSize = 0;
         async function calculateSize(currentPath) {
-            const stats = await fs.stat(currentPath);
-            if (stats.isFile()) {
-                totalSize += stats.size;
-            }
-            else if (stats.isDirectory()) {
-                const items = await fs.readdir(currentPath);
-                for (const item of items) {
-                    if (!['node_modules', '.git', 'dist', 'build'].includes(item)) {
-                        await calculateSize(path.join(currentPath, item));
+            try {
+                const stats = await fs.stat(currentPath);
+                if (stats.isFile()) {
+                    totalSize += stats.size;
+                }
+                else if (stats.isDirectory()) {
+                    const items = await fs.readdir(currentPath);
+                    for (const item of items) {
+                        // Skip large directories to avoid performance issues
+                        if (!['node_modules', '.git', 'dist', 'build', 'target', '.cache'].includes(item)) {
+                            await calculateSize(path.join(currentPath, item));
+                        }
                     }
                 }
             }
+            catch (error) {
+                // Skip files/directories that can't be accessed
+            }
         }
         await calculateSize(dirPath);
         return totalSize;
@@ -101,98 +80,52 @@ export async function getDirectorySize(dirPath) {
     }
 }
 /**
- * Read template files for caching
- */
-export async function readTemplateFiles(templatePath) {
-    const files = {};
-    async function readFiles(currentPath, relativePath = '') {
-        try {
-            const items = await fs.readdir(currentPath, { withFileTypes: true });
-            for (const item of items) {
-                const fullPath = path.join(currentPath, item.name);
-                const relativeItemPath = path.join(relativePath, item.name);
-                if (item.isFile()) {
-                    // Skip binary files and large files
-                    const stats = await fs.stat(fullPath);
-                    if (stats.size < 1024 * 1024) { // Skip files larger than 1MB
-                        const content = await fs.readFile(fullPath, 'utf-8').catch(() => null);
-                        if (content !== null) {
-                            files[relativeItemPath] = content;
-                        }
-                    }
-                }
-                else if (item.isDirectory() && !['node_modules', '.git', 'dist', 'build'].includes(item.name)) {
-                    await readFiles(fullPath, relativeItemPath);
-                }
-            }
-        }
-        catch (error) {
-            // Skip directories that can't be read
-        }
-    }
-    await readFiles(templatePath);
-    return files;
-}
-/**
- * Create project from cached template
- */
-export async function createProjectFromCachedTemplate(projectName, cachedTemplate) {
-    const projectPath = path.resolve(process.cwd(), projectName);
-    // Create project directory
-    await fs.ensureDir(projectPath);
-    // Write cached files
-    if (cachedTemplate.files) {
-        for (const [filePath, content] of Object.entries(cachedTemplate.files)) {
-            const fullPath = path.join(projectPath, filePath);
-            await fs.ensureDir(path.dirname(fullPath));
-            await fs.writeFile(fullPath, content);
-        }
-    }
-    return projectPath;
-}
-/**
- * Get cache statistics
+ * Get cache statistics (simplified)
  */
 export function getCacheStats() {
     try {
-        return cacheManagerInstance.getAdvancedStats();
+        const cache = cacheManagerInstance.getCache();
+        return {
+            projects: cache.projects || [],
+            templates: cache.templates || [],
+            templateFiles: cache.templateFiles || [],
+            features: cache.features || [],
+            hits: 0,
+            misses: 0
+        };
     }
     catch (error) {
         return {
-            cache: { hitRate: '0%', size: 0 },
-            health: { status: 'Unknown' },
-            performance: {}
+            projects: [],
+            templates: [],
+            templateFiles: [],
+            features: [],
+            hits: 0,
+            misses: 0
         };
     }
 }
 /**
- * Get cache status
+ * Get cache status (simplified)
  */
 export function getCacheStatus() {
     try {
-        const stats = getCacheStats();
         const cache = cacheManagerInstance.getCache();
         return {
-            isHealthy: stats.health?.status === 'Healthy',
-            hitRate: 0,
+            initialized: true,
+            version: cache.version || '1.0.0',
             totalProjects: cache.projects?.length || 0,
             totalTemplates: cache.templates?.length || 0,
-            totalFeatures: cache.features?.length || 0,
-            recentProjects: [],
-            performance: stats.performance || {},
-            size: stats.cache?.size || 0
+            totalFeatures: cache.features?.length || 0
         };
     }
     catch (error) {
         return {
-            isHealthy: false,
-            hitRate: 0,
+            initialized: false,
+            version: '1.0.0',
             totalProjects: 0,
             totalTemplates: 0,
-            totalFeatures: 0,
-            recentProjects: [],
-            performance: {},
-            size: 0
+            totalFeatures: 0
         };
     }
 }

data/dist/utils/dependencyInstaller.js

@@ -292,7 +292,6 @@ function extractInstalledPackages(output, language) {
         switch (language) {
             case 'javascript':
             case 'typescript':
-            case 'nodejs':
                 // Parse npm/yarn/pnpm/bun output
                 const jsMatches = output.match(/(?:added|installed)\s+(.+?)(?:\s|$)/gi);
                 if (jsMatches) {
@@ -387,7 +386,6 @@ export async function installPackages(projectPath, language, packages, options =
     switch (language) {
         case 'javascript':
         case 'typescript':
-        case 'nodejs':
             const flags = [
                 isDev ? (packageManager.name === 'npm' ? '--save-dev' : packageManager.name === 'yarn' ? '--dev' : '--save-dev') : '',
                 exact ? '--save-exact' : '',