genbox 1.0.11 → 1.0.13

package/dist/commands/init.js

@@ -103,13 +103,15 @@ function detectAppGitRepos(apps, rootDir) {
     return repos;
 }
 /**
- * Find .env files in app directories
+ * Find .env files in app directories (including nested microservices)
  */
 function findAppEnvFiles(apps, rootDir) {
     const envFiles = [];
     const envPatterns = ['.env', '.env.local', '.env.development'];
     for (const app of apps) {
         const appDir = path_1.default.join(rootDir, app.path);
+        // Check for direct .env file in app directory
+        let foundDirectEnv = false;
         for (const pattern of envPatterns) {
             const envPath = path_1.default.join(appDir, pattern);
             if (fs_1.default.existsSync(envPath)) {
@@ -118,7 +120,35 @@ function findAppEnvFiles(apps, rootDir) {
                     envFile: pattern,
                     fullPath: envPath,
                 });
-                break; // Only take the first match per app
+                foundDirectEnv = true;
+                break;
+            }
+        }
+        // Check for nested microservices (e.g., api/apps/*)
+        const appsSubdir = path_1.default.join(appDir, 'apps');
+        if (fs_1.default.existsSync(appsSubdir) && fs_1.default.statSync(appsSubdir).isDirectory()) {
+            try {
+                const services = fs_1.default.readdirSync(appsSubdir);
+                for (const service of services) {
+                    const serviceDir = path_1.default.join(appsSubdir, service);
+                    if (!fs_1.default.statSync(serviceDir).isDirectory())
+                        continue;
+                    for (const pattern of envPatterns) {
+                        const envPath = path_1.default.join(serviceDir, pattern);
+                        if (fs_1.default.existsSync(envPath)) {
+                            envFiles.push({
+                                appName: `${app.name}/${service}`,
+                                envFile: pattern,
+                                fullPath: envPath,
+                                isService: true,
+                            });
+                            break;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore errors reading subdirectories
             }
         }
     }
@@ -454,6 +484,20 @@ exports.initCommand = new commander_1.Command('init')
         });
         fs_1.default.writeFileSync(configPath, yamlContent);
         console.log(chalk_1.default.green(`\n✔ Configuration saved to ${CONFIG_FILENAME}`));
+        // Add API URLs from environments to envVarsToAdd
+        // Always add LOCAL_API_URL for local development
+        envVarsToAdd['LOCAL_API_URL'] = 'http://localhost:3050';
+        if (v3Config.environments) {
+            for (const [envName, envConfig] of Object.entries(v3Config.environments)) {
+                const apiUrl = envConfig.api?.api ||
+                    envConfig.api?.url ||
+                    envConfig.api?.gateway;
+                if (apiUrl) {
+                    const varName = `${envName.toUpperCase()}_API_URL`;
+                    envVarsToAdd[varName] = apiUrl;
+                }
+            }
+        }
         // Generate .env.genbox
         await setupEnvFile(projectName, v3Config, nonInteractive, scan, isMultiRepo, envVarsToAdd, overwriteExisting);
         // Show warnings
@@ -467,26 +511,35 @@ exports.initCommand = new commander_1.Command('init')
         // Show API URL guidance if environments are configured
         if (v3Config.environments && Object.keys(v3Config.environments).length > 0) {
             console.log('');
-            console.log(chalk_1.default.yellow('Important: Update API URLs in .env.genbox for remote environments'));
+            console.log(chalk_1.default.blue('=== API URL Configuration ==='));
+            console.log(chalk_1.default.dim('The following API URLs were added to .env.genbox:'));
             console.log('');
+            console.log(chalk_1.default.dim('  LOCAL_API_URL=http://localhost:3050'));
             for (const [envName, envConfig] of Object.entries(v3Config.environments)) {
                 const apiUrl = envConfig.api?.api ||
                     envConfig.api?.url ||
                     envConfig.api?.gateway;
                 if (apiUrl) {
-                    console.log(chalk_1.default.dim(`  For ${envName} profiles (connect_to: ${envName}):`));
-                    console.log(chalk_1.default.cyan(`    VITE_API_BASE_URL="${apiUrl}"`));
-                    console.log(chalk_1.default.cyan(`    VITE_AUTH_SERVICE_URL="${apiUrl}"`));
-                    console.log(chalk_1.default.cyan(`    NEXT_PUBLIC_API_BASE_URL="${apiUrl}"`));
-                    console.log('');
+                    const varName = `${envName.toUpperCase()}_API_URL`;
+                    console.log(chalk_1.default.dim(`  ${varName}=${apiUrl}`));
                 }
             }
+            console.log('');
+            console.log(chalk_1.default.yellow('To use dynamic API URLs:'));
+            console.log(chalk_1.default.dim('  Use ${API_URL} in your app env vars, e.g.:'));
+            console.log(chalk_1.default.cyan('    VITE_API_BASE_URL=${API_URL}'));
+            console.log(chalk_1.default.cyan('    NEXT_PUBLIC_API_URL=${API_URL}'));
+            console.log('');
+            console.log(chalk_1.default.dim('  At create time, ${API_URL} expands based on profile:'));
+            console.log(chalk_1.default.dim('    • connect_to: staging → uses STAGING_API_URL'));
+            console.log(chalk_1.default.dim('    • connect_to: production → uses PRODUCTION_API_URL'));
+            console.log(chalk_1.default.dim('    • local/no connect_to → uses LOCAL_API_URL'));
         }
         // Next steps
         console.log('');
         console.log(chalk_1.default.bold('Next steps:'));
         console.log(chalk_1.default.dim(`  1. Review and edit ${CONFIG_FILENAME}`));
-        console.log(chalk_1.default.dim(`  2. Update API URLs in ${ENV_FILENAME} for staging/production`));
+        console.log(chalk_1.default.dim(`  2. Update ${ENV_FILENAME} to use API URL variables where needed`));
         console.log(chalk_1.default.dim(`  3. Run 'genbox profiles' to see available profiles`));
         console.log(chalk_1.default.dim(`  4. Run 'genbox create <name> --profile <profile>' to create an environment`));
     }
