package-installer-cli 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de2baf8d0677e75c1471a523c2c8b581bde9c5187f0cecb4a5a4c79a6d03022a
-  data.tar.gz: c3e5ee669f095c1537ba2bf505367da009999c907b6814fb907e5b569eebcc2a
+  metadata.gz: e6be7c9e887c130bca12178ca5b9c3814be6d872a43bd2f6889b0bc2b74611c3
+  data.tar.gz: 6c470b578f019a6753dd8a0a15050a2321f68d44ec18e4d911c9ec3648f177f1
 SHA512:
-  metadata.gz: 3f593de7edcf4ec3b60397cf4de415d7e2703debb4a49c7f85d1911d2c2c64b9c644e637d259187dd965d43b23906985795cb5ed5fbc5eece7bf6af45b33c4fb
-  data.tar.gz: c9f3538f2430caa503d7bbe21f52bd2592b689e80c1f08763b4afd2268a1cffd9ba4d1bd4dcf6a855aebacc0b2f59a1ca750ec296ad96aa57344b6cfdf40e043
+  metadata.gz: 3b56770128ea4abf8e2e67a5a9e45fcb460993e89477bf3c919c257436471be2a2df6dac5bc61cd89abfb77ca749af3cbe1adbd79d9d0a38d5cf0d17c11f004a
+  data.tar.gz: b05634c35e45ada304be549c392ea71dba86a44bafef8d1c6c5c3e3b71a4964138473f1a1517e3f9ec6c8f4cc45c19c5293422183462334d1c6971c62667c12a

data/dist/commands/add.js

@@ -5,10 +5,11 @@ import boxen from 'boxen';
 import path from 'path';
 import fs from 'fs-extra';
 import { createStandardHelp } from '../utils/helpFormatter.js';
-import { addFeature, detectProjectStack, SUPPORTED_FEATURES } from '../utils/featureInstaller.js';
+import { addFeature, detectProjectStack, SUPPORTED_FEATURES, ensureFeaturesLoaded } from '../utils/featureInstaller.js';
 import { historyManager } from '../utils/historyManager.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
  */
@@ -18,7 +19,13 @@ function capitalize(str) {
 /**
  * Get features.json configuration with new jsonPath structure
  */
+// 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();
@@ -42,12 +49,12 @@ async function getFeaturesConfig() {
                             };
                         }
                         else {
-                            console.warn(chalk.yellow(`⚠️  Individual feature file not found: ${individualFeaturePath}`));
+                            // Silently skip missing files to avoid console spam
                             processedConfig[featureName] = featureConfig;
                         }
                     }
                     catch (error) {
-                        console.warn(chalk.yellow(`⚠️  Could not load individual feature file for ${featureName}`));
+                        // Silently handle errors to avoid console spam
                         processedConfig[featureName] = featureConfig;
                     }
                 }
@@ -56,13 +63,16 @@ async function getFeaturesConfig() {
                     processedConfig[featureName] = featureConfig;
                 }
             }
-            return { features: processedConfig };
+            // 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: {} };
     }
 }
