package-installer-cli 1.2.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f432378951e281eb37210295d7894abbf072093bd9a2e6099f1d3219ad45eb0
-  data.tar.gz: 0e9edf8310281ce583765615d8d41f1897b7e0fab8e6cc3dbbfa405d39a63cc9
+  metadata.gz: e6be7c9e887c130bca12178ca5b9c3814be6d872a43bd2f6889b0bc2b74611c3
+  data.tar.gz: 6c470b578f019a6753dd8a0a15050a2321f68d44ec18e4d911c9ec3648f177f1
 SHA512:
-  metadata.gz: b0490199b16d2f27b1513fc9360895c02cb9a1a2fc58a4cddc5611c20afa21c8ef6e609d99b4dc7271a19de0ea21c1275127839d4b56b26b91e0554cff66c296
-  data.tar.gz: 6e7cec10cae328695c8fb9328797f5efc46ced7e04b0bb99dffe40ccbb887bc9ee495277b2ac49e5196e88f98e6a71a2cec823ad4ec692ee78424ce5cc3b5d53
+  metadata.gz: 3b56770128ea4abf8e2e67a5a9e45fcb460993e89477bf3c919c257436471be2a2df6dac5bc61cd89abfb77ca749af3cbe1adbd79d9d0a38d5cf0d17c11f004a
+  data.tar.gz: b05634c35e45ada304be549c392ea71dba86a44bafef8d1c6c5c3e3b71a4964138473f1a1517e3f9ec6c8f4cc45c19c5293422183462334d1c6971c62667c12a

data/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to the Package Installer CLI Ruby gem will be documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.1.0] - 2025-09-23
+## [1.3.0] - 2025-09-23
 
 ### Updated
 - Version bump to 1.1.0

data/dist/commands/add.js

@@ -4,10 +4,12 @@ import gradient from 'gradient-string';
 import boxen from 'boxen';
 import path from 'path';
 import fs from 'fs-extra';
-import { addFeature, detectProjectStack, SUPPORTED_FEATURES } from '../utils/featureInstaller.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+import { addFeature, detectProjectStack, SUPPORTED_FEATURES, ensureFeaturesLoaded } from '../utils/featureInstaller.js';
 import { historyManager } from '../utils/historyManager.js';
-import { getCachedProject, cacheProjectData } from '../utils/cacheManager.js';
+import { cacheProjectData } from '../utils/cacheManager.js';
 import { getFeaturesJsonPath, getFeaturesPath } from '../utils/pathResolver.js';
+import { displayCommandBanner } from '../utils/banner.js';
 /**
  * Helper function to capitalize strings
  */
@@ -15,52 +17,95 @@ function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
 }
 /**
- * Get features.json configuration
+ * Get features.json configuration with new jsonPath structure
  */