@@ -764,7 +817,7 @@ async function setupEnvironments(scan, config, isMultiRepo = false) {
     return Object.keys(environments).length > 0 ? environments : undefined;
 }
 /**
- * Setup .env.genbox file
+ * Setup .env.genbox file with segregated app sections
  */
 async function setupEnvFile(projectName, config, nonInteractive = false, scan, isMultiRepo = false, extraEnvVars = {}, overwriteExisting = false) {
     const envPath = path_1.default.join(process.cwd(), ENV_FILENAME);
@@ -778,66 +831,84 @@ async function setupEnvFile(projectName, config, nonInteractive = false, scan, i
             return;
         }
     }
+    // Build segregated content with GLOBAL section first
+    let segregatedContent = `# Genbox Environment Variables
+# Project: ${projectName}
+# DO NOT COMMIT THIS FILE
+#
+# This file uses segregated sections for each app/service.
+# At 'genbox create' time, only GLOBAL + selected app sections are used.
+# Use \${API_URL} for dynamic API URLs based on profile's connect_to setting.
+
+# === GLOBAL ===
+# These variables are always included regardless of which apps are selected
+
+`;
+    // Add global env vars
+    for (const [key, value] of Object.entries(extraEnvVars)) {
+        segregatedContent += `${key}=${value}\n`;
+    }
+    // Add GIT authentication placeholder if not already added
+    if (!extraEnvVars['GIT_TOKEN']) {
+        segregatedContent += `# GIT_TOKEN=ghp_xxxxxxxxxxxx\n`;
+    }
+    segregatedContent += `
+# Database URLs (used by profiles with database mode)
+# STAGING_MONGODB_URL=mongodb+srv://user:password@staging.mongodb.net
+# PROD_MONGODB_URL=mongodb+srv://readonly:password@prod.mongodb.net
+
+`;
     // For multi-repo: find env files in app directories
     if (isMultiRepo && scan) {
         const appEnvFiles = findAppEnvFiles(scan.apps, process.cwd());
         if (appEnvFiles.length > 0 && !nonInteractive) {
             console.log('');
             console.log(chalk_1.default.blue('=== Environment Files ==='));
-            console.log(chalk_1.default.dim(`Found .env files in ${appEnvFiles.length} app directories`));
+            // Group by app type
+            const directApps = appEnvFiles.filter(e => !e.isService);
+            const serviceApps = appEnvFiles.filter(e => e.isService);
+            if (directApps.length > 0) {
+                console.log(chalk_1.default.dim(`Found ${directApps.length} app env files`));
+            }
+            if (serviceApps.length > 0) {
+                console.log(chalk_1.default.dim(`Found ${serviceApps.length} microservice env files`));
+            }
             const envChoices = appEnvFiles.map(env => ({
-                name: `${env.appName}/${env.envFile}`,
+                name: env.isService ? `${env.appName} (service)` : env.appName,
                 value: env.fullPath,
                 checked: true,
             }));
             const selectedEnvFiles = await prompts.checkbox({
-                message: 'Select .env files to merge into .env.genbox:',
+                message: 'Select .env files to include in .env.genbox:',
                 choices: envChoices,
             });
             if (selectedEnvFiles.length > 0) {
-                let mergedContent = `# Genbox Environment Variables
-# Merged from: ${selectedEnvFiles.map(f => path_1.default.relative(process.cwd(), f)).join(', ')}
-# DO NOT COMMIT THIS FILE
-#
-# Add staging/production URLs:
-# STAGING_MONGODB_URL=mongodb+srv://...
-# STAGING_REDIS_URL=redis://...
-# PROD_MONGODB_URL=mongodb+srv://...
-#
-# Git authentication:
-# GIT_TOKEN=ghp_xxxxxxxxxxxx
-
-`;
                 for (const envFilePath of selectedEnvFiles) {
                     const appInfo = appEnvFiles.find(e => e.fullPath === envFilePath);
-                    const content = fs_1.default.readFileSync(envFilePath, 'utf8');
-                    mergedContent += `\n# === ${appInfo?.appName || path_1.default.dirname(envFilePath)} ===\n`;
-                    mergedContent += content;
-                    mergedContent += '\n';
+                    if (!appInfo)
+                        continue;
+                    const content = fs_1.default.readFileSync(envFilePath, 'utf8').trim();
+                    // Add section header and content
+                    segregatedContent += `# === ${appInfo.appName} ===\n`;
+                    segregatedContent += content;
+                    segregatedContent += '\n\n';
                 }
-                fs_1.default.writeFileSync(envPath, mergedContent);
-                console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME} from ${selectedEnvFiles.length} app env files`));
             }
         }
         else if (appEnvFiles.length > 0 && nonInteractive) {
             // Non-interactive: merge all env files
-            let mergedContent = `# Genbox Environment Variables
-# Merged from app directories
-# DO NOT COMMIT THIS FILE
-
-`;
             for (const envFile of appEnvFiles) {
-                const content = fs_1.default.readFileSync(envFile.fullPath, 'utf8');
-                mergedContent += `\n# === ${envFile.appName} ===\n`;
-                mergedContent += content;
-                mergedContent += '\n';
+                const content = fs_1.default.readFileSync(envFile.fullPath, 'utf8').trim();
+                segregatedContent += `# === ${envFile.appName} ===\n`;
+                segregatedContent += content;
+                segregatedContent += '\n\n';
             }
-            fs_1.default.writeFileSync(envPath, mergedContent);
-            console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME} from ${appEnvFiles.length} app env files`));
         }
     }
-    // If no env file created yet, check for root .env
-    if (!fs_1.default.existsSync(envPath)) {
+    // If no app env files found, check for root .env
+    const hasAppSections = segregatedContent.includes('# === ') &&
+        !segregatedContent.endsWith('# === GLOBAL ===\n');
+    if (!hasAppSections) {
         const existingEnvFiles = ['.env.local', '.env', '.env.development'];
         let existingEnvPath;
         for (const envFile of existingEnvFiles) {
@@ -849,51 +920,28 @@ async function setupEnvFile(projectName, config, nonInteractive = false, scan, i
         }
         if (existingEnvPath) {
             const copyExisting = nonInteractive ? true : await prompts.confirm({
-                message: `Found ${path_1.default.basename(existingEnvPath)}. Copy to ${ENV_FILENAME}?`,
+                message: `Found ${path_1.default.basename(existingEnvPath)}. Include in ${ENV_FILENAME}?`,
                 default: true,
             });
             if (copyExisting) {
-                const content = fs_1.default.readFileSync(existingEnvPath, 'utf8');
-                const header = `# Genbox Environment Variables
-# Generated from ${path_1.default.basename(existingEnvPath)}
-# DO NOT COMMIT THIS FILE
-#
-# Add staging/production URLs:
-# STAGING_MONGODB_URL=mongodb+srv://...
-# STAGING_REDIS_URL=redis://...
-# PROD_MONGODB_URL=mongodb+srv://...
-#
-# Git authentication:
-# GIT_TOKEN=ghp_xxxxxxxxxxxx
-
-`;
-                fs_1.default.writeFileSync(envPath, header + content);
-                console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME} from ${path_1.default.basename(existingEnvPath)}`));
-            }
-        }
-        else {
-            const createEnv = nonInteractive ? true : await prompts.confirm({
-                message: `Create ${ENV_FILENAME} template?`,
-                default: true,
-            });
-            if (createEnv) {
-                const template = generateEnvTemplate(projectName, config);
-                fs_1.default.writeFileSync(envPath, template);
-                console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME} template`));
+                const content = fs_1.default.readFileSync(existingEnvPath, 'utf8').trim();
+                segregatedContent += `# === root ===\n`;
+                segregatedContent += `# From ${path_1.default.basename(existingEnvPath)}\n`;
+                segregatedContent += content;
+                segregatedContent += '\n\n';
             }
         }
     }
