@magentrix-corp/magentrix-cli 1.3.16 → 1.3.17

package/utils/iris/config-reader.js

@@ -1,664 +1,664 @@
-import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { validateSlug, validateUrl, validateAppName, detectExpression, MAX_LENGTHS } from './validation.js';
-import { formatError, detectErrorType, ErrorTypes } from './errors.js';
-
-/**
- * Common locations where config.ts might be found in a Vue project.
- */
-const CONFIG_LOCATIONS = [
-    'src/config.ts',
-    'config.ts',
-    'src/iris-config.ts',
-    'iris-config.ts'
-];
-
-/**
- * The .env file to read configuration from.
- * Currently only .env.development is supported.
- */
-const ENV_FILE = '.env.development';
-
-/**
- * Maximum size of assets array before warning.
- */
-const MAX_ASSETS_WARNING_THRESHOLD = 500;
-
-/**
- * Parse a .env file and return key-value pairs.
- *
- * @param {string} envPath - Path to the .env file
- * @returns {Record<string, string>} - Parsed environment variables
- */
-function parseEnvFile(envPath) {
-    const result = {};
-
-    if (!existsSync(envPath)) {
-        return result;
-    }
-
-    const content = readFileSync(envPath, 'utf-8');
-    const lines = content.split('\n');
-
-    for (const line of lines) {
-        // Skip comments and empty lines
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith('#')) {
-            continue;
-        }
-
-        // Parse KEY=VALUE or KEY = VALUE
-        const match = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
-        if (match) {
-            const key = match[1];
-            let value = match[2].trim();
-
-            // Remove surrounding quotes if present
-            if ((value.startsWith('"') && value.endsWith('"')) ||
-                (value.startsWith("'") && value.endsWith("'"))) {
-                value = value.slice(1, -1);
-            }
-
-            result[key] = value;
-        }
-    }
-
-    return result;
-}
-
-/**
- * Read configuration from .env.development file.
- * Reads siteUrl, assets, and refreshToken.
- *
- * @param {string} projectPath - Path to the Vue project
- * @returns {{
- *   siteUrl: string | null,
- *   assets: string[],
- *   refreshToken: string | null,
- *   envFileUsed: string | null,
- *   warnings: string[],
- *   errors: string[]
- * }}
- */
-export function readEnvConfig(projectPath) {
-    const result = {
-        siteUrl: null,
-        assets: [],
-        refreshToken: null,
-        envFileUsed: null,
-        warnings: [],
-        errors: []
-    };
-
-    const envPath = join(projectPath, ENV_FILE);
-
-    if (!existsSync(envPath)) {
-        return result;
-    }
-
-    let envVars;
-    try {
-        envVars = parseEnvFile(envPath);
-    } catch (err) {
-        result.errors.push(`Failed to read ${ENV_FILE}: ${err.message}`);
-        return result;
-    }
-
-    result.envFileUsed = ENV_FILE;
-
-    // Read and validate VITE_SITE_URL
-    if (envVars.VITE_SITE_URL) {
-        const urlValue = envVars.VITE_SITE_URL;
-        const urlValidation = validateUrl(urlValue);
-
-        if (!urlValidation.valid) {
-            result.errors.push(`VITE_SITE_URL is invalid: ${urlValidation.error}`);
-            if (urlValidation.suggestion) {
-                result.warnings.push(`  Suggestion: ${urlValidation.suggestion}`);
-            }
-        } else {
-            result.siteUrl = urlValidation.normalized || urlValue;
-        }
-    }
-
-    // Read VITE_ASSETS with better error handling
-    if (envVars.VITE_ASSETS) {
-        try {
-            const parsed = JSON.parse(envVars.VITE_ASSETS);
-            if (Array.isArray(parsed)) {
-                result.assets = parsed;
-
-                // Warn if assets array is very large
-                if (parsed.length > MAX_ASSETS_WARNING_THRESHOLD) {
-                    result.warnings.push(
-                        `VITE_ASSETS contains ${parsed.length} items. ` +
-                        `Large arrays may cause performance issues.`
-                    );
-                }
-            } else {
-                result.warnings.push('VITE_ASSETS is not an array, ignoring');
-            }
-        } catch (err) {
-            // Provide helpful error for JSON parsing issues
-            if (envVars.VITE_ASSETS.includes("'") && !envVars.VITE_ASSETS.includes('"')) {
-                result.errors.push(
-                    'VITE_ASSETS contains invalid JSON. ' +
-                    'JSON requires double quotes for strings, not single quotes. ' +
-                    'Example: VITE_ASSETS = \'["url1", "url2"]\''
-                );
-            } else {
-                result.errors.push(`VITE_ASSETS contains invalid JSON: ${err.message}`);
-            }
-        }
-    }
-
-    // Read VITE_REFRESH_TOKEN
-    if (envVars.VITE_REFRESH_TOKEN) {
-        result.refreshToken = envVars.VITE_REFRESH_TOKEN;
-    }
-
-    return result;
-}
-
-/**
- * Find the config.ts file in a Vue project.
- *
- * @param {string} projectPath - Path to the Vue project
- * @returns {string | null} - Path to config.ts or null if not found
- */
-export function findConfigFile(projectPath) {
-    for (const location of CONFIG_LOCATIONS) {
-        const fullPath = join(projectPath, location);
-        if (existsSync(fullPath)) {
-            return fullPath;
-        }
-    }
-    return null;
-}
-
-/**
- * Strip comments from config file content to prevent parsing issues.
- * Removes both single-line (//) and multi-line comments.
- *
- * @param {string} content - Raw config file content
- * @returns {string} - Content with comments removed
- */
-function stripComments(content) {
-    // Remove single-line comments (but not URLs with //)
-    // Match // that's not preceded by : (to avoid breaking URLs)
-    let result = content.replace(/(?<!:)\/\/.*$/gm, '');
-
-    // Remove multi-line comments
-    result = result.replace(/\/\*[\s\S]*?\*\//g, '');
-
-    return result;
-}
-
-/**
- * Parse a config.ts file and extract Iris configuration.
- * Uses regex parsing to avoid TypeScript compilation.
- *
- * @param {string} configPath - Path to the config.ts file
- * @returns {{
- *   slug: string | null,
- *   appName: string | null,
- *   appDescription: string | null,
- *   appIconId: string | null,
- *   siteUrl: string | null,
- *   assets: string[],
- *   raw: string,
- *   warnings: string[]
- * }}
- */
-export function parseConfigFile(configPath) {
-    const result = {
-        slug: null,
-        appName: null,
-        appDescription: null,
-        appIconId: null,
-        siteUrl: null,
-        assets: [],
-        raw: '',
-        warnings: []
-    };
-
-    if (!existsSync(configPath)) {
-        return result;
-    }
-
-    let content;
-    try {
-        content = readFileSync(configPath, 'utf-8');
-    } catch (err) {
-        result.warnings.push(`Failed to read config file: ${err.message}`);
-        return result;
-    }
-
-    result.raw = content;
-
-    // Strip comments before parsing to avoid regex issues
-    const cleanContent = stripComments(content);
-
-    // Extract slug (various patterns)
-    // slug: "dashboard", appSlug: "dashboard", app_slug: "dashboard"
-    // Also handles: slug: env.slug || "fallback"
-    const slugMatch = cleanContent.match(/(?:slug|appSlug|app_slug)\s*:\s*["'`]([^"'`]+)["'`]/);
-    if (slugMatch) {
-        result.slug = slugMatch[1];
-
-        // Check for template literal expressions
-        const exprCheck = detectExpression(result.slug);
-        if (exprCheck.isExpression) {
-            result.warnings.push(
-                `slug appears to contain a ${exprCheck.type} (${result.slug}). ` +
-                `The CLI cannot evaluate dynamic values. ` +
-                `Use a static string value instead.`
-            );
-            result.slug = null;
-        }
-    } else {
-        const slugFallbackMatch = cleanContent.match(/(?:slug|appSlug|app_slug)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
-        if (slugFallbackMatch) {
-            result.slug = slugFallbackMatch[1];
-        }
-    }
-
-    // Extract appName (various patterns)
-    // appName: "Dashboard App", app_name: "Dashboard", name: "Dashboard"
-    // Also handles: appName: env.appName || "fallback"
-    const appNameMatch = cleanContent.match(/(?:appName|app_name)\s*:\s*["'`]([^"'`]+)["'`]/);
-    if (appNameMatch) {
-        result.appName = appNameMatch[1];
-
-        // Check for template literal expressions
-        const exprCheck = detectExpression(result.appName);
-        if (exprCheck.isExpression) {
-            result.warnings.push(
-                `appName appears to contain a ${exprCheck.type} (${result.appName}). ` +
-                `The CLI cannot evaluate dynamic values. ` +
-                `Use a static string value instead.`
-            );
-            result.appName = null;
-        }
-    } else {
-        const appNameFallbackMatch = cleanContent.match(/(?:appName|app_name)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
-        if (appNameFallbackMatch) {
-            result.appName = appNameFallbackMatch[1];
-        }
-    }
-
-    // Extract appDescription (optional)
-    // appDescription: "Description text"
-    const appDescriptionMatch = cleanContent.match(/(?:appDescription|app_description)\s*:\s*["'`]([^"'`]*)["'`]/);
-    if (appDescriptionMatch) {
-        result.appDescription = appDescriptionMatch[1];
-    }
-
-    // Extract appIconId (optional)
-    // appIconId: "icon-id-here"
-    const appIconIdMatch = cleanContent.match(/(?:appIconId|app_icon_id)\s*:\s*["'`]([^"'`]*)["'`]/);
-    if (appIconIdMatch) {
-        result.appIconId = appIconIdMatch[1];
-    }
-
-    // Extract siteUrl (various patterns)
-    // siteUrl: "https://...", site_url: "https://...", baseUrl: "https://..."
-    // Also handles: siteUrl: env.siteUrl || "https://..."
-    const siteUrlMatch = cleanContent.match(/(?:siteUrl|site_url|baseUrl|base_url)\s*:\s*["'`]([^"'`]+)["'`]/);
-    if (siteUrlMatch) {
-        result.siteUrl = siteUrlMatch[1];
-    } else {
-        // Try to match fallback pattern: siteUrl: env.x || "fallback"
-        const siteUrlFallbackMatch = cleanContent.match(/(?:siteUrl|site_url|baseUrl|base_url)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
-        if (siteUrlFallbackMatch) {
-            result.siteUrl = siteUrlFallbackMatch[1];
-        }
-    }
-
-    // Extract assets array
-    // assets: ["url1", "url2"]
-    const assetsMatch = cleanContent.match(/assets\s*:\s*\[([\s\S]*?)\]/);
-    if (assetsMatch) {
-        const assetsContent = assetsMatch[1];
-        // Extract all quoted strings from the array
-        const urlMatches = assetsContent.matchAll(/["'`]([^"'`]+)["'`]/g);
-        for (const match of urlMatches) {
-            result.assets.push(match[1]);
-        }
-    }
-
-    return result;
-}
-
-/**
- * Read Vue project configuration.
- *
- * Reads from multiple sources:
- * - slug, appName, appDescription, appIconId: from config.ts only
- * - siteUrl, assets, refreshToken: from .env.development only (no fallback)
- *
- * @param {string} projectPath - Path to the Vue project
- * @returns {{
- *   found: boolean,
- *   configPath: string | null,
- *   slug: string | null,
- *   appName: string | null,
- *   appDescription: string | null,
- *   appIconId: string | null,
- *   siteUrl: string | null,
- *   assets: string[],
- *   refreshToken: string | null,
- *   envFileUsed: string | null,
- *   errors: string[],
- *   warnings: string[]
- * }}
- */
-export function readVueConfig(projectPath) {
-    const result = {
-        found: false,
-        configPath: null,
-        slug: null,
-        appName: null,
-        appDescription: null,
-        appIconId: null,
-        siteUrl: null,
-        assets: [],
-        refreshToken: null,
-        envFileUsed: null,
-        errors: [],
-        warnings: []
-    };
-
-    const configPath = findConfigFile(projectPath);
-    if (!configPath) {
-        result.errors.push(`No config.ts found in ${projectPath}`);
-        result.errors.push(`Searched locations: ${CONFIG_LOCATIONS.join(', ')}`);
-        return result;
-    }
-
-    result.found = true;
-    result.configPath = configPath;
-
-    // Parse config.ts for slug, appName, appDescription, appIconId (always from config.ts)
-    const parsed = parseConfigFile(configPath);
-
-    // Merge warnings from parsing
-    if (parsed.warnings?.length > 0) {
-        result.warnings.push(...parsed.warnings);
-    }
-
-    result.slug = parsed.slug;
-    result.appName = parsed.appName;
-    result.appDescription = parsed.appDescription;
-    result.appIconId = parsed.appIconId;
-
-    // Validate slug format if present
-    if (result.slug) {
-        const slugValidation = validateSlug(result.slug);
-        if (!slugValidation.valid) {
-            result.errors.push(`Invalid slug format: ${slugValidation.error}`);
-            if (slugValidation.suggestion) {
-                result.warnings.push(`  Suggestion: Use "${slugValidation.suggestion}" instead`);
-            }
-            // Keep the slug for reference but mark as invalid
-        }
-    }
-
-    // Validate appName if present
-    if (result.appName) {
-        const appNameValidation = validateAppName(result.appName);
-        if (!appNameValidation.valid) {
-            result.errors.push(`Invalid appName: ${appNameValidation.error}`);
-        }
-    }
-
-    // Read .env.development for siteUrl, assets, and refreshToken (no fallback to config.ts)
-    const envConfig = readEnvConfig(projectPath);
-    result.envFileUsed = envConfig.envFileUsed;
-    result.siteUrl = envConfig.siteUrl;
-    result.assets = envConfig.assets;
-    result.refreshToken = envConfig.refreshToken;
-
-    // Merge env config errors and warnings
-    if (envConfig.errors?.length > 0) {
-        result.errors.push(...envConfig.errors);
-    }
-    if (envConfig.warnings?.length > 0) {
-        result.warnings.push(...envConfig.warnings);
-    }
-
-    // Validate required fields in config.ts
-    if (!result.slug) {
-        result.errors.push('Missing required field in config.ts: slug (appSlug)');
-    }
-    if (!result.appName) {
-        result.errors.push('Missing required field in config.ts: appName');
-    }
-
-    // Warnings for missing .env.development values
-    if (!envConfig.envFileUsed) {
-        result.warnings.push('No .env.development file found');
-    } else {
-        if (!result.siteUrl && !result.errors.some(e => e.includes('VITE_SITE_URL'))) {
-            result.warnings.push('VITE_SITE_URL not set in .env.development');
-        }
-    }
-
-    return result;
-}
-
-/**
- * Create a backup of a file.
- *
- * @param {string} filePath - Path to the file to backup
- * @returns {string} - Path to the backup file
- */
-export function backupFile(filePath) {
-    const backupPath = `${filePath}.bak`;
-    copyFileSync(filePath, backupPath);
-    return backupPath;
-}
-
-/**
- * Restore a file from backup.
- *
- * @param {string} filePath - Path to the file to restore
- * @returns {boolean} - True if restored, false if backup not found
- */
-export function restoreFile(filePath) {
-    const backupPath = `${filePath}.bak`;
-    if (!existsSync(backupPath)) {
-        return false;
-    }
-    copyFileSync(backupPath, filePath);
-    return true;
-}
-
-/**
- * Determine which file will be used for asset injection.
- * Only .env.development is supported for asset injection.
- *
- * @param {string} projectPath - Path to the Vue project
- * @returns {{targetFile: string | null, targetName: string | null}}
- */
-export function getInjectionTarget(projectPath) {
-    const envPath = join(projectPath, ENV_FILE);
-
-    if (existsSync(envPath)) {
-        return { targetFile: envPath, targetName: '.env.development' };
-    }
-
-    return { targetFile: null, targetName: null };
-}
-
-/**
- * Inject assets into .env.development file.
- * Returns failure if .env.development does not exist.
- *
- * @param {string} projectPath - Path to the Vue project
- * @param {string[]} assets - Array of asset URLs to inject
- * @returns {{success: boolean, targetFile: string | null, targetName: string | null, error: string | null}}
- */
-export function injectAssets(projectPath, assets) {
-    const { targetFile, targetName } = getInjectionTarget(projectPath);
-
-    if (!targetFile) {
-        return { success: false, targetFile: null, targetName: null, error: 'No .env.development file found' };
-    }
-
-    const result = injectAssetsIntoEnv(targetFile, assets);
-    return {
-        success: result.success,
-        targetFile,
-        targetName,
-        error: result.error
-    };
-}
-
-/**
- * Inject assets into a .env file.
- *
- * @param {string} envPath - Path to the .env file
- * @param {string[]} assets - Array of asset URLs to inject
- * @returns {{success: boolean, error: string | null}}
- */
-export function injectAssetsIntoEnv(envPath, assets) {
-    if (!existsSync(envPath)) {
-        return { success: false, error: 'File does not exist' };
-    }
-
-    let content;
-    try {
-        content = readFileSync(envPath, 'utf-8');
-    } catch (err) {
-        const errorType = detectErrorType(err);
-        if (errorType === ErrorTypes.PERMISSION) {
-            return {
-                success: false,
-                error: `Permission denied reading ${envPath}. Check file permissions.`
-            };
-        }
-        return { success: false, error: `Failed to read file: ${err.message}` };
-    }
-
-    // JSON stringify handles escaping properly
-    const assetsJson = JSON.stringify(assets);
-
-    // Escape any single quotes in the JSON to prevent .env parsing issues
-    // This is extra safety - JSON.stringify shouldn't produce single quotes
-    const safeJson = assetsJson.replace(/'/g, "\\'");
-    const newLine = `VITE_ASSETS = '${safeJson}'`;
-
-    // Check if VITE_ASSETS already exists
-    const assetsPattern = /^VITE_ASSETS\s*=.*$/m;
-    if (assetsPattern.test(content)) {
-        // Replace existing VITE_ASSETS line
-        content = content.replace(assetsPattern, newLine);
-    } else {
-        // Add new line at the end
-        content = content.trimEnd() + '\n' + newLine + '\n';
-    }
-
-    try {
-        writeFileSync(envPath, content, 'utf-8');
-    } catch (err) {
-        const errorType = detectErrorType(err);
-        if (errorType === ErrorTypes.PERMISSION) {
-            return {
-                success: false,
-                error: `Permission denied writing to ${envPath}. ` +
-                       `Check file permissions or close any programs using this file.`
-            };
-        }
-        if (errorType === ErrorTypes.DISK_FULL) {
-            return {
-                success: false,
-                error: `Disk full - cannot write to ${envPath}. Free up disk space and try again.`
-            };
-        }
-        return { success: false, error: `Failed to write file: ${err.message}` };
-    }
-
-    return { success: true, error: null };
-}
-
-/**
- * Format missing config error message.
- *
- * @param {string} projectPath - Path to the Vue project
- * @returns {string} - Formatted error message
- */
-export function formatMissingConfigError(projectPath) {
-    return `Missing Configuration
-────────────────────────────────────────────────────
-
-Could not find config.ts in the Vue project.
-
-Expected location: ${join(projectPath, 'src/config.ts')}
-
-Required fields in config.ts:
-  - appSlug (slug): App identifier (used as folder name)
-  - appName: Display name for navigation menu
-
-Required fields in .env.development:
-  - VITE_SITE_URL: Magentrix instance URL
-  - VITE_REFRESH_TOKEN: API refresh token
-  - VITE_ASSETS: Platform assets (managed by CLI)
-
-Example config.ts:
-  export const config = {
-    appSlug: "my-app",
-    appName: "My Application"
-  }
-
-Example .env.development:
-  VITE_SITE_URL = https://yourinstance.magentrix.com
-  VITE_REFRESH_TOKEN = your-api-key
-  VITE_ASSETS = '[]'`;
-}
-
-/**
- * Format config validation errors and warnings.
- *
- * @param {ReturnType<typeof readVueConfig>} config - Config read result
- * @returns {string} - Formatted error message
- */
-export function formatConfigErrors(config) {
-    const lines = [
-        'Invalid Configuration',
-        '────────────────────────────────────────────────────',
-        '',
-        `Config file: ${config.configPath || 'not found'}`,
-    ];
-
-    if (config.envFileUsed) {
-        lines.push(`Env file: ${config.envFileUsed}`);
-    } else {
-        lines.push('Env file: .env.development (not found)');
-    }
-
-    lines.push('');
-
-    if (config.errors.length > 0) {
-        lines.push('Errors:');
-        for (const error of config.errors) {
-            lines.push(`  ✗ ${error}`);
-        }
-        lines.push('');
-    }
-
-    if (config.warnings?.length > 0) {
-        lines.push('Warnings:');
-        for (const warning of config.warnings) {
-            lines.push(`  ⚠ ${warning}`);
-        }
-        lines.push('');
-    }
-
-    lines.push('Current values:');
-    lines.push(`  slug: ${config.slug || '(missing)'}`);
-    lines.push(`  appName: ${config.appName || '(missing)'}`);
-    lines.push(`  siteUrl: ${config.siteUrl || '(not set)'}`);
-
-    return lines.join('\n');
-}
+import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { validateSlug, validateUrl, validateAppName, detectExpression, MAX_LENGTHS } from './validation.js';
+import { formatError, detectErrorType, ErrorTypes } from './errors.js';
+
+/**
+ * Common locations where config.ts might be found in a Vue project.
+ */
+const CONFIG_LOCATIONS = [
+    'src/config.ts',
+    'config.ts',
+    'src/iris-config.ts',
+    'iris-config.ts'
+];
+
+/**
+ * The .env file to read configuration from.
+ * Currently only .env.development is supported.
+ */
+const ENV_FILE = '.env.development';
+
+/**
+ * Maximum size of assets array before warning.
+ */
+const MAX_ASSETS_WARNING_THRESHOLD = 500;
+
+/**
+ * Parse a .env file and return key-value pairs.
+ *
+ * @param {string} envPath - Path to the .env file
+ * @returns {Record<string, string>} - Parsed environment variables
+ */
+function parseEnvFile(envPath) {
+    const result = {};
+
+    if (!existsSync(envPath)) {
+        return result;
+    }
+
+    const content = readFileSync(envPath, 'utf-8');
+    const lines = content.split('\n');
+
+    for (const line of lines) {
+        // Skip comments and empty lines
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+
+        // Parse KEY=VALUE or KEY = VALUE
+        const match = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
+        if (match) {
+            const key = match[1];
+            let value = match[2].trim();
+
+            // Remove surrounding quotes if present
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+
+            result[key] = value;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Read configuration from .env.development file.
+ * Reads siteUrl, assets, and refreshToken.
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @returns {{
+ *   siteUrl: string | null,
+ *   assets: string[],
+ *   refreshToken: string | null,
+ *   envFileUsed: string | null,
+ *   warnings: string[],
+ *   errors: string[]
+ * }}
+ */
+export function readEnvConfig(projectPath) {
+    const result = {
+        siteUrl: null,
+        assets: [],
+        refreshToken: null,
+        envFileUsed: null,
+        warnings: [],
+        errors: []
+    };
+
+    const envPath = join(projectPath, ENV_FILE);
+
+    if (!existsSync(envPath)) {
+        return result;
+    }
+
+    let envVars;
+    try {
+        envVars = parseEnvFile(envPath);
+    } catch (err) {
+        result.errors.push(`Failed to read ${ENV_FILE}: ${err.message}`);
+        return result;
+    }
+
+    result.envFileUsed = ENV_FILE;
+
+    // Read and validate VITE_SITE_URL
+    if (envVars.VITE_SITE_URL) {
+        const urlValue = envVars.VITE_SITE_URL;
+        const urlValidation = validateUrl(urlValue);
+
+        if (!urlValidation.valid) {
+            result.errors.push(`VITE_SITE_URL is invalid: ${urlValidation.error}`);
+            if (urlValidation.suggestion) {
+                result.warnings.push(`  Suggestion: ${urlValidation.suggestion}`);
+            }
+        } else {
+            result.siteUrl = urlValidation.normalized || urlValue;
+        }
+    }
+
+    // Read VITE_ASSETS with better error handling
+    if (envVars.VITE_ASSETS) {
+        try {
+            const parsed = JSON.parse(envVars.VITE_ASSETS);
+            if (Array.isArray(parsed)) {
+                result.assets = parsed;
+
+                // Warn if assets array is very large
+                if (parsed.length > MAX_ASSETS_WARNING_THRESHOLD) {
+                    result.warnings.push(
+                        `VITE_ASSETS contains ${parsed.length} items. ` +
+                        `Large arrays may cause performance issues.`
+                    );
+                }
+            } else {
+                result.warnings.push('VITE_ASSETS is not an array, ignoring');
+            }
+        } catch (err) {
+            // Provide helpful error for JSON parsing issues
+            if (envVars.VITE_ASSETS.includes("'") && !envVars.VITE_ASSETS.includes('"')) {
+                result.errors.push(
+                    'VITE_ASSETS contains invalid JSON. ' +
+                    'JSON requires double quotes for strings, not single quotes. ' +
+                    'Example: VITE_ASSETS = \'["url1", "url2"]\''
+                );
+            } else {
+                result.errors.push(`VITE_ASSETS contains invalid JSON: ${err.message}`);
+            }
+        }
+    }
+
+    // Read VITE_REFRESH_TOKEN
+    if (envVars.VITE_REFRESH_TOKEN) {
+        result.refreshToken = envVars.VITE_REFRESH_TOKEN;
+    }
+
+    return result;
+}
+
+/**
+ * Find the config.ts file in a Vue project.
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @returns {string | null} - Path to config.ts or null if not found
+ */
+export function findConfigFile(projectPath) {
+    for (const location of CONFIG_LOCATIONS) {
+        const fullPath = join(projectPath, location);
+        if (existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+
+/**
+ * Strip comments from config file content to prevent parsing issues.
+ * Removes both single-line (//) and multi-line comments.
+ *
+ * @param {string} content - Raw config file content
+ * @returns {string} - Content with comments removed
+ */
+function stripComments(content) {
+    // Remove single-line comments (but not URLs with //)
+    // Match // that's not preceded by : (to avoid breaking URLs)
+    let result = content.replace(/(?<!:)\/\/.*$/gm, '');
+
+    // Remove multi-line comments
+    result = result.replace(/\/\*[\s\S]*?\*\//g, '');
+
+    return result;
+}
+
+/**
+ * Parse a config.ts file and extract Iris configuration.
+ * Uses regex parsing to avoid TypeScript compilation.
+ *
+ * @param {string} configPath - Path to the config.ts file
+ * @returns {{
+ *   slug: string | null,
+ *   appName: string | null,
+ *   appDescription: string | null,
+ *   appIconId: string | null,
+ *   siteUrl: string | null,
+ *   assets: string[],
+ *   raw: string,
+ *   warnings: string[]
+ * }}
+ */
+export function parseConfigFile(configPath) {
+    const result = {
+        slug: null,
+        appName: null,
+        appDescription: null,
+        appIconId: null,
+        siteUrl: null,
+        assets: [],
+        raw: '',
+        warnings: []
+    };
+
+    if (!existsSync(configPath)) {
+        return result;
+    }
+
+    let content;
+    try {
+        content = readFileSync(configPath, 'utf-8');
+    } catch (err) {
+        result.warnings.push(`Failed to read config file: ${err.message}`);
+        return result;
+    }
+
+    result.raw = content;
+
+    // Strip comments before parsing to avoid regex issues
+    const cleanContent = stripComments(content);
+
+    // Extract slug (various patterns)
+    // slug: "dashboard", appSlug: "dashboard", app_slug: "dashboard"
+    // Also handles: slug: env.slug || "fallback"
+    const slugMatch = cleanContent.match(/(?:slug|appSlug|app_slug)\s*:\s*["'`]([^"'`]+)["'`]/);
+    if (slugMatch) {
+        result.slug = slugMatch[1];
+
+        // Check for template literal expressions
+        const exprCheck = detectExpression(result.slug);
+        if (exprCheck.isExpression) {
+            result.warnings.push(
+                `slug appears to contain a ${exprCheck.type} (${result.slug}). ` +
+                `The CLI cannot evaluate dynamic values. ` +
+                `Use a static string value instead.`
+            );
+            result.slug = null;
+        }
+    } else {
+        const slugFallbackMatch = cleanContent.match(/(?:slug|appSlug|app_slug)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
+        if (slugFallbackMatch) {
+            result.slug = slugFallbackMatch[1];
+        }
+    }
+
+    // Extract appName (various patterns)
+    // appName: "Dashboard App", app_name: "Dashboard", name: "Dashboard"
+    // Also handles: appName: env.appName || "fallback"
+    const appNameMatch = cleanContent.match(/(?:appName|app_name)\s*:\s*["'`]([^"'`]+)["'`]/);
+    if (appNameMatch) {
+        result.appName = appNameMatch[1];
+
+        // Check for template literal expressions
+        const exprCheck = detectExpression(result.appName);
+        if (exprCheck.isExpression) {
+            result.warnings.push(
+                `appName appears to contain a ${exprCheck.type} (${result.appName}). ` +
+                `The CLI cannot evaluate dynamic values. ` +
+                `Use a static string value instead.`
+            );
+            result.appName = null;
+        }
+    } else {
+        const appNameFallbackMatch = cleanContent.match(/(?:appName|app_name)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
+        if (appNameFallbackMatch) {
+            result.appName = appNameFallbackMatch[1];
+        }
+    }
+
+    // Extract appDescription (optional)
+    // appDescription: "Description text"
+    const appDescriptionMatch = cleanContent.match(/(?:appDescription|app_description)\s*:\s*["'`]([^"'`]*)["'`]/);
+    if (appDescriptionMatch) {
+        result.appDescription = appDescriptionMatch[1];
+    }
+
+    // Extract appIconId (optional)
+    // appIconId: "icon-id-here"
+    const appIconIdMatch = cleanContent.match(/(?:appIconId|app_icon_id)\s*:\s*["'`]([^"'`]*)["'`]/);
+    if (appIconIdMatch) {
+        result.appIconId = appIconIdMatch[1];
+    }
+
+    // Extract siteUrl (various patterns)
+    // siteUrl: "https://...", site_url: "https://...", baseUrl: "https://..."
+    // Also handles: siteUrl: env.siteUrl || "https://..."
+    const siteUrlMatch = cleanContent.match(/(?:siteUrl|site_url|baseUrl|base_url)\s*:\s*["'`]([^"'`]+)["'`]/);
+    if (siteUrlMatch) {
+        result.siteUrl = siteUrlMatch[1];
+    } else {
+        // Try to match fallback pattern: siteUrl: env.x || "fallback"
+        const siteUrlFallbackMatch = cleanContent.match(/(?:siteUrl|site_url|baseUrl|base_url)\s*:\s*[^,\n]+\|\|\s*["'`]([^"'`]+)["'`]/);
+        if (siteUrlFallbackMatch) {
+            result.siteUrl = siteUrlFallbackMatch[1];
+        }
+    }
+
+    // Extract assets array
+    // assets: ["url1", "url2"]
+    const assetsMatch = cleanContent.match(/assets\s*:\s*\[([\s\S]*?)\]/);
+    if (assetsMatch) {
+        const assetsContent = assetsMatch[1];
+        // Extract all quoted strings from the array
+        const urlMatches = assetsContent.matchAll(/["'`]([^"'`]+)["'`]/g);
+        for (const match of urlMatches) {
+            result.assets.push(match[1]);
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Read Vue project configuration.
+ *
+ * Reads from multiple sources:
+ * - slug, appName, appDescription, appIconId: from config.ts only
+ * - siteUrl, assets, refreshToken: from .env.development only (no fallback)
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @returns {{
+ *   found: boolean,
+ *   configPath: string | null,
+ *   slug: string | null,
+ *   appName: string | null,
+ *   appDescription: string | null,
+ *   appIconId: string | null,
+ *   siteUrl: string | null,
+ *   assets: string[],
+ *   refreshToken: string | null,
+ *   envFileUsed: string | null,
+ *   errors: string[],
+ *   warnings: string[]
+ * }}
+ */
+export function readVueConfig(projectPath) {
+    const result = {
+        found: false,
+        configPath: null,
+        slug: null,
+        appName: null,
+        appDescription: null,
+        appIconId: null,
+        siteUrl: null,
+        assets: [],
+        refreshToken: null,
+        envFileUsed: null,
+        errors: [],
+        warnings: []
+    };
+
+    const configPath = findConfigFile(projectPath);
+    if (!configPath) {
+        result.errors.push(`No config.ts found in ${projectPath}`);
+        result.errors.push(`Searched locations: ${CONFIG_LOCATIONS.join(', ')}`);
+        return result;
+    }
+
+    result.found = true;
+    result.configPath = configPath;
+
+    // Parse config.ts for slug, appName, appDescription, appIconId (always from config.ts)
+    const parsed = parseConfigFile(configPath);
+
+    // Merge warnings from parsing
+    if (parsed.warnings?.length > 0) {
+        result.warnings.push(...parsed.warnings);
+    }
+
+    result.slug = parsed.slug;
+    result.appName = parsed.appName;
+    result.appDescription = parsed.appDescription;
+    result.appIconId = parsed.appIconId;
+
+    // Validate slug format if present
+    if (result.slug) {
+        const slugValidation = validateSlug(result.slug);
+        if (!slugValidation.valid) {
+            result.errors.push(`Invalid slug format: ${slugValidation.error}`);
+            if (slugValidation.suggestion) {
+                result.warnings.push(`  Suggestion: Use "${slugValidation.suggestion}" instead`);
+            }
+            // Keep the slug for reference but mark as invalid
+        }
+    }
+
+    // Validate appName if present
+    if (result.appName) {
+        const appNameValidation = validateAppName(result.appName);
+        if (!appNameValidation.valid) {
+            result.errors.push(`Invalid appName: ${appNameValidation.error}`);
+        }
+    }
+
+    // Read .env.development for siteUrl, assets, and refreshToken (no fallback to config.ts)
+    const envConfig = readEnvConfig(projectPath);
+    result.envFileUsed = envConfig.envFileUsed;
+    result.siteUrl = envConfig.siteUrl;
+    result.assets = envConfig.assets;
+    result.refreshToken = envConfig.refreshToken;
+
+    // Merge env config errors and warnings
+    if (envConfig.errors?.length > 0) {
+        result.errors.push(...envConfig.errors);
+    }
+    if (envConfig.warnings?.length > 0) {
+        result.warnings.push(...envConfig.warnings);
+    }
+
+    // Validate required fields in config.ts
+    if (!result.slug) {
+        result.errors.push('Missing required field in config.ts: slug (appSlug)');
+    }
+    if (!result.appName) {
+        result.errors.push('Missing required field in config.ts: appName');
+    }
+
+    // Warnings for missing .env.development values
+    if (!envConfig.envFileUsed) {
+        result.warnings.push('No .env.development file found');
+    } else {
+        if (!result.siteUrl && !result.errors.some(e => e.includes('VITE_SITE_URL'))) {
+            result.warnings.push('VITE_SITE_URL not set in .env.development');
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Create a backup of a file.
+ *
+ * @param {string} filePath - Path to the file to backup
+ * @returns {string} - Path to the backup file
+ */
+export function backupFile(filePath) {
+    const backupPath = `${filePath}.bak`;
+    copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+
+/**
+ * Restore a file from backup.
+ *
+ * @param {string} filePath - Path to the file to restore
+ * @returns {boolean} - True if restored, false if backup not found
+ */
+export function restoreFile(filePath) {
+    const backupPath = `${filePath}.bak`;
+    if (!existsSync(backupPath)) {
+        return false;
+    }
+    copyFileSync(backupPath, filePath);
+    return true;
+}
+
+/**
+ * Determine which file will be used for asset injection.
+ * Only .env.development is supported for asset injection.
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @returns {{targetFile: string | null, targetName: string | null}}
+ */
+export function getInjectionTarget(projectPath) {
+    const envPath = join(projectPath, ENV_FILE);
+
+    if (existsSync(envPath)) {
+        return { targetFile: envPath, targetName: '.env.development' };
+    }
+
+    return { targetFile: null, targetName: null };
+}
+
+/**
+ * Inject assets into .env.development file.
+ * Returns failure if .env.development does not exist.
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @param {string[]} assets - Array of asset URLs to inject
+ * @returns {{success: boolean, targetFile: string | null, targetName: string | null, error: string | null}}
+ */
+export function injectAssets(projectPath, assets) {
+    const { targetFile, targetName } = getInjectionTarget(projectPath);
+
+    if (!targetFile) {
+        return { success: false, targetFile: null, targetName: null, error: 'No .env.development file found' };
+    }
+
+    const result = injectAssetsIntoEnv(targetFile, assets);
+    return {
+        success: result.success,
+        targetFile,
+        targetName,
+        error: result.error
+    };
+}
+
+/**
+ * Inject assets into a .env file.
+ *
+ * @param {string} envPath - Path to the .env file
+ * @param {string[]} assets - Array of asset URLs to inject
+ * @returns {{success: boolean, error: string | null}}
+ */
+export function injectAssetsIntoEnv(envPath, assets) {
+    if (!existsSync(envPath)) {
+        return { success: false, error: 'File does not exist' };
+    }
+
+    let content;
+    try {
+        content = readFileSync(envPath, 'utf-8');
+    } catch (err) {
+        const errorType = detectErrorType(err);
+        if (errorType === ErrorTypes.PERMISSION) {
+            return {
+                success: false,
+                error: `Permission denied reading ${envPath}. Check file permissions.`
+            };
+        }
+        return { success: false, error: `Failed to read file: ${err.message}` };
+    }
+
+    // JSON stringify handles escaping properly
+    const assetsJson = JSON.stringify(assets);
+
+    // Escape any single quotes in the JSON to prevent .env parsing issues
+    // This is extra safety - JSON.stringify shouldn't produce single quotes
+    const safeJson = assetsJson.replace(/'/g, "\\'");
+    const newLine = `VITE_ASSETS = '${safeJson}'`;
+
+    // Check if VITE_ASSETS already exists
+    const assetsPattern = /^VITE_ASSETS\s*=.*$/m;
+    if (assetsPattern.test(content)) {
+        // Replace existing VITE_ASSETS line
+        content = content.replace(assetsPattern, newLine);
+    } else {
+        // Add new line at the end
+        content = content.trimEnd() + '\n' + newLine + '\n';
+    }
+
+    try {
+        writeFileSync(envPath, content, 'utf-8');
+    } catch (err) {
+        const errorType = detectErrorType(err);
+        if (errorType === ErrorTypes.PERMISSION) {
+            return {
+                success: false,
+                error: `Permission denied writing to ${envPath}. ` +
+                       `Check file permissions or close any programs using this file.`
+            };
+        }
+        if (errorType === ErrorTypes.DISK_FULL) {
+            return {
+                success: false,
+                error: `Disk full - cannot write to ${envPath}. Free up disk space and try again.`
+            };
+        }
+        return { success: false, error: `Failed to write file: ${err.message}` };
+    }
+
+    return { success: true, error: null };
+}
+
+/**
+ * Format missing config error message.
+ *
+ * @param {string} projectPath - Path to the Vue project
+ * @returns {string} - Formatted error message
+ */
+export function formatMissingConfigError(projectPath) {
+    return `Missing Configuration
+────────────────────────────────────────────────────
+
+Could not find config.ts in the Vue project.
+
+Expected location: ${join(projectPath, 'src/config.ts')}
+
+Required fields in config.ts:
+  - appSlug (slug): App identifier (used as folder name)
+  - appName: Display name for navigation menu
+
+Required fields in .env.development:
+  - VITE_SITE_URL: Magentrix instance URL
+  - VITE_REFRESH_TOKEN: API refresh token
+  - VITE_ASSETS: Platform assets (managed by CLI)
+
+Example config.ts:
+  export const config = {
+    appSlug: "my-app",
+    appName: "My Application"
+  }
+
+Example .env.development:
+  VITE_SITE_URL = https://yourinstance.magentrix.com
+  VITE_REFRESH_TOKEN = your-api-key
+  VITE_ASSETS = '[]'`;
+}
+
+/**
+ * Format config validation errors and warnings.
+ *
+ * @param {ReturnType<typeof readVueConfig>} config - Config read result
+ * @returns {string} - Formatted error message
+ */
+export function formatConfigErrors(config) {
+    const lines = [
+        'Invalid Configuration',
+        '────────────────────────────────────────────────────',
+        '',
+        `Config file: ${config.configPath || 'not found'}`,
+    ];
+
+    if (config.envFileUsed) {
+        lines.push(`Env file: ${config.envFileUsed}`);
+    } else {
+        lines.push('Env file: .env.development (not found)');
+    }
+
+    lines.push('');
+
+    if (config.errors.length > 0) {
+        lines.push('Errors:');
+        for (const error of config.errors) {
+            lines.push(`  ✗ ${error}`);
+        }
+        lines.push('');
+    }
+
+    if (config.warnings?.length > 0) {
+        lines.push('Warnings:');
+        for (const warning of config.warnings) {
+            lines.push(`  ⚠ ${warning}`);
+        }
+        lines.push('');
+    }
+
+    lines.push('Current values:');
+    lines.push(`  slug: ${config.slug || '(missing)'}`);
+    lines.push(`  appName: ${config.appName || '(missing)'}`);
+    lines.push(`  siteUrl: ${config.siteUrl || '(not set)'}`);
+
+    return lines.join('\n');
+}