-function getFeaturesConfig() {
+// Cache for features config to avoid repeated file reads
+let featuresConfigCache = null;
+async function getFeaturesConfig() {
+    // Return cached config if available
+    if (featuresConfigCache) {
+        return featuresConfigCache;
+    }
     try {
         // Use the centralized path resolver
         const featuresPath = getFeaturesJsonPath();
         if (fs.existsSync(featuresPath)) {
-            return JSON.parse(fs.readFileSync(featuresPath, 'utf-8'));
+            const baseConfig = JSON.parse(fs.readFileSync(featuresPath, 'utf-8'));
+            const processedConfig = {};
+            // Process each feature to load individual JSON files
+            for (const [featureName, config] of Object.entries(baseConfig.features || baseConfig)) {
+                const featureConfig = config;
+                if (featureConfig.jsonPath) {
+                    try {
+                        // Load the individual feature JSON file
+                        const individualFeaturePath = path.resolve(path.dirname(featuresPath), featureConfig.jsonPath);
+                        if (fs.existsSync(individualFeaturePath)) {
+                            const individualFeatureData = JSON.parse(fs.readFileSync(individualFeaturePath, 'utf-8'));
+                            // Merge the base config with the individual feature data
+                            processedConfig[featureName] = {
+                                ...featureConfig,
+                                files: individualFeatureData.files || individualFeatureData,
+                                ...individualFeatureData
+                            };
+                        }
+                        else {
+                            // Silently skip missing files to avoid console spam
+                            processedConfig[featureName] = featureConfig;
+                        }
+                    }
+                    catch (error) {
+                        // Silently handle errors to avoid console spam
+                        processedConfig[featureName] = featureConfig;
+                    }
+                }
+                else {
+                    // Legacy format
+                    processedConfig[featureName] = featureConfig;
+                }
+            }
+            // Cache the processed config
+            featuresConfigCache = { features: processedConfig };
+            return featuresConfigCache;
         }
-        console.warn(chalk.yellow(`⚠️  features.json not found at: ${featuresPath}`));
-        return { features: {} };
+        // Return empty config without warning to avoid console spam
+        featuresConfigCache = { features: {} };
+        return featuresConfigCache;
     }
     catch (error) {
-        console.warn(chalk.yellow('⚠️  Error reading features.json, using fallback'));
+        // Return fallback config without warning
         return { features: {} };
     }
 }
 /**
  * Get available feature categories
  */
-function getAvailableFeatures() {
-    const config = getFeaturesConfig();
-    return Object.keys(config);
+export async function getAvailableFeatures() {
+    const config = await getFeaturesConfig();
+    return Object.keys(config.features || {});
 }
 /**
  * Get sub-features for a category
  */
-function getSubFeatures(category) {
-    const config = getFeaturesConfig();
-    const categoryConfig = config[category];
+async function getSubFeatures(category) {
+    const config = await getFeaturesConfig();
+    const categoryConfig = config.features?.[category];
     if (!categoryConfig || typeof categoryConfig !== 'object') {
         return [];
     }
-    return Object.keys(categoryConfig);
+    return Object.keys(categoryConfig.files || {});
 }
 /**
  * List available features from features.json with descriptions
  */
-function listAvailableFeatures() {
-    const featuresConfig = getFeaturesConfig();
+async function listAvailableFeatures() {
+    await ensureFeaturesLoaded();
+    const featuresConfig = await getFeaturesConfig();
     if (!featuresConfig.features || Object.keys(featuresConfig.features).length === 0) {
         console.log(chalk.yellow('⚠️  No features found in configuration'));
         return;
     }
     const featuresData = Object.entries(featuresConfig.features).map(([key, config]) => {
-        const providers = Object.keys(config).filter(k => k !== 'description' && k !== 'supportedFrameworks');
+        const providers = config.files ? Object.keys(config.files) : [];
         const description = config.description || 'No description available';
         const frameworks = config.supportedFrameworks ? config.supportedFrameworks.join(', ') : 'All frameworks';
         return {
@@ -234,61 +279,60 @@ function showEnhancedSetupInstructions(feature, provider) {
 /**
  * Show help for add command
  */
-export function showAddHelp() {
-    const piGradient = gradient(['#00c6ff', '#0072ff']);
-    const featuresConfig = getFeaturesConfig();
+export async function showAddHelp() {
+    await ensureFeaturesLoaded();
+    const featuresConfig = await getFeaturesConfig();
     const availableFeatures = Object.keys(featuresConfig.features || {});
-    console.log('\n' + boxen(piGradient.multiline([
-        '📦 Package Installer CLI - Add Features',
-        '',
-        'USAGE:',
-        '  pi add                         # Interactive feature selection',
-        '  pi add <feature>               # Add feature with provider selection',
-        '  pi add <feature> <provider>    # Add specific feature provider',
-        '  pi add --list                  # List all available features',
-        '  pi add --help                  # Show this help message',
-        '',
-        'EXAMPLES:',
-        '  pi add                         # Show all features in dropdown',
-        '  pi add auth                    # Show auth providers dropdown',
-        '  pi add auth clerk              # Add Clerk authentication',
-        '  pi add aws                     # Show AWS services dropdown',
-        '  pi add aws ec2                 # Add AWS EC2 integration',
-        '  pi add ai openai               # Add OpenAI integration',
-        '  pi add database postgres       # Add PostgreSQL integration',
-        '  pi add payment stripe          # Add Stripe payment integration',
-        '',
-        'OPTIONS:',
-        '  -l, --list                     List all available features',
-        '  -v, --verbose                  Show detailed output',
-        '  -h, --help                     Show this help message',
-        '',
-        `AVAILABLE FEATURES (${availableFeatures.length}):`,
-        availableFeatures.length > 0
-            ? availableFeatures.map(feature => `  • ${feature}`).join('\n')
-            : '  No features configured',
-        '',
-        'SUPPORTED FRAMEWORKS:',
-        '  • Next.js                      App Router & Pages Router',
-        '  • React                        Create React App & Vite',
-        '  • Express.js                   Node.js backend framework',
-        '  • NestJS                       TypeScript backend framework',
-        '  • Vue.js                       Vue 3 with Composition API',
-        '  • Angular                      Angular 15+',
-        '  • Remix                        Full-stack React framework',
-        '  • And more coming soon...',
-        '',
-        'NOTES:',
-        '  • Features are automatically configured for your framework',
-        '  • Environment variables are added to .env files',
-        '  • TypeScript and JavaScript are both supported',
-        '  • Use "pi add --list" to see detailed feature information'
-    ].join('\n')), {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'blue'
-    }));
+    const helpConfig = {
+        commandName: 'Add',
+        emoji: '➕',
+        description: 'Add new features to your project with automatic framework integration.\nSupports authentication, databases, AI, payments, AWS services, and more.',
+        usage: [
+            'add [options]',
+            'add <feature> [provider] [options]'
+        ],
+        options: [
+            { flag: '-l, --list', description: 'List all available features' },
+            { flag: '-v, --verbose', description: 'Show detailed output' }
+        ],
+        examples: [
+            { command: 'add', description: 'Interactive feature selection' },
+            { command: 'add auth', description: 'Show auth providers dropdown' },
+            { command: 'add auth clerk', description: 'Add Clerk authentication' },
+            { command: 'add aws ec2', description: 'Add AWS EC2 integration' },
+            { command: 'add ai openai', description: 'Add OpenAI integration' },
+            { command: 'add database postgres', description: 'Add PostgreSQL integration' },
+            { command: 'add payment stripe', description: 'Add Stripe payment integration' },
+            { command: 'add --list', description: 'List all available features' }
+        ],
+        additionalSections: [
+            {
+                title: `Available Features (${availableFeatures.length})`,
+                items: availableFeatures.length > 0
+                    ? availableFeatures
+                    : ['No features configured']
+            },
+            {
+                title: 'Supported Frameworks',
+                items: [
+                    'Next.js - App Router & Pages Router',
+                    'React - Create React App & Vite',
+                    'Express.js - Node.js backend framework',
+                    'NestJS - TypeScript backend framework',
+                    'Vue.js - Vue 3 with Composition API',
+                    'Angular - Angular 15+',
+                    'Remix - Full-stack React framework'
+                ]
+            }
+        ],
+        tips: [
+            'Features are automatically configured for your framework',
+            'Environment variables are added to .env files',
+            'TypeScript and JavaScript are both supported',
+            'Use "pi add --list" to see detailed feature information'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Main add command handler with enhanced syntax support
@@ -301,21 +345,19 @@ export function showAddHelp() {
  */
 export async function addCommand(feature, provider, options = {}) {
     try {
-        // Handle help flag
-        if (options.help || feature === '--help' || feature === '-h') {
-            showAddHelp();
-            return;
-        }
+        // Ensure features are loaded first
+        await ensureFeaturesLoaded();
         // Handle list flag
         if (options.list || feature === '--list' || feature === '-l') {
-            listAvailableFeatures();
+            await listAvailableFeatures();
             return;
         }
+        // Display command banner
+        displayCommandBanner('Add', 'Add new features to your project with integrated templates and configurations');
         // Initialize history manager
         await historyManager.init();
         // Show disclaimer
         showFeatureDisclaimer();
-        console.log(chalk.hex('#9c88ff')('\n🔮 Adding features to your project...'));
         // Use provided project path or current directory
         const projectPath = options.projectPath || process.cwd();
         let projectInfo;
@@ -330,7 +372,8 @@ export async function addCommand(feature, provider, options = {}) {
         }
         else {
             // Standalone add command - detect framework from project files
-            projectInfo = await getCachedProject(projectPath);
+            // Get cached project info or detect it (simplified)
+            projectInfo = null; // Simplified - always detect fresh
             if (!projectInfo) {
                 console.log(chalk.yellow('🔍 Analyzing project structure...'));
                 projectInfo = await detectProjectStack(projectPath);
@@ -341,7 +384,7 @@ export async function addCommand(feature, provider, options = {}) {
                         const projectName = await fs.pathExists(packageJsonPath)
                             ? (await fs.readJson(packageJsonPath)).name || path.basename(projectPath)
                             : path.basename(projectPath);
-                        await cacheProjectData(projectPath, projectName, projectInfo.projectLanguage || 'unknown', projectInfo.framework, [], 0);
+                        await cacheProjectData(projectPath, projectName, projectInfo.projectLanguage || 'unknown');
                     }
                     catch (error) {
                         console.warn(chalk.yellow('⚠️  Could not cache project info'));
@@ -375,8 +418,8 @@ export async function addCommand(feature, provider, options = {}) {
             console.log(chalk.red('❌ Features configuration not found'));
             return;
         }
-        const featuresConfig = JSON.parse(await fs.readFile(featuresConfigPath, 'utf-8'));
-        const availableFeatures = Object.keys(featuresConfig.features);
+        const featuresConfig = await getFeaturesConfig();
+        const availableFeatures = Object.keys(featuresConfig.features || {});
         // Handle different command syntax cases
         if (!feature) {
             // Case 1: "pi add" - Show interactive dropdown for all features
@@ -511,7 +554,7 @@ export async function addCommand(feature, provider, options = {}) {
             return;
         }
         // Get available sub-features/providers
-        const subFeatures = getSubFeatures(selectedFeature);
+        const subFeatures = await getSubFeatures(selectedFeature);
         // If no provider specified and multiple providers available, show selection
         if (!selectedProvider && subFeatures.length > 1) {
             const providerChoices = subFeatures.map((subFeature) => {

data/dist/commands/analyze.js

@@ -7,46 +7,54 @@ import path from 'path';
 import os from 'os';
 import gradientString from 'gradient-string';
 import boxen from 'boxen';
-import { createBanner, displaySystemInfo, displaySuccessMessage } from '../utils/dashboard.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+import { displayCommandBanner } from '../utils/banner.js';
+import { displaySystemInfo, displaySuccessMessage } from '../utils/dashboard.js';
 import { HistoryManager } from '../utils/historyManager.js';
 /**
- * Display help for analyze command
+ * Display help for analyze command using standardized format
  */
 export function showAnalyzeHelp() {
-    console.clear();
-    const helpContent = boxen(gradientString(['#667eea', '#764ba2'])('📊 Package Installer CLI Analytics Help') + '\n\n' +
-        chalk.white('Display comprehensive CLI usage analytics and project dashboard') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white('  pi analyze [options]') + '\n' +
-        chalk.white('  pi stats [options]') + chalk.gray(' (alias)') + '\n\n' +
-        chalk.cyan('Description:') + '\n' +
-        chalk.white('  Interactive dashboard showing Package Installer CLI usage statistics,') + '\n' +
-        chalk.white('  project analytics, recent activities, and development environment info.') + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.white('  --export') + chalk.gray('      Export analytics data to JSON file') + '\n' +
-        chalk.white('  --reset') + chalk.gray('       Reset analytics history') + '\n' +
-        chalk.white('  --detailed') + chalk.gray('    Show detailed analytics breakdown') + '\n' +
-        chalk.white('  -h, --help') + chalk.gray('    Show this help message') + '\n\n' +
-        chalk.cyan('Features:') + '\n' +
-        chalk.green('  📈 Command Usage Stats') + chalk.gray('   Frequency and trends of CLI commands') + '\n' +
-        chalk.green('  🚀 Project Analytics') + chalk.gray('    Created projects and framework breakdown') + '\n' +
-        chalk.green('  📁 Recent Activity') + chalk.gray('      Last created/modified projects timeline') + '\n' +
-        chalk.green('  🎯 Feature Usage') + chalk.gray('      Most used features and integrations') + '\n' +
-        chalk.green('  ⚙️  Environment Info') + chalk.gray('     Development environment overview') + '\n' +
-        chalk.green('  📊 Performance') + chalk.gray('        CLI performance metrics and insights') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.white('  pi analyze') + chalk.gray('             Show complete analytics dashboard') + '\n' +
-        chalk.white('  pi analyze --detailed') + chalk.gray('   Show detailed breakdown with more metrics') + '\n' +
-        chalk.white('  pi analyze --export') + chalk.gray('    Export analytics data to JSON file') + '\n' +
-        chalk.white('  pi analyze --reset') + chalk.gray('     Clear all analytics history') + '\n\n' +
-        chalk.yellow('💡 Tip: Analytics data is collected from ~/.package-installer-cli/history.json'), {
-        padding: 1,
-        margin: { top: 1, bottom: 1, left: 2, right: 2 },
-        borderStyle: 'round',
-        borderColor: 'magenta',
-        backgroundColor: '#000000'
-    });
-    console.log(helpContent);
+    const helpConfig = {
+        commandName: 'Analyze',
+        emoji: '📊',
+        description: 'Display comprehensive CLI usage analytics and project dashboard.\nInteractive dashboard showing Package Installer CLI usage statistics, project analytics, recent activities, and development environment info.',
+        usage: [
+            'analyze [options]',
+            'stats [options]   # alias'
+        ],
+        options: [
+            { flag: '--export', description: 'Export analytics data to JSON file' },
+            { flag: '--reset', description: 'Reset analytics history' },
+            { flag: '--detailed', description: 'Show detailed analytics breakdown' }
+        ],
+        examples: [
+            { command: 'analyze', description: 'Show complete analytics dashboard' },
+            { command: 'analyze --detailed', description: 'Show detailed breakdown with more metrics' },
+            { command: 'analyze --export', description: 'Export analytics data to JSON file' },
+            { command: 'analyze --reset', description: 'Clear all analytics history' },
+            { command: 'stats', description: 'Use alias command' }
+        ],
+        additionalSections: [
+            {
+                title: 'Features',
+                items: [
+                    '📈 Command Usage Stats - Frequency and trends of CLI commands',
+                    '🚀 Project Analytics - Created projects and framework breakdown',
+                    '📁 Recent Activity - Last created/modified projects timeline',
+                    '🎯 Feature Usage - Most used features and integrations',
+                    '⚙️ Environment Info - Development environment overview',
+                    '📊 Performance - CLI performance metrics and insights'
+                ]
+            }
+        ],
+        tips: [
+            'Analytics data is collected from ~/.package-installer-cli/history.json',
+            'Use --export to backup your analytics data',
+            'Use --reset to start fresh analytics tracking'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Main analyze command function
@@ -57,7 +65,7 @@ export async function analyzeCommand(options = {}) {
         showAnalyzeHelp();
         return;
     }
-    createBanner('Package Installer CLI Analytics');
+    displayCommandBanner('Analytics', 'Comprehensive project analytics and usage insights');
     const historyManager = new HistoryManager();
     try {
         // Load analytics data from history.json

data/dist/commands/cache.js

@@ -7,11 +7,97 @@ import fs from 'fs-extra';
 import path from 'path';
 import os from 'os';
 import ora from 'ora';
+import { createStandardHelp } from '../utils/helpFormatter.js';
 import { getDirectorySize, getCacheStats, getCacheStatus } from '../utils/cacheManager.js';
+/**
+ * Display help for cache command
+ */
+export function showCacheHelp() {
+    const helpConfig = {
+        commandName: 'Cache',
+        emoji: '🗄️',
+        description: 'Manage CLI cache system for improved performance.\nAutomatically manages cached data for faster operations.',
+        usage: [
+            'cache [subcommand] [type]',
+            'cache [options]'
+        ],
+        options: [
+            { flag: '--stats', description: 'Show cache statistics' },
+            { flag: '--clear [type]', description: 'Clear cache (optional type)' },
+            { flag: '--info', description: 'Show cache information' },
+            { flag: '--optimize', description: 'Optimize cache' },
+            { flag: '--size', description: 'Show cache size only' }
+        ],
+        examples: [
+            { command: 'cache stats', description: 'Show cache statistics' },
+            { command: 'cache --stats', description: 'Show cache statistics (flag)' },
+            { command: 'cache clear', description: 'Clear all cache' },
+            { command: 'cache clear projects', description: 'Clear specific cache type' },
+            { command: 'cache info', description: 'Show cache information' },
+            { command: 'cache optimize', description: 'Optimize cache performance' },
+            { command: 'cache --size', description: 'Show cache size only' }
+        ],
+        additionalSections: [
+            {
+                title: 'Subcommands',
+                items: [
+                    'stats - Show cache statistics and usage info',
+                    'clear [type] - Clear cache (all or specific type)',
+                    'info - Show cache configuration and paths',
+                    'optimize - Optimize cache performance'
+                ]
+            },
+            {
+                title: 'Cache Types',
+                items: [
+                    'projects - Project metadata and analysis',
+                    'analysis - Analysis results and reports',
+                    'packages - Package version information',
+                    'templates - Template usage statistics',
+                    'system - System environment information',
+                    'all - Clear all cache types'
+                ]
+            }
+        ],
+        tips: [
+            'Cache improves CLI performance by storing frequently used data',
+            'Cache is automatically managed but you can manually optimize it',
+            'Use --size to check cache disk usage before clearing'
+        ]
+    };
+    createStandardHelp(helpConfig);
+}
 /**
  * Main cache command function
  */
-export async function cacheCommand(subcommand, type) {
+export async function cacheCommand(subcommand, type, options = {}) {
+    // Handle help flag
+    if (options.help || options['--help'] || options['-h'] || subcommand === '--help' || subcommand === '-h') {
+        showCacheHelp();
+        return;
+    }
+    // Handle option flags
+    if (options.stats || subcommand === 'stats') {
+        await cacheStatsCommand();
+        return;
+    }
+    if (options.clear !== undefined || subcommand === 'clear') {
+        const clearType = options.clear || type;
+        await cacheClearCommand(clearType);
+        return;
+    }
+    if (options.info || subcommand === 'info') {
+        await cacheInfoCommand();
+        return;
+    }
+    if (options.optimize || subcommand === 'optimize') {
+        await cacheOptimizeCommand();
+        return;
+    }
+    if (options.size) {
+        await cacheSizeCommand();
+        return;
+    }
     // Handle subcommands
     if (subcommand === 'stats') {
         await cacheStatsCommand();
@@ -27,26 +113,35 @@ export async function cacheCommand(subcommand, type) {
     }
     else {
         // Default cache command - show help and quick stats
+        console.clear();
         console.log(gradientString(['#00d2d3', '#0084ff'])('🗄️  Cache Manager\n'));
         console.log(chalk.cyan('Available commands:'));
-        console.log(chalk.gray('   pi cache stats     - Show cache statistics'));
-        console.log(chalk.gray('   pi cache clear     - Clear all cache'));
+        console.log(chalk.gray('   pi cache stats        - Show cache statistics'));
+        console.log(chalk.gray('   pi cache clear        - Clear all cache'));
         console.log(chalk.gray('   pi cache clear <type> - Clear specific cache type'));
-        console.log(chalk.gray('   pi cache info      - Show cache configuration'));
-        console.log(chalk.gray('   pi cache optimize  - Optimize cache performance'));
+        console.log(chalk.gray('   pi cache info         - Show cache configuration'));
+        console.log(chalk.gray('   pi cache optimize     - Optimize cache performance'));
+        console.log(chalk.gray('   pi cache --help       - Show detailed help'));
         console.log(chalk.cyan('\nCache types:'));
-        console.log(chalk.gray('   projects, templates, analysis, packages'));
+        console.log(chalk.gray('   projects, templates, analysis, packages, system, all'));
         // Show quick stats
         try {
             const stats = getCacheStats();
             console.log(chalk.cyan('\nQuick Stats:'));
             console.log(chalk.gray(`   Cached Projects: ${stats.projects?.length || 0}`));
             console.log(chalk.gray(`   Template Files: ${stats.templateFiles?.size || Object.keys(stats.templateFiles || {}).length || 0}`));
+            // Show cache size
+            const cacheDir = path.join(os.homedir(), '.pi-cache');
+            if (await fs.pathExists(cacheDir)) {
+                const size = await getDirectorySize(cacheDir);
+                console.log(chalk.gray(`   Cache Size: ${(size / 1024 / 1024).toFixed(2)} MB`));
+            }
         }
         catch (error) {
             console.log(chalk.yellow('\n⚠️  Cache not initialized yet'));
         }
         console.log(chalk.green('\n✅ Cache system ready'));
+        console.log(chalk.gray('💡 Use --help for detailed options'));
     }
 }
 /**
@@ -174,6 +269,46 @@ async function cacheInfoCommand() {
     console.log(chalk.gray('   • templateFiles - Cached template file contents'));
     console.log(chalk.gray('   • system       - System environment info'));
 }
+/**
+ * Cache size subcommand
+ */
+async function cacheSizeCommand() {
+    console.log(gradientString(['#00d2d3', '#0084ff'])('\n📊 Cache Size Information\n'));
+    const spinner = ora('Calculating cache size...').start();
+    try {
+        const cacheDir = path.join(os.homedir(), '.pi-cache');
+        if (!await fs.pathExists(cacheDir)) {
+            spinner.warn('Cache directory not found');
+            console.log(chalk.yellow('⚠️  Cache has not been initialized yet'));
+            return;
+        }
+        const totalSize = await getDirectorySize(cacheDir);
+        const cacheFile = path.join(cacheDir, 'cache.json');
+        spinner.succeed('Cache size calculated');
+        console.log(chalk.cyan('📁 Cache Size Breakdown:'));
+        console.log(chalk.gray(`   Total Cache Size: ${(totalSize / 1024 / 1024).toFixed(2)} MB`));
+        if (await fs.pathExists(cacheFile)) {
+            const cacheFileStats = await fs.stat(cacheFile);
+            console.log(chalk.gray(`   Cache Data File: ${(cacheFileStats.size / 1024).toFixed(2)} KB`));
+        }
+        // Show cache efficiency
+        if (totalSize > 50 * 1024 * 1024) { // 50MB
+            console.log(chalk.yellow('\n⚠️  Cache is quite large (>50MB)'));
+            console.log(chalk.gray('💡 Consider running "pi cache optimize" or "pi cache clear"'));
+        }
+        else if (totalSize > 10 * 1024 * 1024) { // 10MB
+            console.log(chalk.cyan('\n💡 Cache size is reasonable'));
+            console.log(chalk.gray('Consider optimizing if performance is slow'));
+        }
+        else {
+            console.log(chalk.green('\n✅ Cache size is optimal'));
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to calculate cache size');
+        console.error(chalk.red(`❌ Error: ${error.message}`));
+    }
+}
 /**
  * Cache optimize subcommand
  */