-    // Append extra env vars (like GIT_TOKEN) to the file
-    if (Object.keys(extraEnvVars).length > 0 && fs_1.default.existsSync(envPath)) {
-        let content = fs_1.default.readFileSync(envPath, 'utf8');
-        // Add extra env vars section
-        let extraSection = '\n# === Added by genbox init ===\n';
-        for (const [key, value] of Object.entries(extraEnvVars)) {
-            // Remove any existing commented placeholder
-            content = content.replace(new RegExp(`^#\\s*${key}=.*$`, 'gm'), '');
-            extraSection += `${key}=${value}\n`;
-        }
-        fs_1.default.writeFileSync(envPath, content.trim() + '\n' + extraSection);
+    // Add END marker
+    segregatedContent += `# === END ===\n`;
+    // Write the file
+    fs_1.default.writeFileSync(envPath, segregatedContent);
+    const sectionCount = (segregatedContent.match(/# === [^=]+ ===/g) || []).length - 2; // Exclude GLOBAL and END
+    if (sectionCount > 0) {
+        console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME} with ${sectionCount} app section(s)`));
+    }
+    else {
+        console.log(chalk_1.default.green(`✔ Created ${ENV_FILENAME}`));
     }
     // Add to .gitignore
     const gitignorePath = path_1.default.join(process.cwd(), '.gitignore');
@@ -915,6 +963,19 @@ function generateEnvTemplate(projectName, config) {
         '# DO NOT COMMIT THIS FILE',
         '',
         '# ============================================',
+        '# API URL CONFIGURATION',
+        '# ============================================',
+        '# Use ${API_URL} in your app env vars (e.g., VITE_API_BASE_URL=${API_URL})',
+        '# At create time, ${API_URL} expands based on profile:',
+        '#   - connect_to: staging → uses STAGING_API_URL',
+        '#   - connect_to: production → uses PRODUCTION_API_URL',
+        '#   - local/no connect_to → uses LOCAL_API_URL',
+        '',
+        'LOCAL_API_URL=http://localhost:3050',
+        'STAGING_API_URL=https://api.staging.example.com',
+        '# PRODUCTION_API_URL=https://api.example.com',
+        '',
+        '# ============================================',
         '# STAGING ENVIRONMENT',
         '# ============================================',
         '',
@@ -957,6 +1018,15 @@ function generateEnvTemplate(projectName, config) {
         'STRIPE_SECRET_KEY=sk_test_xxx',
         'STRIPE_WEBHOOK_SECRET=whsec_xxx',
         '',
+        '# ============================================',
+        '# APPLICATION ENV VARS',
+        '# ============================================',
+        '# Use ${API_URL} for dynamic API URLs',
+        '',
+        '# Example:',
+        '# VITE_API_BASE_URL=${API_URL}',
+        '# NEXT_PUBLIC_API_URL=${API_URL}',
+        '',
     ];
     return lines.join('\n');
 }

package/dist/commands/migrate.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Migrate Command
+ *
+ * Migrates genbox.yaml from v3 to v4 format:
+ * - Shows what changes will be made
+ * - Creates backup of original
+ * - Applies migration
+ *
+ * Usage:
+ *   genbox migrate              # Interactive migration
+ *   genbox migrate --dry-run    # Show changes without applying
+ *   genbox migrate --yes        # Skip confirmation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deprecationsCommand = exports.migrateCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const prompts_1 = require("@inquirer/prompts");
+const config_loader_1 = require("../config-loader");
+const migration_1 = require("../migration");
+exports.migrateCommand = new commander_1.Command('migrate')
+    .description('Migrate genbox.yaml from v3 to v4 format')
+    .option('--dry-run', 'Show changes without applying')
+    .option('-y, --yes', 'Skip confirmation prompts')
+    .option('--no-backup', 'Skip creating backup file')
+    .option('--json', 'Output migration plan as JSON')
+    .action(async (options) => {
+    const cwd = process.cwd();
+    console.log(chalk_1.default.cyan('\n🔄 Genbox Configuration Migration\n'));
+    try {
+        // Load current configuration
+        const configLoader = new config_loader_1.ConfigLoader();
+        const loadResult = await configLoader.load(cwd);
+        if (!loadResult.found || !loadResult.config) {
+            console.log(chalk_1.default.red('No genbox.yaml found. Nothing to migrate.'));
+            process.exit(1);
+        }
+        const config = loadResult.config;
+        // Check if migration is needed
+        if (!(0, migration_1.needsMigration)(config)) {
+            console.log(chalk_1.default.green('✓ Configuration is already at v4. No migration needed.'));
+            return;
+        }
+        // Show deprecation warnings
+        const deprecations = (0, migration_1.checkDeprecations)(config);
+        if (deprecations.length > 0) {
+            console.log(chalk_1.default.yellow.bold(`Found ${deprecations.length} deprecated patterns:\n`));
+            for (const dep of deprecations) {
+                console.log(chalk_1.default.yellow(`  • ${dep.path}: ${dep.message}`));
+                console.log(chalk_1.default.dim(`    → ${dep.suggestion}`));
+            }
+            console.log();
+        }
+        // Get migration summary
+        const summary = (0, migration_1.getMigrationSummary)(config);
+        console.log(chalk_1.default.bold('Migration Summary:\n'));
+        console.log(`  Fields to migrate: ${summary.fieldsToMigrate}`);
+        console.log(`  Deprecated patterns: ${summary.deprecatedPatterns}`);
+        if (summary.estimatedChanges.length > 0) {
+            console.log(chalk_1.default.bold('\n  Changes to be made:'));
+            for (const change of summary.estimatedChanges) {
+                console.log(`    • ${change}`);
+            }
+        }
+        // Perform migration
+        const result = (0, migration_1.migrateV3ToV4)(config);
+        if (options.json) {
+            console.log(JSON.stringify({
+                summary,
+                changes: result.changes,
+                warnings: result.warnings,
+                config: result.config,
+            }, null, 2));
+            return;
+        }
+        // Show detailed changes
+        console.log(chalk_1.default.bold('\n📝 Detailed Changes:\n'));
+        for (const change of result.changes) {
+            const icon = change.type === 'add' ? '+' :
+                change.type === 'remove' ? '-' :
+                    change.type === 'rename' ? '→' : '~';
+            const color = change.type === 'add' ? chalk_1.default.green :
+                change.type === 'remove' ? chalk_1.default.red :
+                    chalk_1.default.yellow;
+            console.log(color(`  ${icon} ${change.path}: ${change.description}`));
+        }
+        // Show warnings
+        if (result.warnings.length > 0) {
+            console.log(chalk_1.default.yellow.bold('\n⚠️  Warnings:\n'));
+            for (const warning of result.warnings) {
+                console.log(chalk_1.default.yellow(`  • ${warning}`));
+            }
+        }
+        // Dry run stops here
+        if (options.dryRun) {
+            console.log(chalk_1.default.bold('\n📄 Migrated Configuration (preview):\n'));
+            console.log(chalk_1.default.dim('---'));
+            console.log(yaml.dump(result.config, { lineWidth: 120, noRefs: true }));
+            console.log(chalk_1.default.dim('---'));
+            console.log(chalk_1.default.cyan('\nThis was a dry run. No changes were made.'));
+            console.log('Run ' + chalk_1.default.bold('genbox migrate') + ' (without --dry-run) to apply changes.');
+            return;
+        }
+        // Confirm migration
+        if (!options.yes) {
+            console.log();
+            const confirmed = await (0, prompts_1.confirm)({
+                message: 'Apply these changes to genbox.yaml?',
+                default: true,
+            });
+            if (!confirmed) {
+                console.log(chalk_1.default.yellow('Migration cancelled.'));
+                return;
+            }
+        }
+        // Find the config file path
+        const projectSource = loadResult.sources.find(s => s.type === 'project');
+        if (!projectSource) {
+            console.log(chalk_1.default.red('Could not find project config file path.'));
+            process.exit(1);
+        }
+        const configPath = projectSource.path;
+        // Create backup
+        if (options.backup !== false) {
+            const backupPath = configPath.replace('.yaml', '.v3.yaml.bak');
+            fs.copyFileSync(configPath, backupPath);
+            console.log(chalk_1.default.dim(`\nBackup created: ${backupPath}`));
+        }
+        // Write migrated config
+        const migratedContent = yaml.dump(result.config, {
+            lineWidth: 120,
+            noRefs: true,
+            quotingType: '"',
+            forceQuotes: false,
+        });
+        // Add header comment
+        const header = `# Genbox Configuration v4
+# Migrated from v3 on ${new Date().toISOString()}
+# See: https://genbox.dev/docs/config-v4
+
+`;
+        fs.writeFileSync(configPath, header + migratedContent);
+        console.log(chalk_1.default.green.bold('\n✓ Migration complete!'));
+        console.log(`\n  Updated: ${configPath}`);
+        // Next steps
+        console.log(chalk_1.default.bold('\n📝 Next steps:\n'));
+        console.log('  1. Review the migrated configuration');
+        console.log('  2. Run ' + chalk_1.default.cyan('genbox validate') + ' to check for issues');
+        console.log('  3. Run ' + chalk_1.default.cyan('genbox scan') + ' to update detected.yaml');
+        console.log('  4. Run ' + chalk_1.default.cyan('genbox resolve') + ' to verify resolution');
+        console.log();
+        // Show v4 benefits
+        console.log(chalk_1.default.bold('🎉 v4 Benefits:\n'));
+        console.log('  • Explicit connections with ' + chalk_1.default.cyan('connects_to'));
+        console.log('  • Clear infrastructure with ' + chalk_1.default.cyan('provides'));
+        console.log('  • Opt-in detection with ' + chalk_1.default.cyan('$detect') + ' markers');
+        console.log('  • Strict mode for predictable behavior');
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Migration failed:'), error);
+        process.exit(1);
+    }
+});
+/**
+ * Show deprecation warnings subcommand
+ */
+exports.deprecationsCommand = new commander_1.Command('deprecations')
+    .description('Check for deprecated patterns in genbox.yaml')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const cwd = process.cwd();
+    try {
+        const configLoader = new config_loader_1.ConfigLoader();
+        const loadResult = await configLoader.load(cwd);
+        if (!loadResult.found || !loadResult.config) {
+            console.log(chalk_1.default.red('No genbox.yaml found.'));
+            process.exit(1);
+        }
+        const deprecations = (0, migration_1.checkDeprecations)(loadResult.config);
+        if (options.json) {
+            console.log(JSON.stringify(deprecations, null, 2));
+            return;
+        }
+        if (deprecations.length === 0) {
+            console.log(chalk_1.default.green('✓ No deprecated patterns found.'));
+            return;
+        }
+        console.log(chalk_1.default.yellow.bold(`\nFound ${deprecations.length} deprecated pattern(s):\n`));
+        for (const dep of deprecations) {
+            const icon = dep.severity === 'error' ? '✗' : '⚠';
+            const color = dep.severity === 'error' ? chalk_1.default.red : chalk_1.default.yellow;
+            console.log(color(`${icon} ${dep.path}`));
+            console.log(`  ${dep.message}`);
+            console.log(chalk_1.default.dim(`  → ${dep.suggestion}`));
+            if (dep.autoMigrate) {
+                console.log(chalk_1.default.dim('  (can be auto-migrated)'));
+            }
+            console.log();
+        }
+        console.log(chalk_1.default.bold('Run ' + chalk_1.default.cyan('genbox migrate') + ' to fix these issues.\n'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Check failed:'), error);
+        process.exit(1);
+    }
+});