genbox 1.0.0

package/dist/commands/status.js

@@ -0,0 +1,294 @@
+"use strict";
+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.statusCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../api");
+const config_1 = require("../config");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+function getPrivateSshKey() {
+    const home = os.homedir();
+    const potentialKeys = [
+        path.join(home, '.ssh', 'id_rsa'),
+        path.join(home, '.ssh', 'id_ed25519'),
+    ];
+    for (const keyPath of potentialKeys) {
+        if (fs.existsSync(keyPath)) {
+            return keyPath;
+        }
+    }
+    throw new Error('No SSH private key found in ~/.ssh/');
+}
+function sshExec(ip, keyPath, command, timeoutSecs = 10) {
+    const sshOpts = `-i ${keyPath} -o IdentitiesOnly=yes -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -o ConnectTimeout=${timeoutSecs}`;
+    try {
+        const result = (0, child_process_1.execSync)(`ssh ${sshOpts} dev@${ip} "${command}"`, {
+            encoding: 'utf8',
+            timeout: (timeoutSecs + 5) * 1000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        // Return stderr or empty string on failure
+        if (error.stderr)
+            return error.stderr.toString().trim();
+        if (error.stdout)
+            return error.stdout.toString().trim();
+        return '';
+    }
+}
+exports.statusCommand = new commander_1.Command('status')
+    .description('Check cloud-init progress and service status of a Genbox')
+    .argument('<name>', 'Name of the Genbox')
+    .action(async (name) => {
+    try {
+        // 1. Find Genbox
+        const genboxes = await (0, api_1.fetchApi)('/genboxes');
+        const target = genboxes.find((a) => a.name === name);
+        if (!target) {
+            console.error(chalk_1.default.red(`Genbox '${name}' not found.`));
+            return;
+        }
+        if (!target.ipAddress) {
+            console.error(chalk_1.default.yellow(`Genbox '${name}' is still provisioning (no IP yet). Please wait.`));
+            return;
+        }
+        // 2. Get SSH key
+        let keyPath;
+        try {
+            keyPath = getPrivateSshKey();
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(error.message));
+            return;
+        }
+        console.log(chalk_1.default.blue(`[INFO] Checking cloud-init progress on ${name}...`));
+        console.log('');
+        // 3. Check cloud-init status
+        const status = sshExec(target.ipAddress, keyPath, 'cloud-init status 2>&1');
+        if (!status) {
+            console.log(chalk_1.default.yellow('[WARN] Unable to connect to server. It may still be booting.'));
+            return;
+        }
+        if (status.includes('running')) {
+            // Get elapsed time since server boot
+            const uptime = sshExec(target.ipAddress, keyPath, "cat /proc/uptime 2>/dev/null | cut -d' ' -f1 | cut -d'.' -f1");
+            if (uptime) {
+                const uptimeSecs = parseInt(uptime, 10);
+                const mins = Math.floor(uptimeSecs / 60);
+                const secs = uptimeSecs % 60;
+                console.log(chalk_1.default.yellow(`[WARN] Cloud-init is still running... (elapsed: ${mins}m ${secs}s)`));
+            }
+            else {
+                console.log(chalk_1.default.yellow('[WARN] Cloud-init is still running...'));
+            }
+            console.log('');
+            console.log(chalk_1.default.blue('[INFO] Latest setup progress:'));
+            // Tail cloud-init output log for progress
+            const logOutput = sshExec(target.ipAddress, keyPath, "sudo tail -30 /var/log/cloud-init-output.log 2>/dev/null | grep -E '^===|^#|Progress:|DONE|error|Error|failed|Failed' || sudo tail -20 /var/log/cloud-init-output.log", 15);
+            if (logOutput) {
+                console.log(logOutput);
+            }
+        }
+        else if (status.includes('done')) {
+            console.log(chalk_1.default.green('[SUCCESS] Cloud-init completed!'));
+            console.log('');
+            // Show timing summary
+            console.log(chalk_1.default.blue('[INFO] === Timing Summary ==='));
+            const setupTime = sshExec(target.ipAddress, keyPath, "sudo grep 'Setup completed in' /var/log/cloud-init-output.log 2>/dev/null | tail -1 | sed 's/=== //g; s/ ===//g'");
+            if (setupTime) {
+                console.log(`  ${setupTime}`);
+            }
+            const cloudInitTotal = sshExec(target.ipAddress, keyPath, "sudo grep 'Cloud-init.*finished' /var/log/cloud-init-output.log 2>/dev/null | tail -1");
+            if (cloudInitTotal) {
+                console.log(`  ${cloudInitTotal}`);
+            }
+            console.log('');
+            // Show Database Stats - from config
+            console.log(chalk_1.default.blue('[INFO] === Database Stats ==='));
+            let dbContainer = '';
+            let dbName = '';
+            // Try to load database settings from config
+            if ((0, config_1.hasConfig)()) {
+                try {
+                    const config = (0, config_1.loadConfig)();
+                    if (config.database) {
+                        dbName = config.database.name;
+                        dbContainer = config.database.container || `${config.project_name}-mongodb`;
+                    }
+                    else {
+                        // Default from project name
+                        dbName = config.project_name;
+                        dbContainer = `${config.project_name}-mongodb`;
+                    }
+                }
+                catch {
+                    // Config load failed
+                }
+            }
+            if (dbContainer && dbName) {
+                const dbStats = sshExec(target.ipAddress, keyPath, `docker exec ${dbContainer} mongosh --quiet ${dbName} --eval 'print("Collections: " + db.getCollectionNames().length); db.getCollectionNames().slice(0, 5).forEach(c => print("  " + c + ": " + db[c].countDocuments()))' 2>/dev/null || echo "Unable to fetch stats"`, 15);
+                if (dbStats) {
+                    const lines = dbStats.split('\n');
+                    for (const line of lines) {
+                        if (line.trim()) {
+                            console.log(`  ${line}`);
+                        }
+                    }
+                }
+            }
+            else {
+                console.log(chalk_1.default.dim('  No database configured in genbox.yaml'));
+                console.log(chalk_1.default.dim('  Run `genbox init` to configure database'));
+            }
+            console.log('');
+            // Show Docker containers status
+            console.log(chalk_1.default.blue('[INFO] === Docker Services ==='));
+            const dockerStatus = sshExec(target.ipAddress, keyPath, 'docker ps --format "table {{.Names}}\\t{{.Status}}" 2>/dev/null || echo "No containers running"', 10);
+            if (dockerStatus) {
+                console.log(dockerStatus);
+            }
+            console.log('');
+            // Show Health Checks - from config services
+            console.log(chalk_1.default.blue('[INFO] === Health Checks ==='));
+            let healthChecks = [];
+            // Try to load services from genbox.yaml config
+            if ((0, config_1.hasConfig)()) {
+                try {
+                    const config = (0, config_1.loadConfig)();
+                    if (config.services && Object.keys(config.services).length > 0) {
+                        for (const [serviceName, serviceConfig] of Object.entries(config.services)) {
+                            const healthEndpoint = serviceConfig.healthcheck || '/health';
+                            healthChecks.push({
+                                name: `${serviceName} (${serviceConfig.port})`,
+                                url: `http://localhost:${serviceConfig.port}${healthEndpoint}`,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // Config load failed, will use empty array
+                }
+            }
+            // If no services in config, show message
+            if (healthChecks.length === 0) {
+                console.log(chalk_1.default.dim('  No services configured in genbox.yaml'));
+                console.log(chalk_1.default.dim('  Run `genbox init` to configure services'));
+            }
+            else {
+                for (const check of healthChecks) {
+                    const result = sshExec(target.ipAddress, keyPath, `curl -s -o /dev/null -w '%{http_code}' "${check.url}" 2>/dev/null || echo "N/A"`, 5);
+                    const statusCode = result.trim();
+                    if (statusCode === '200') {
+                        console.log(`  ${chalk_1.default.green('✓')} ${check.name}: ${statusCode}`);
+                    }
+                    else {
+                        console.log(`  ${chalk_1.default.red('✗')} ${check.name}: ${statusCode}`);
+                    }
+                }
+            }
+            console.log('');
+            // Show URLs if available
+            if (target.urls && Object.keys(target.urls).length > 0) {
+                console.log(chalk_1.default.blue('[INFO] === Service URLs ==='));
+                for (const [service, url] of Object.entries(target.urls)) {
+                    console.log(`  ${service}: ${chalk_1.default.cyan(url)}`);
+                }
+            }
+        }
+        else if (status.includes('error') || status.includes('recoverable')) {
+            // Check if setup actually completed successfully despite cloud-init error
+            const setupComplete = sshExec(target.ipAddress, keyPath, "sudo grep 'Setup Complete' /var/log/cloud-init-output.log 2>/dev/null | tail -1");
+            if (setupComplete && setupComplete.includes('Setup Complete')) {
+                // Setup completed but cloud-init reports error (likely a non-critical package failure)
+                console.log(chalk_1.default.yellow('[WARN] Cloud-init reported an error, but setup completed successfully!'));
+                console.log('');
+                // Extract setup time
+                const setupTime = sshExec(target.ipAddress, keyPath, "sudo grep 'Setup Complete in' /var/log/cloud-init-output.log 2>/dev/null | tail -1 | sed 's/=== //g; s/ ===//g'");
+                if (setupTime) {
+                    console.log(chalk_1.default.green(`  ${setupTime}`));
+                }
+                console.log('');
+                // Show the non-critical error
+                console.log(chalk_1.default.blue('[INFO] Non-critical error (package installation):'));
+                const pkgError = sshExec(target.ipAddress, keyPath, "sudo grep -A2 'pkgProblemResolver\\|package_update_upgrade_install.*failed' /var/log/cloud-init-output.log 2>/dev/null | head -5");
+                if (pkgError) {
+                    console.log(chalk_1.default.dim(pkgError));
+                }
+                console.log('');
+                // Show PM2 processes
+                console.log(chalk_1.default.blue('[INFO] === Running Services (PM2) ==='));
+                const pm2List = sshExec(target.ipAddress, keyPath, "source ~/.nvm/nvm.sh 2>/dev/null; pm2 list 2>/dev/null || echo 'PM2 not running'", 10);
+                if (pm2List) {
+                    console.log(pm2List);
+                }
+                console.log('');
+                // Show URLs if available
+                if (target.urls && Object.keys(target.urls).length > 0) {
+                    console.log(chalk_1.default.blue('[INFO] === Service URLs ==='));
+                    for (const [service, url] of Object.entries(target.urls)) {
+                        console.log(`  ${service}: ${chalk_1.default.cyan(url)}`);
+                    }
+                }
+            }
+            else {
+                // Actual error - setup did not complete
+                console.log(chalk_1.default.red('[ERROR] Cloud-init encountered an error!'));
+                console.log('');
+                console.log(chalk_1.default.blue('[INFO] Error details:'));
+                const errorLog = sshExec(target.ipAddress, keyPath, "sudo tail -50 /var/log/cloud-init-output.log 2>/dev/null | grep -i 'error\\|failed\\|fatal' | tail -10", 15);
+                if (errorLog) {
+                    console.log(errorLog);
+                }
+                console.log('');
+                console.log(chalk_1.default.dim('Run `genbox connect ' + name + '` to investigate further.'));
+            }
+        }
+        else {
+            console.log(chalk_1.default.yellow(`[INFO] Cloud-init status: ${status}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});

package/dist/commands/urls.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlsCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../api");
+exports.urlsCommand = new commander_1.Command('urls')
+    .description('Show all URLs for a Genbox environment')
+    .argument('<name>', 'Name of the Genbox')
+    .action(async (name) => {
+    const spinner = (0, ora_1.default)(`Fetching URLs for '${name}'...`).start();
+    try {
+        // Fetch all genboxes and find by name
+        const genboxes = await (0, api_1.fetchApi)('/genboxes', { method: 'GET' });
+        const genbox = genboxes.find((a) => a.name === name);
+        if (!genbox) {
+            spinner.fail(chalk_1.default.red(`Genbox '${name}' not found`));
+            return;
+        }
+        spinner.stop();
+        console.log('\n' + chalk_1.default.bold('Environment Details'));
+        console.log(chalk_1.default.dim('───────────────────────────────────────────────'));
+        console.log(`  ${chalk_1.default.bold('Name:')}        ${genbox.name}`);
+        console.log(`  ${chalk_1.default.bold('Project:')}     ${genbox.project || 'default'}`);
+        console.log(`  ${chalk_1.default.bold('Workspace:')}   ${genbox.workspace || 'default'}`);
+        console.log(`  ${chalk_1.default.bold('Status:')}      ${getStatusColor(genbox.status)}`);
+        if (genbox.ipAddress) {
+            console.log(`  ${chalk_1.default.bold('IP Address:')} ${genbox.ipAddress}`);
+        }
+        console.log(chalk_1.default.dim('───────────────────────────────────────────────'));
+        // Display URLs
+        if (genbox.urls && Object.keys(genbox.urls).length > 0) {
+            console.log('\n' + chalk_1.default.bold('Access URLs:'));
+            console.log(chalk_1.default.dim('(URLs are active when status is "running")\n'));
+            for (const [service, url] of Object.entries(genbox.urls)) {
+                const serviceLabel = service.padEnd(12);
+                console.log(`  ${chalk_1.default.cyan(serviceLabel)} ${url}`);
+            }
+        }
+        else {
+            console.log(chalk_1.default.yellow('\nNo URLs configured for this environment.'));
+        }
+        // Show connection info
+        console.log('\n' + chalk_1.default.bold('Quick Commands:'));
+        console.log(`  ${chalk_1.default.dim('SSH:')}      genbox connect ${name}`);
+        console.log(`  ${chalk_1.default.dim('Logs:')}     genbox logs ${name}`);
+        console.log(`  ${chalk_1.default.dim('Status:')}   genbox status ${name}`);
+        console.log(`  ${chalk_1.default.dim('Destroy:')}  genbox destroy ${name}`);
+        console.log('');
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+function getStatusColor(status) {
+    switch (status) {
+        case 'running':
+            return chalk_1.default.green(status);
+        case 'provisioning':
+            return chalk_1.default.yellow(status);
+        case 'stopped':
+            return chalk_1.default.gray(status);
+        case 'terminated':
+            return chalk_1.default.red(status);
+        case 'error':
+            return chalk_1.default.red(status);
+        default:
+            return status;
+    }
+}

package/dist/config-store.js

@@ -0,0 +1,65 @@
+"use strict";
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CONFIG_DIR = path.join(os.homedir(), '.genbox');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+class ConfigStore {
+    static load() {
+        if (!fs.existsSync(CONFIG_FILE)) {
+            return {};
+        }
+        try {
+            return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    static save(config) {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    }
+    static getToken() {
+        const config = this.load();
+        return config.auth?.token;
+    }
+}
+exports.ConfigStore = ConfigStore;

package/dist/config.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigPath = getConfigPath;
+exports.getEnvPath = getEnvPath;
+exports.hasConfig = hasConfig;
+exports.hasEnvFile = hasEnvFile;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.loadEnvVars = loadEnvVars;
+exports.saveEnvVars = saveEnvVars;
+exports.generateEnvTemplate = generateEnvTemplate;
+exports.findExistingEnvFile = findExistingEnvFile;
+exports.readEnvFileContent = readEnvFileContent;
+exports.findExistingEnvContent = findExistingEnvContent;
+exports.copyExistingEnvToGenbox = copyExistingEnvToGenbox;
+exports.ensureGitTokenInEnv = ensureGitTokenInEnv;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const CONFIG_FILENAME = 'genbox.yaml';
+const ENV_FILENAME = '.env.genbox';
+function getConfigPath() {
+    return path_1.default.join(process.cwd(), CONFIG_FILENAME);
+}
+function getEnvPath() {
+    return path_1.default.join(process.cwd(), ENV_FILENAME);
+}
+function hasConfig() {
+    return fs_1.default.existsSync(getConfigPath());
+}
+function hasEnvFile() {
+    return fs_1.default.existsSync(getEnvPath());
+}
+function loadConfig() {
+    if (!hasConfig()) {
+        throw new Error(`Configuration file ${CONFIG_FILENAME} not found. Run 'genbox init' first.`);
+    }
+    const fileContents = fs_1.default.readFileSync(getConfigPath(), 'utf8');
+    return js_yaml_1.default.load(fileContents);
+}
+function saveConfig(config) {
+    const yamlStr = js_yaml_1.default.dump(config);
+    fs_1.default.writeFileSync(getConfigPath(), yamlStr, 'utf8');
+}
+function loadEnvVars() {
+    if (!hasEnvFile()) {
+        return {};
+    }
+    const envContent = fs_1.default.readFileSync(getEnvPath(), 'utf8');
+    const parsed = dotenv_1.default.parse(envContent);
+    return parsed;
+}
+function saveEnvVars(envVars) {
+    const lines = [];
+    // Add header comment
+    lines.push('# Genbox Environment Variables');
+    lines.push('# This file contains sensitive configuration that will be injected into your genboxes.');
+    lines.push('# DO NOT commit this file to version control!');
+    lines.push('');
+    for (const [key, value] of Object.entries(envVars)) {
+        // Handle multi-line values and special characters
+        if (value.includes('\n') || value.includes('"') || value.includes("'")) {
+            // Use double quotes and escape
+            const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+            lines.push(`${key}="${escaped}"`);
+        }
+        else if (value.includes(' ') || value.includes('#')) {
+            // Quote values with spaces or comments
+            lines.push(`${key}="${value}"`);
+        }
+        else {
+            lines.push(`${key}=${value}`);
+        }
+    }
+    fs_1.default.writeFileSync(getEnvPath(), lines.join('\n') + '\n', 'utf8');
+}
+function generateEnvTemplate(projectName) {
+    // Generate a template with common env vars
+    return {
+        // Database
+        'MONGODB_URI': 'mongodb://localhost:27017/' + projectName,
+        // JWT (generate placeholder)
+        'JWT_SECRET': 'change-me-in-production-' + Math.random().toString(36).substring(7),
+        // Service URLs
+        'RABBITMQ_URL': 'amqp://localhost:5672',
+        'REDIS_URL': 'redis://localhost:6379',
+        // App config
+        'NODE_ENV': 'development',
+    };
+}
+/**
+ * Check if an existing .env file exists (without reading content)
+ * Returns the filename if found, null otherwise
+ */
+function findExistingEnvFile() {
+    const cwd = process.cwd();
+    const envFiles = ['.env.local', '.env'];
+    for (const envFile of envFiles) {
+        const envPath = path_1.default.join(cwd, envFile);
+        if (fs_1.default.existsSync(envPath)) {
+            return envFile;
+        }
+    }
+    return null;
+}
+/**
+ * Read existing .env file content (call after user consent)
+ */
+function readEnvFileContent(envFile) {
+    const envPath = path_1.default.join(process.cwd(), envFile);
+    return fs_1.default.readFileSync(envPath, 'utf8');
+}
+/**
+ * Find and read existing .env file content
+ * Checks .env.local first (priority), then .env
+ * @deprecated Use findExistingEnvFile + readEnvFileContent with consent
+ */
+function findExistingEnvContent() {
+    const envFile = findExistingEnvFile();
+    if (envFile) {
+        const content = readEnvFileContent(envFile);
+        return { path: envFile, content };
+    }
+    return null;
+}
+/**
+ * Copy existing .env content to .env.genbox with genbox header
+ */
+function copyExistingEnvToGenbox(existingContent, sourceName) {
+    const lines = [];
+    // Add header comment
+    lines.push('# Genbox Environment Variables');
+    lines.push(`# Copied from ${sourceName}`);
+    lines.push('# This file contains sensitive configuration that will be injected into your genboxes.');
+    lines.push('# DO NOT commit this file to version control!');
+    lines.push('');
+    // Append the existing content
+    lines.push(existingContent);
+    fs_1.default.writeFileSync(getEnvPath(), lines.join('\n'), 'utf8');
+}
+/**
+ * Ensure GIT_TOKEN entry exists in .env.genbox (for PAT authentication)
+ * Adds the entry if it doesn't exist, doesn't overwrite if it does
+ */
+function ensureGitTokenInEnv() {
+    const envPath = getEnvPath();
+    if (!fs_1.default.existsSync(envPath)) {
+        return;
+    }
+    const content = fs_1.default.readFileSync(envPath, 'utf8');
+    // Check if GIT_TOKEN already exists
+    if (content.includes('GIT_TOKEN=')) {
+        return;
+    }
+    // Append GIT_TOKEN placeholder
+    const gitTokenEntry = '\n# Git Personal Access Token for repository access\nGIT_TOKEN=your_github_pat_here\n';
+    fs_1.default.appendFileSync(envPath, gitTokenEntry, 'utf8');
+}