@@ -88,6 +98,7 @@ async function getSubFeatures(category) {
  * List available features from features.json with descriptions
  */
 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'));
@@ -269,6 +280,7 @@ function showEnhancedSetupInstructions(feature, provider) {
  * Show help for add command
  */
 export async function showAddHelp() {
+    await ensureFeaturesLoaded();
     const featuresConfig = await getFeaturesConfig();
     const availableFeatures = Object.keys(featuresConfig.features || {});
     const helpConfig = {
@@ -281,8 +293,7 @@ export async function showAddHelp() {
         ],
         options: [
             { flag: '-l, --list', description: 'List all available features' },
-            { flag: '-v, --verbose', description: 'Show detailed output' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '-v, --verbose', description: 'Show detailed output' }
         ],
         examples: [
             { command: 'add', description: 'Interactive feature selection' },
@@ -334,21 +345,19 @@ export async function showAddHelp() {
  */
 export async function addCommand(feature, provider, options = {}) {
     try {
-        // Handle help flag
-        if (options.help || feature === '--help' || feature === '-h') {
-            await showAddHelp();
-            return;
-        }
+        // Ensure features are loaded first
+        await ensureFeaturesLoaded();
         // Handle list flag
         if (options.list || feature === '--list' || feature === '-l') {
             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;

data/dist/commands/analyze.js

@@ -8,7 +8,8 @@ import os from 'os';
 import gradientString from 'gradient-string';
 import boxen from 'boxen';
 import { createStandardHelp } from '../utils/helpFormatter.js';
-import { createBanner, displaySystemInfo, displaySuccessMessage } from '../utils/dashboard.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 using standardized format
@@ -25,8 +26,7 @@ export function showAnalyzeHelp() {
         options: [
             { flag: '--export', description: 'Export analytics data to JSON file' },
             { flag: '--reset', description: 'Reset analytics history' },
-            { flag: '--detailed', description: 'Show detailed analytics breakdown' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '--detailed', description: 'Show detailed analytics breakdown' }
         ],
         examples: [
             { command: 'analyze', description: 'Show complete analytics dashboard' },
@@ -65,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

@@ -26,8 +26,7 @@ export function showCacheHelp() {
             { 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' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '--size', description: 'Show cache size only' }
         ],
         examples: [
             { command: 'cache stats', description: 'Show cache statistics' },

data/dist/commands/check.js

@@ -8,6 +8,7 @@ import path from 'path';
 import semver from 'semver';
 import https from 'https';
 import { createStandardHelp } from '../utils/helpFormatter.js';
+import { displayCommandBanner } from '../utils/banner.js';
 import { getSupportedLanguages, getLanguageConfig } from '../utils/languageConfig.js';
 const execAsync = promisify(exec);
 // Generate PROJECT_TYPES from shared language configuration with enhanced registry support
@@ -380,7 +381,6 @@ export function showCheckHelp() {
             'check [options]'
         ],
         options: [
-            { flag: '-h, --help', description: 'Display help for this command' },
             { flag: '-v, --verbose', description: 'Show detailed information for all packages' }
         ],
         examples: [
@@ -427,6 +427,8 @@ export async function checkCommand(packageName, options) {
         packageName = undefined;
     }
     try {
+        // Display command banner
+        displayCommandBanner('Check', 'Check package versions and updates for your project dependencies');
         console.log('\n' + chalk.hex('#f39c12')('🔍 Starting package check...'));
         if (packageName && packageName !== '--verbose' && packageName !== '-v') {
             await checkSinglePackage(packageName, isVerbose);

data/dist/commands/clean.js

@@ -6,6 +6,7 @@ import ora from 'ora';
 import fs from 'fs-extra';
 import path from 'path';
 import { createStandardHelp } from '../utils/helpFormatter.js';
+import { displayCommandBanner } from '../utils/banner.js';
 /**
  * Display help for clean command
  */
@@ -25,8 +26,7 @@ export function showCleanHelp() {
             { flag: '--logs', description: 'Clean log files and debug outputs' },
             { flag: '--all', description: 'Clean everything (safe operation)' },
             { flag: '--deep', description: 'Deep clean (includes lock files)' },
-            { flag: '--dry-run', description: 'Preview what would be cleaned' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '--dry-run', description: 'Preview what would be cleaned' }
         ],
         examples: [
             { command: 'clean --build', description: 'Clean build directories only' },
@@ -65,7 +65,8 @@ export async function cleanCommand(options = {}) {
         showCleanHelp();
         return;
     }
-    console.clear();
+    // Display command banner
+    displayCommandBanner('Clean', 'Clean development artifacts, caches, and temporary files from your project');
     console.log(chalk.hex('#ffa502')('🧹 Project Cleaner\n'));
     const projectPath = process.cwd();
     const isDryRun = options['dryRun'] || options['dry-run'];

data/dist/commands/clone.js

@@ -16,7 +16,6 @@ export function showCloneHelp() {
             'clone [options]'
         ],
         options: [
-            { flag: '-h, --help', description: 'Display help for this command' },
             { flag: '--offline', description: 'Use cached templates if available' },
             { flag: '--no-deps', description: 'Skip dependency installation' },
             { flag: '--no-git', description: 'Skip git initialization' },

data/dist/commands/create.js

@@ -4,6 +4,7 @@
 import chalk from 'chalk';
 import path from 'path';
 import { createStandardHelp } from '../utils/helpFormatter.js';
+import { displayCommandBanner } from '../utils/banner.js';
 import { promptProjectName, promptFrameworkSelection, promptLanguageSelection, promptTemplateSelection, promptFrameworkOptions, promptTemplateConfirmation, promptFeatureSelection, hasFrameworkOptions, hasUIOptions, hasBundlerOptions, shouldShowTemplates } from '../utils/prompts.js';
 import { resolveTemplatePath, generateTemplateName, templateExists, getFrameworkConfig } from '../utils/templateResolver.js';
 import { createProjectFromTemplate, installDependenciesForCreate } from '../utils/templateCreator.js';
@@ -22,7 +23,6 @@ export function showCreateHelp() {
             'create [options]'
         ],
         options: [
-            { flag: '-h, --help', description: 'Display help for this command' },
             { flag: '--show-cache', description: 'Show cached preferences' },
             { flag: '--clear-cache', description: 'Clear cached preferences' }
         ],
@@ -79,6 +79,8 @@ export async function createProject(providedName, options) {
         return;
     }
     try {
+        // Display command banner
+        displayCommandBanner('Create', 'Create stunning web applications with integrated templates and features');
         console.log('\n' + chalk.hex('#10ac84')('🚀 Welcome to Package Installer CLI!'));
         console.log(chalk.hex('#95afc0')('Let\'s create something amazing together...'));
         // Step 1: Get project name (prompt if not provided)

data/dist/commands/deploy.js

@@ -14,9 +14,7 @@ export function showDeployHelp() {
         emoji: '🚀',
         description: 'Deploy your projects to various cloud platforms seamlessly.\nThis feature is currently under development!',
         usage: ['pi deploy'],
-        options: [
-            { flag: '-h, --help', description: 'Display help for this command' }
-        ],
+        options: [],
         examples: [
             { command: 'pi deploy', description: 'Deploy current project' },
             { command: 'pi deploy --help', description: 'Show this help message' }

data/dist/commands/doctor.js

@@ -192,8 +192,7 @@ export function showDoctorHelp() {
             { flag: '--node', description: 'Check Node.js and npm setup only' },
             { flag: '--deps', description: 'Check project dependencies only' },
             { flag: '--tools', description: 'Check development tools only' },
-            { flag: '--verbose', description: 'Show detailed diagnostic information' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '--verbose', description: 'Show detailed diagnostic information' }
         ],
         examples: [
             { command: 'pi doctor', description: 'Complete health check' },

data/dist/commands/env.js

@@ -106,7 +106,7 @@ function checkEnvironmentVariables() {
 async function generateEnvTemplate(projectPath) {
     try {
         const projectInfo = await detectProjectStack(projectPath);
-        const envPath = path.join(projectPath, '.env.example');
+        const envPath = path.join(projectPath, '.env');
         let envContent = `# Environment Configuration
 # Generated by Package Installer CLI
 
@@ -222,8 +222,7 @@ export function showEnvironmentHelp() {
             { flag: '--generate', description: 'Generate .env template for project' },
             { flag: '--validate', description: 'Validate existing .env file' },
             { flag: '--export', description: 'Export environment info to file' },
-            { flag: '--system', description: 'Show system information only' },
-            { flag: '-h, --help', description: 'Show this help message' }
+            { flag: '--system', description: 'Show system information only' }
         ],
         examples: [
             { command: 'env', description: 'Interactive environment analysis' },

data/dist/commands/update.js

@@ -731,7 +731,6 @@ export function showUpdateHelp() {
             'u [options]   # alias'
         ],
         options: [
-            { flag: '-h, --help', description: 'Show this help message' },
             { flag: '--latest', description: 'Update to latest versions (breaking changes possible)' }
         ],
         examples: [

data/dist/commands/upgrade-cli.js

@@ -19,9 +19,7 @@ export function showUpgradeHelp() {
         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' }
-        ],
+        options: [],
         examples: [
             { command: 'pi upgrade-cli', description: 'Smart upgrade with breaking change detection' },
             { command: 'pi upgrade-cli --help', description: 'Show this help message' }

data/dist/index.js

@@ -16,8 +16,10 @@ import { updateCommand, showUpdateHelp } from './commands/update.js';
 import { analyzeCommand, showAnalyzeHelp } from './commands/analyze.js';
 import { deployCommand, showDeployHelp } from './commands/deploy.js';
 import { cleanCommand, showCleanHelp } from './commands/clean.js';
+import { cacheCommand, showCacheHelp } from './commands/cache.js';
 import { environmentCommand, showEnvironmentHelp } from './commands/env.js';
 import { doctorCommand, showDoctorHelp } from './commands/doctor.js';
+// Import utilities
 import { initializeCache } from './utils/cacheManager.js';
 import { displayBanner, displayCommandBanner } from './utils/banner.js';
 import { getPackageJsonPath } from './utils/pathResolver.js';
@@ -155,11 +157,16 @@ program
     .argument('[provider]', chalk.hex('#95afc0')('Provider for the feature (optional)'))
     .option('-l, --list', chalk.hex('#95afc0')('List all available features'))
     .option('-v, --verbose', chalk.hex('#95afc0')('Show detailed output'))
+    .option('-h, --help', chalk.hex('#95afc0')('Display help for this command'))
     .on('--help', () => {
     showAddHelp();
 })
     .action(async (feature, provider, options) => {
     try {
+        if (options.help) {
+            showAddHelp();
+            return;
+        }
         await addCommand(feature, provider, options);
     }
     catch (error) {
@@ -169,6 +176,7 @@ program
 // UPGRADE-CLI COMMAND - Update CLI to latest version
 program
     .command('upgrade-cli')
+    .alias('upgrade')
     .description(chalk.hex('#ff6b6b')('🚀 ') + chalk.hex('#fd79a8')('Update Package Installer CLI to the latest version'))
     .on('--help', () => {
     showUpgradeHelp();
@@ -195,10 +203,6 @@ program
 })
     .action(async (options) => {
     try {
-        if (options.help) {
-            showAnalyzeHelp();
-            return;
-        }
         await analyzeCommand(options);
     }
     catch (error) {
@@ -310,12 +314,10 @@ program
     .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, options);
     }
     catch (error) {

data/dist/utils/banner.js

@@ -10,8 +10,8 @@ import { getPackageVersion } from './utils.js';
  * Generate the main CLI banner with gradient colors
  */
 export function generateBanner() {
-    const packageGradient = gradient(['#00c6ff', '#4facfe', '#6c5ce7']);
-    const installerGradient = gradient(['#fd79a8', '#e84393', '#fd79a8']);
+    const packageGradient = gradient(['#0072ff', '#00c6ff', '#4facfe']);
+    const installerGradient = gradient(['#00c6ff', '#0072ff', '#667eea']);
     return boxen(packageGradient('           ██████╗  █████╗  ██████╗██╗  ██╗ █████╗  ██████╗ ███████╗') + '\n' +
         packageGradient('           ██╔══██╗██╔══██╗██╔════╝██║ ██╔╝██╔══██╗██╔════╝ ██╔════╝') + '\n' +
         packageGradient('           ██████╔╝███████║██║     █████╔╝ ███████║██║  ███╗█████╗  ') + '\n' +

data/dist/utils/featureInstaller.js

@@ -29,7 +29,6 @@ async function loadFeatures() {
             const featuresConfig = featuresData.features || featuresData;
             // Get available features using the centralized function
             const availableFeatures = await getAvailableFeatures();
-            console.log(chalk.gray(`📦 Loading ${availableFeatures.length} available features...`));
             // Process each feature and load its individual JSON file
             for (const [featureName, config] of Object.entries(featuresConfig)) {
                 const featureConfig = config;
@@ -89,10 +88,17 @@ async function loadFeatures() {
         console.warn(chalk.yellow('⚠️  Could not load features.json, using fallback configuration'));
     }
 }
-// Initialize features on module load
-await loadFeatures();
+// Lazy loading flag
+let featuresLoaded = false;
+// Lazy load features when needed
+async function ensureFeaturesLoaded() {
+    if (!featuresLoaded) {
+        await loadFeatures();
+        featuresLoaded = true;
+    }
+}
 // Export for use in other modules
-export { SUPPORTED_FEATURES };
+export { SUPPORTED_FEATURES, ensureFeaturesLoaded };
 // Re-export path utilities for backward compatibility
 export { getCliRootPath } from './pathResolver.js';
 /**
@@ -348,7 +354,7 @@ export async function addFeature(featureName, provider, projectPath = process.cw
     const spinner = ora(chalk.hex('#9c88ff')(`Adding ${featureName} feature...`)).start();
     try {
         // Ensure features are loaded
-        await loadFeatures();
+        await ensureFeaturesLoaded();
         // Validate project path exists
         if (!await fs.pathExists(projectPath)) {
             throw new Error(`Project path does not exist: ${projectPath}`);

data/dist/utils/helpFormatter.js

@@ -25,13 +25,20 @@ export function createStandardHelp(config) {
     });
     helpContent += '\n';
     // Options
+    helpContent += chalk.cyan('Options:') + '\n';
+    // Check if help flag already exists
+    const hasHelpFlag = config.options && config.options.some(option => option.flag.includes('-h') || option.flag.includes('--help'));
+    // Add custom options first
     if (config.options && config.options.length > 0) {
-        helpContent += chalk.cyan('Options:') + '\n';
         config.options.forEach(option => {
             helpContent += chalk.gray(`  ${option.flag.padEnd(20)} ${option.description}`) + '\n';
         });
-        helpContent += '\n';
     }
+    // Add the global help flag only if it doesn't already exist
+    if (!hasHelpFlag) {
+        helpContent += chalk.gray(`  -h, --help`.padEnd(20) + ' Show this help message') + '\n';
+    }
+    helpContent += '\n';
     // Examples
     if (config.examples && config.examples.length > 0) {
         helpContent += chalk.cyan('Examples:') + '\n';

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: package-installer-cli
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - sharique