genbox 1.0.12 → 1.0.13

package/dist/commands/config.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Config Command
+ *
+ * Provides configuration inspection and debugging tools:
+ * - genbox config show         - Show resolved configuration
+ * - genbox config show --explain - Show where each value comes from
+ * - genbox config diff <a> <b> - Compare two profiles
+ */
+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.configCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const yaml = __importStar(require("js-yaml"));
+const config_loader_1 = require("../config-loader");
+const config_explainer_1 = require("../config-explainer");
+exports.configCommand = new commander_1.Command('config')
+    .description('Inspect and debug configuration')
+    .addCommand(createShowCommand())
+    .addCommand(createDiffCommand());
+function createShowCommand() {
+    return new commander_1.Command('show')
+        .description('Show resolved configuration')
+        .argument('[path]', 'Specific config path to show (e.g., apps.web, profiles.quick)')
+        .option('--explain', 'Show where each value comes from')
+        .option('--profile <profile>', 'Show configuration for a specific profile')
+        .option('--json', 'Output as JSON')
+        .option('--yaml', 'Output as YAML (default)')
+        .action(async (configPath, options) => {
+        const configLoader = new config_loader_1.ConfigLoader();
+        const loadResult = await configLoader.load();
+        if (!loadResult.found || !loadResult.config) {
+            console.log(chalk_1.default.red('No genbox.yaml found in current directory or parent directories'));
+            process.exit(1);
+        }
+        const config = loadResult.config;
+        if (options.explain) {
+            await showWithExplain(config, loadResult, configPath, options.profile);
+        }
+        else {
+            await showConfig(config, configPath, options);
+        }
+    });
+}
+function createDiffCommand() {
+    return new commander_1.Command('diff')
+        .description('Compare two profiles')
+        .argument('<profile1>', 'First profile name')
+        .argument('<profile2>', 'Second profile name')
+        .action(async (profile1, profile2) => {
+        const configLoader = new config_loader_1.ConfigLoader();
+        const loadResult = await configLoader.load();
+        if (!loadResult.found || !loadResult.config) {
+            console.log(chalk_1.default.red('No genbox.yaml found'));
+            process.exit(1);
+        }
+        const config = loadResult.config;
+        const p1 = configLoader.getProfile(config, profile1);
+        const p2 = configLoader.getProfile(config, profile2);
+        if (!p1) {
+            console.log(chalk_1.default.red(`Profile '${profile1}' not found`));
+            process.exit(1);
+        }
+        if (!p2) {
+            console.log(chalk_1.default.red(`Profile '${profile2}' not found`));
+            process.exit(1);
+        }
+        showProfileDiff(profile1, p1, profile2, p2, config);
+    });
+}
+async function showConfig(config, path, options) {
+    let data = config;
+    // If profile specified, show that profile's resolved config
+    if (options.profile) {
+        const configLoader = new config_loader_1.ConfigLoader();
+        const profile = configLoader.getProfile(config, options.profile);
+        if (!profile) {
+            console.log(chalk_1.default.red(`Profile '${options.profile}' not found`));
+            process.exit(1);
+        }
+        data = profile;
+    }
+    // Navigate to specific path if provided
+    if (path) {
+        const parts = path.split('.');
+        let current = data;
+        for (const part of parts) {
+            if (current && typeof current === 'object' && part in current) {
+                current = current[part];
+            }
+            else {
+                console.log(chalk_1.default.red(`Path '${path}' not found in configuration`));
+                process.exit(1);
+            }
+        }
+        data = current;
+    }
+    // Output
+    if (options.json) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        console.log(yaml.dump(data, { lineWidth: 120, noRefs: true }));
+    }
+}
+async function showWithExplain(config, loadResult, path, profileName) {
+    const explainer = new config_explainer_1.ConfigExplainer(loadResult);
+    console.log(chalk_1.default.bold.cyan('\n📋 Configuration Analysis\n'));
+    // Show sources
+    console.log(chalk_1.default.bold('Config Sources (priority order):'));
+    for (const source of loadResult.sources) {
+        const icon = source.type === 'workspace' ? '🏢' : source.type === 'project' ? '📁' : '👤';
+        console.log(`  ${icon} ${source.type}: ${source.path}`);
+    }
+    console.log();
+    // If path specified, show just that path
+    if (path) {
+        const explanation = explainer.explain(path, profileName);
+        printExplanation(path, explanation);
+        return;
+    }
+    // Show key configuration values with explanations
+    console.log(chalk_1.default.bold('Key Values:\n'));
+    // Project info
+    printExplanation('project.name', explainer.explain('project.name'));
+    printExplanation('project.structure', explainer.explain('project.structure'));
+    // Apps
+    if (config.apps) {
+        console.log(chalk_1.default.bold('\nApps:'));
+        for (const appName of Object.keys(config.apps)) {
+            console.log(chalk_1.default.cyan(`\n  ${appName}:`));
+            printExplanation(`  apps.${appName}.type`, explainer.explain(`apps.${appName}.type`), 4);
+            printExplanation(`  apps.${appName}.port`, explainer.explain(`apps.${appName}.port`), 4);
+            printExplanation(`  apps.${appName}.framework`, explainer.explain(`apps.${appName}.framework`), 4);
+        }
+    }
+    // Profiles
+    if (config.profiles && profileName) {
+        console.log(chalk_1.default.bold(`\nProfile '${profileName}':`));
+        printExplanation('  size', explainer.explain('size', profileName), 4);
+        printExplanation('  apps', explainer.explain('apps', profileName), 4);
+        printExplanation('  connect_to', explainer.explain('connect_to', profileName), 4);
+        printExplanation('  database.mode', explainer.explain('database.mode', profileName), 4);
+    }
+    // Defaults
+    if (config.defaults) {
+        console.log(chalk_1.default.bold('\nDefaults:'));
+        printExplanation('  defaults.size', explainer.explain('defaults.size'), 4);
+        printExplanation('  defaults.branch', explainer.explain('defaults.branch'), 4);
+    }
+    // Detection warnings
+    const warnings = explainer.getDetectionWarnings();
+    if (warnings.length > 0) {
+        console.log(chalk_1.default.bold.yellow('\n⚠️  Detection Warnings:\n'));
+        for (const warning of warnings) {
+            console.log(chalk_1.default.yellow(`  • ${warning}`));
+        }
+    }
+    console.log();
+}
+function printExplanation(path, sources, indent = 0) {
+    const pad = ' '.repeat(indent);
+    if (sources.length === 0) {
+        console.log(`${pad}${chalk_1.default.dim(path)}: ${chalk_1.default.dim('(not set)')}`);
+        return;
+    }
+    const finalSource = sources.find(s => s.used) || sources[0];
+    const valueStr = formatValue(finalSource.value);
+    console.log(`${pad}${chalk_1.default.white(path)}: ${chalk_1.default.green(valueStr)}`);
+    for (const source of sources) {
+        const icon = source.used ? chalk_1.default.green('✓') : chalk_1.default.dim('○');
+        const sourceLabel = getSourceLabel(source);
+        const value = source.value !== undefined ? formatValue(source.value) : chalk_1.default.dim('(not set)');
+        if (source.used) {
+            console.log(`${pad}  ${icon} ${sourceLabel}: ${value}`);
+            if (source.detectedFrom) {
+                console.log(`${pad}      └─ ${chalk_1.default.dim(`detected from: ${source.detectedFrom}`)}`);
+            }
+        }
+        else {
+            console.log(`${pad}  ${icon} ${chalk_1.default.dim(sourceLabel)}: ${chalk_1.default.dim(String(value))}`);
+        }
+    }
+}
+function getSourceLabel(source) {
+    switch (source.source) {
+        case 'cli':
+            return 'CLI flag';
+        case 'profile':
+            return `Profile '${source.profileName || 'unknown'}'`;
+        case 'project':
+            return 'genbox.yaml (explicit)';
+        case 'workspace':
+            return 'workspace genbox.yaml';
+        case 'detected':
+            return 'detected.yaml';
+        case 'default':
+            return 'schema default';
+        case 'inferred':
+            return 'inferred';
+        default:
+            return source.source;
+    }
+}
+function formatValue(value) {
+    if (value === undefined)
+        return '(undefined)';
+    if (value === null)
+        return '(null)';
+    if (Array.isArray(value))
+        return `[${value.join(', ')}]`;
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+function showProfileDiff(name1, profile1, name2, profile2, config) {
+    console.log(chalk_1.default.bold.cyan(`\n📊 Comparing profiles: ${name1} vs ${name2}\n`));
+    const allKeys = new Set([
+        ...Object.keys(profile1),
+        ...Object.keys(profile2),
+    ]);
+    let hasDiff = false;
+    for (const key of allKeys) {
+        const v1 = profile1[key];
+        const v2 = profile2[key];
+        if (JSON.stringify(v1) !== JSON.stringify(v2)) {
+            hasDiff = true;
+            console.log(chalk_1.default.bold(`  ${key}:`));
+            console.log(chalk_1.default.red(`    - ${name1}: ${formatValue(v1)}`));
+            console.log(chalk_1.default.green(`    + ${name2}: ${formatValue(v2)}`));
+            console.log();
+        }
+    }
+    if (!hasDiff) {
+        console.log(chalk_1.default.dim('  No differences found'));
+    }
+}

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);
+    }
+});