@aravinthan_p/appnest-engine 1.0.21 → 1.0.22

package/appnest-command-line/validateUtils/manifestUtils.js

@@ -3,160 +3,399 @@
 const fs = require('fs');
 const path = require('path');
 
-const REQUIRED_KEYS = [
-    'platform-version',
-    'parentProduct',
-    'location',
-    'whitelistedDomains',
-    'productEvents',
-    'apiFunctions',
-    'customInstallationFrontend',
-    'installationParams',
-    'oauth',
-];
-
-const INSTALLATION_PARAM_TYPES = ['string', 'number', 'boolean', 'object', 'array'];
 
-/**
- * Validates manifest.json in the current working directory.
- * Returns { valid: true, manifest } on success, or { valid: false, errors } on failure.
- */
-const validateManifestFile = () => {
-    const userDir = process.cwd();
-    const manifestPath = path.join(userDir, 'manifest.json');
-    const errors = [];
-
-    if (!fs.existsSync(manifestPath)) {
-        return { valid: false, errors: [`manifest.json not found in ${userDir}`] };
+const validateInstallationParameters = (installation_parameters) => {
+    const INSTALLATION_PARAM_TYPES = ['string', 'api_key'];
+    if (!installation_parameters || typeof installation_parameters !== 'object' || installation_parameters === null || Array.isArray(installation_parameters)) {
+        return { valid: false, errors: ['installation_parameters must be a key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(installation_parameters)) {
+        if (typeof value !== 'object' || value === null) {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object`] };
+        }
+        if(value.display_name != null && typeof value.display_name !== 'string') {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object with "display_name" string`] };
+        }
+        if(value.description != null && typeof value.description !== 'string') {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object with "description" string`] };
+        }
+        if(value.required != null && typeof value.required !== 'boolean') {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object with "required" boolean`] };
+        }
+        if(value.secure != null && typeof value.secure !== 'boolean') {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object with "secure" boolean`] };
+        }
+        if(value.type != null && !INSTALLATION_PARAM_TYPES.includes(value.type)) {
+            return { valid: false, errors: [`installation_parameters["${name}"] must be an object with "type" one of: ${INSTALLATION_PARAM_TYPES.join(', ')}`] };
+        }
     }
+    return { valid: true, installation_parameters };
+}
 
-    let manifest;
-    try {
-        const raw = fs.readFileSync(manifestPath, 'utf8');
-        manifest = JSON.parse(raw);
-    } catch (e) {
-        return { valid: false, errors: [`manifest.json is invalid JSON: ${e.message}`] };
+const validateAppOauthConfig = (app_oauth_config) => {
+    console.log('🔍 Validating app oauth config:', app_oauth_config);
+    if (typeof app_oauth_config !== 'object' || app_oauth_config === null || Array.isArray(app_oauth_config)) {
+        return { valid: false, errors: ['app_oauth_config must be a key-value map (object)'] };
     }
+    //find the length of the object if greater then 1 then return error
+    if (Object.keys(app_oauth_config).length > 1) {
+        return { valid: false, errors: ['app_oauth_config must be a single key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(app_oauth_config)) {
+        if (typeof value !== 'object' || value === null) {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object`] };
+        }
+        if(value.client_id != null && typeof value.client_id !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "client_id" string`] };
+        }
+        if(value.client_secret != null && typeof value.client_secret !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "client_secret" string`] };
+        }
+        if(value.authorize_url != null && typeof value.authorize_url !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "authorize_url" string`] };
+        }
+        if(value.token_url != null && typeof value.token_url !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "token_url" string`] };
+        }
+        if(value.options != null && typeof value.options !== 'object') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "options" object`] };
+        }
+        if(value.options.response_type != null && typeof value.options.response_type !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "options" object with "response_type" string`] };
+        }
+        if(value.options.access_type != null && typeof value.options.access_type !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "options" object with "access_type" string`] };
+        }
+        if(value.options.prompt != null && typeof value.options.prompt !== 'string') {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "options" object with "prompt" string`] };
+        }
+        if(value.options.scopes != null && (!Array.isArray(value.options.scopes) || value.options.scopes.some((s) => typeof s !== 'string'))) {
+            return { valid: false, errors: [`app_oauth_config["${name}"] must be an object with "options" object with "scopes" array of strings`] };
+        }
+    }
+    return { valid: true, app_oauth_config };
+}
 
-    if (typeof manifest !== 'object' || manifest === null) {
-        return { valid: false, errors: ['manifest.json must be a JSON object'] };
+const validateWhitelistedDomains = (whitelisted_domains) => {
+    console.log('🔍 Validating whitelisted domains:', whitelisted_domains);
+    if (!Array.isArray(whitelisted_domains)) {
+        return { valid: false, errors: ['whitelisted_domains must be an array of strings'] };
     }
+    for (const domain of whitelisted_domains) {
+        if (typeof domain !== 'string') {
+            return { valid: false, errors: ['whitelisted_domains must contain only strings'] };
+        }
+    }
+    return { valid: true, whitelisted_domains };
+}
 
-    console.log('🔍 Validating manifest.json...');
-    console.log('🔍 Manifest:', manifest);
+const validateConfiguredFunctions = ({event_listener_functions, backend_api_functions}) => {
+    const exported_functions = getAppBackendServerExportFunctionNames();
+    console.log('🔍 Exported functions:', exported_functions);
+    const configuredFunctions = [...Object.keys(event_listener_functions), ...Object.keys(backend_api_functions)];
+    console.log('🔍 Configured functions:', configuredFunctions);
+    const missingFunctions = configuredFunctions.filter((func) => !exported_functions.includes(func));
+    if(missingFunctions.length > 0) {
+        console.error('❌ Missing exported functions in app-backend/server.js but configured in manifest.json:', missingFunctions);
+        return { valid: false, errors: [`Missing exported functions in app-backend/server.js but configured in manifest.json: ${missingFunctions.join(', ')}`] };
+    }
+    return { valid: true, configuredFunctions };
+}
 
-    for (const key of REQUIRED_KEYS) {
-        if (!(key in manifest)) {
-            errors.push(`Missing required key: "${key}"`);
+const validateEventListenerFunctions = (event_listener_functions) => {
+    console.log('🔍 Validating event listener functions:', event_listener_functions);
+    if (!event_listener_functions || typeof event_listener_functions !== 'object' || event_listener_functions === null || Array.isArray(event_listener_functions)) {
+        return { valid: false, errors: ['event_listener_functions must be a key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(event_listener_functions)) {
+        if(name != null && typeof name !== 'string') {
+            return { valid: false, errors: [`event_listener_functions["${name}"] must be an object with "name" string`] };
+        }
+        if (typeof value !== 'object' || value === null) {
+            return { valid: false, errors: [`event_listener_functions["${name}"] must be an object`] };
+        }
+        if(value.handler != null && typeof value.handler !== 'string') {
+            return { valid: false, errors: [`event_listener_functions["${name}"] must be an object with "handler" string`] };
+        }
+        if(value.handler == name) {
+            return { valid: false, errors: [`event_listener_functions["${name}"] must be an object with "handler" string not equal to "name"`] };
         }
     }
+    return { valid: true, event_listener_functions };
+}
 
-    if (manifest.parentProduct != null) {
-        if (typeof manifest.parentProduct !== 'string' || !manifest.parentProduct.trim()) {
-            errors.push('parentProduct must be a non-empty string (name)');
+const validateBackendApiFunctions = (backend_api_functions) => {
+    console.log('🔍 Validating backend api functions:', backend_api_functions);
+    if (!backend_api_functions || typeof backend_api_functions !== 'object' || backend_api_functions === null || Array.isArray(backend_api_functions)) {
+        return { valid: false, errors: ['backend_api_functions must be a key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(backend_api_functions)) {
+        if (typeof value !== 'object' || value === null) {
+            return { valid: false, errors: [`backend_api_functions["${name}"] must be an object`] };
+        }
+        if(value.timeout != null && typeof value.timeout !== 'number') {
+            return { valid: false, errors: [`backend_api_functions["${name}"] must be an object with "timeout" number`] };
         }
     }
+    return { valid: true, backend_api_functions };
+}
 
-    if (manifest.location != null) {
-        if (typeof manifest.location !== 'object' || manifest.location === null || Array.isArray(manifest.location)) {
-            errors.push('location must be a key-value map (object)');
-        } else {
-            for (const [name, value] of Object.entries(manifest.location)) {
-                if (typeof value !== 'object' || value === null || typeof value.url !== 'string') {
-                    errors.push(`location["${name}"] must be an object with "url" string`);
-                }
-            }
+
+const validateFrontendLocations = (frontend_locations) => {
+    console.log('🔍 Validating frontend locations:', frontend_locations);
+    if (!frontend_locations || typeof frontend_locations !== 'object' || frontend_locations === null || Array.isArray(frontend_locations)) {
+        return { valid: false, errors: ['frontend_locations must be a key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(frontend_locations)) {
+        if(name != null && typeof name !== 'string') {
+            return { valid: false, errors: [`frontend_locations["${name}"] must be an object with "name" string`] };
+        }
+        if (typeof value !== 'object' || value === null) {
+            return { valid: false, errors: [`frontend_locations["${name}"] must be an object`] };
+        }
+        if(value.url != null && typeof value.url !== 'string') {
+            return { valid: false, errors: [`frontend_locations["${name}"] must be an object with "url" string`] };
+        }
+        if(value.url == 'index.html') {
+            return { valid: false, errors: [`frontend_locations["${name}"] must be an object with "url" string not equal to "index.html"`] };
         }
     }
+    return { valid: true, frontend_locations };
+}
 
-    if (manifest.whitelistedDomains != null) {
-        if (!Array.isArray(manifest.whitelistedDomains)) {
-            errors.push('whitelistedDomains must be an array of strings');
-        } else {
-            const bad = manifest.whitelistedDomains.some((d) => typeof d !== 'string');
-            if (bad) errors.push('whitelistedDomains must contain only strings');
-        }
+
+/** Compare dot-separated numeric semver parts (e.g. "2.10.0" vs "2.9.0"). Not full semver (no prerelease). */
+const semverPartsGte = (version, minimum) => {
+    const toNums = (v) =>
+        v.split('.').map((segment) => {
+            const n = parseInt(segment, 10);
+            return Number.isFinite(n) ? n : NaN;
+        });
+    const a = toNums(version);
+    const b = toNums(minimum);
+    if (a.some((n) => Number.isNaN(n)) || b.some((n) => Number.isNaN(n))) {
+        return null;
+    }
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const ai = a[i] ?? 0;
+        const bi = b[i] ?? 0;
+        if (ai < bi) return false;
+        if (ai > bi) return true;
     }
+    return true;
+};
 
-    if (manifest.productEvents != null) {
-        if (typeof manifest.productEvents !== 'object' || manifest.productEvents === null || Array.isArray(manifest.productEvents)) {
-            errors.push('productEvents must be a key-value map (object)');
-        } else {
-            for (const [name, value] of Object.entries(manifest.productEvents)) {
-                if (typeof value !== 'object' || value === null || typeof value.handler !== 'string') {
-                    errors.push(`productEvents["${name}"] must be an object with "handler" string`);
-                }
-            }
+const validatePlatformVersion = (platform_version) => {
+    console.log('🔍 Validating platform version:', platform_version);
+    if(!platform_version || typeof platform_version !== 'string' || platform_version === null || platform_version === undefined) {
+        return { valid: false, errors: ['platform_version must be a string'] };
+    }
+    const gte = semverPartsGte(platform_version, '2.0.0');
+    if (gte === null) {
+        return { valid: false, errors: ['platform_version must be a semver-like string (e.g. "2.0.0") with numeric segments'] };
+    }
+    if (!gte) {
+        return { valid: false, errors: ['platform_version must be greater than or equal to "2.0.0"'] };
+    }
+    return { valid: true, platform_version };
+}
+
+const validateParentProduct = (parent_product) => {
+    console.log('🔍 Validating parent product:', parent_product);
+    if(!parent_product || typeof parent_product !== 'string' || parent_product === null || parent_product === undefined) {
+        return { valid: false, errors: ['parent_product must be a string'] };
+    }
+    if(parent_product.trim() === '') {
+        return { valid: false, errors: ['parent_product must be a non-empty string'] };
+    }
+    return { valid: true, parent_product };
+}
+
+const validateProductConfig = (product_config) => {
+    console.log('🔍 Validating product config:', product_config);
+    if(!product_config || typeof product_config !== 'object' || product_config === null || Array.isArray(product_config)) {
+        return { valid: false, errors: ['product_config must be a key-value map (object)'] };
+    }
+    if(Object.keys(product_config).length > 1) {
+        return { valid: false, errors: ['product_config must be a single key-value map (object)'] };
+    }
+    for (const [name, value] of Object.entries(product_config)) {
+        if(name != null && typeof name !== 'string') {
+            return { valid: false, errors: [`product_config["${name}"] must be an object with "name" string`] };
         }
+        validateFrontendLocations(value.frontend_locations);
+        validateWhitelistedDomains(value.whitelisted_domains);
+        validateEventListenerFunctions(value.event_listener_functions);
+        validateBackendApiFunctions(value.backend_api_functions);
+        validateInstallationParameters(value.installation_parameters);
+        validateAppOauthConfig(value.app_oauth_config);
+        validateConfiguredFunctions({event_listener_functions: value.event_listener_functions, backend_api_functions: value.backend_api_functions});
+
     }
+}
 
-    if (manifest.apiFunctions != null) {
-        if (typeof manifest.apiFunctions !== 'object' || manifest.apiFunctions === null || Array.isArray(manifest.apiFunctions)) {
-            errors.push('apiFunctions must be a key-value map (object)');
-        } else {
-            for (const [name, value] of Object.entries(manifest.apiFunctions)) {
-                if (typeof value !== 'object' || value === null || typeof value.handler !== 'string') {
-                    errors.push(`apiFunctions["${name}"] must be an object with "handler" string`);
-                }
+
+/**
+ * Split a string on commas that are not inside (), [], {}, or strings.
+ */
+const splitTopLevelCommas = (str) => {
+    const parts = [];
+    let buf = '';
+    let depth = 0;
+    let inString = null;
+    for (let i = 0; i < str.length; i++) {
+        const c = str[i];
+        if (inString) {
+            buf += c;
+            if (c === '\\' && i + 1 < str.length) {
+                buf += str[++i];
+                continue;
             }
+            if (c === inString) inString = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === '`') {
+            inString = c;
+            buf += c;
+            continue;
         }
+        if (c === '{' || c === '(' || c === '[') depth++;
+        else if (c === '}' || c === ')' || c === ']') depth--;
+        if (c === ',' && depth === 0) {
+            parts.push(buf);
+            buf = '';
+            continue;
+        }
+        buf += c;
     }
+    if (buf.trim()) parts.push(buf);
+    return parts;
+};
 
-    if (manifest.customInstallationFrontend != null) {
-        if (typeof manifest.customInstallationFrontend !== 'boolean') {
-            errors.push('customInstallationFrontend must be a boolean');
-        }
-    }
-
-    if (manifest.installationParams != null) {
-        if (typeof manifest.installationParams !== 'object' || manifest.installationParams === null || Array.isArray(manifest.installationParams)) {
-            errors.push('installationParams must be a key-value map (object)');
-        } else {
-            for (const [name, value] of Object.entries(manifest.installationParams)) {
-                if (typeof value !== 'object' || value === null) {
-                    errors.push(`installationParams["${name}"] must be an object`);
-                } else {
-                    if (value.type != null && !INSTALLATION_PARAM_TYPES.includes(value.type)) {
-                        errors.push(`installationParams["${name}"].type must be one of: ${INSTALLATION_PARAM_TYPES.join(', ')}`);
-                    }
-                    if (value.required != null && typeof value.required !== 'boolean') {
-                        errors.push(`installationParams["${name}"].required must be a boolean`);
-                    }
-                    if (value.display_name != null && typeof value.display_name !== 'string') {
-                        errors.push(`installationParams["${name}"].display_name must be a string`);
-                    }
-                    if (value.description != null && typeof value.description !== 'string') {
-                        errors.push(`installationParams["${name}"].description must be a string`);
-                    }
+/**
+ * Extract `module.exports = { ... }` object body (handles strings and nested braces).
+ */
+const extractModuleExportsObjectBody = (content) => {
+    const m = content.match(/module\.exports\s*=\s*\{/);
+    if (!m) return null;
+    let start = m.index + m[0].length;
+    let depth = 1;
+    let i = start;
+    while (i < content.length && depth > 0) {
+        const c = content[i];
+        if (c === '"' || c === "'" || c === '`') {
+            const quote = c;
+            i++;
+            while (i < content.length) {
+                if (content[i] === '\\') {
+                    i += 2;
+                    continue;
+                }
+                if (content[i] === quote) {
+                    i++;
+                    break;
                 }
+                i++;
             }
+            continue;
         }
+        if (c === '{') depth++;
+        else if (c === '}') depth--;
+        i++;
     }
+    if (depth !== 0) return null;
+    return content.slice(start, i - 1);
+};
 
-    if (manifest.oauth != null) {
-        if (typeof manifest.oauth !== 'object' || manifest.oauth === null) {
-            errors.push('oauth must be an object (or empty object {})');
-        } else if (Object.keys(manifest.oauth).length > 0) {
-            const o = manifest.oauth;
-            if (o.client_id != null && typeof o.client_id !== 'string') errors.push('oauth.client_id must be a string');
-            if (o.client_secret != null && typeof o.client_secret !== 'string') errors.push('oauth.client_secret must be a string');
-            if (o.authorize_url != null && typeof o.authorize_url !== 'string') errors.push('oauth.authorize_url must be a string');
-            if (o.token_url != null && typeof o.token_url !== 'string') errors.push('oauth.token_url must be a string');
-            if (o.options != null) {
-                if (typeof o.options !== 'object' || o.options === null) {
-                    errors.push('oauth.options must be an object');
-                } else {
-                    if (o.options.response_type != null && typeof o.options.response_type !== 'string') errors.push('oauth.options.response_type must be a string');
-                    if (o.options.access_type != null && typeof o.options.access_type !== 'string') errors.push('oauth.options.access_type must be a string');
-                    if (o.options.prompt != null && typeof o.options.prompt !== 'string') errors.push('oauth.options.prompt must be a string');
-                    if (o.options.scopes != null && (!Array.isArray(o.options.scopes) || o.options.scopes.some((s) => typeof s !== 'string'))) {
-                        errors.push('oauth.options.scopes must be an array of strings');
-                    }
-                }
-            }
+/**
+ * Returns exported names from `app-backend/server.js` when using
+ * `module.exports = { foo, bar, baz: require(...) }`.
+ * @returns {string[]}
+ */
+const getAppBackendServerExportFunctionNames = () => {
+    const userDir = process.cwd();
+    const appBackendServerFile = path.join(userDir, 'app-backend', 'server.js');
+    if (!fs.existsSync(appBackendServerFile)) {
+        console.warn('⚠️ app-backend/server.js not found');
+        return [];
+    }
+    let content;
+    try {
+        content = fs.readFileSync(appBackendServerFile, 'utf8');
+    } catch (e) {
+        console.warn('⚠️ Could not read server.js:', e.message);
+        return [];
+    }
+
+    const body = extractModuleExportsObjectBody(content);
+    if (body == null) {
+        console.warn('⚠️ No module.exports = { ... } found in server.js');
+        return [];
+    }
+
+    const withoutBlockComments = body.replace(/\/\*[\s\S]*?\*\//g, '');
+    const parts = splitTopLevelCommas(withoutBlockComments);
+    const names = [];
+
+    for (const part of parts) {
+        const trimmed = part.trim().replace(/\/\/.*$/gm, '').trim();
+        if (!trimmed) continue;
+        if (/^\.\.\./.test(trimmed)) continue;
+
+        const shorthand = trimmed.match(/^(\w+)\s*$/);
+        if (shorthand) {
+            names.push(shorthand[1]);
+            continue;
+        }
+        const keyIdent = trimmed.match(/^(\w+)\s*:/);
+        if (keyIdent) {
+            names.push(keyIdent[1]);
+            continue;
+        }
+        const keyQuoted = trimmed.match(/^['"]([^'"]+)['"]\s*:/);
+        if (keyQuoted) {
+            names.push(keyQuoted[1]);
+            continue;
         }
     }
 
+    console.log('🔍 App backend server export names:', names);
+    return names;
+};
+
+/**
+ * Validates manifest.json in the current working directory.
+ * Returns { valid: true, manifest } on success, or { valid: false, errors } on failure.
+ */
+const validateManifestFile = () => {
+    const userDir = process.cwd();
+    const manifestPath = path.join(userDir, 'manifest.json');
+    const errors = [];
+
+    if (!fs.existsSync(manifestPath)) {
+        return { valid: false, errors: [`manifest.json not found in ${userDir}`] };
+    }
+
+    let manifest;
+    try {
+        const raw = fs.readFileSync(manifestPath, 'utf8');
+        manifest = JSON.parse(raw);
+    } catch (e) {
+        return { valid: false, errors: [`manifest.json is invalid JSON: ${e.message}`] };
+    }
+
+    if (typeof manifest !== 'object' || manifest === null) {
+        return { valid: false, errors: ['manifest.json must be a JSON object'] };
+    }
+
+    console.log('🔍 Viewing manifest.json:', manifest);
+    console.log('🔍 Validating manifest.json...');
+
+    validatePlatformVersion(manifest.platform_version);
+    validateParentProduct(manifest.parent_product);
+    validateProductConfig(manifest.product_config);
+    
     if (errors.length > 0) {
         console.error('❌ Manifest validation failed:', errors);
         return { valid: false, errors };

package/appnest-command-line/zipUtils.js

@@ -10,7 +10,7 @@ const zipAppProject = ({ projects }) => {
     bundleFrontend({ projects });
   
     console.log('📦 Zipping the app project...');
-    const projectsToZipKeys = ['app-frontend', 'app-backend', 'app-installation-frontend'];
+    const projectsToZipKeys = ['app-frontend', 'app-backend', 'app-install-frontend'];
     const projectsToZip = projectsToZipKeys.reduce((acc, key) => {
       if (projects[key]) {
         acc[key] = projects[key];

package/appnest-engine-commands.md

@@ -0,0 +1,46 @@
+# Appnest Engine — Commands overview
+
+Quick reference for **`appnest-engine`** CLI actions. All **`app`** commands are invoked as:
+
+```bash
+appnest-engine app <action>
+```
+
+Run these from your **app project directory** (where `app-backend` / `app-frontend` live) unless noted. The engine resolves paths from **`process.cwd()`** and passes **`ORIGINAL_CWD`** to the proxy and Vite builds.
+
+For architecture and setup, see **[README.md](./README.md)**.
+
+---
+
+## Command summary
+
+| Action | Purpose |
+|--------|---------|
+| **`init`** | Scaffold or refresh the standard Appnest app layout in the current folder (base code from GitHub). Use once or when you need a fresh template. |
+| **`precheck`** | Verify **Node.js ≥ 22** and that every engine + app path the CLI knows about exists on disk. Fails fast with guidance if something is missing. |
+| **`install-packages`** | Run **`npm install`** inside each **engine** package: `appnest-backend`, `appnest-frontend`, `appnest-install-frontend`, `appnest-proxy`. Use after cloning the engine or changing engine dependencies. |
+| **`start`** | Start the **proxy** only; the proxy then starts the backend wrapper, main Vite app, and (if present) the installation Vite app. This is the main **local dev** entry point (single port, unified routing). |
+| **`bundle-frontend`** | Production **build** for both engine frontends (`npm run build` in `appnest-frontend` and `appnest-install-frontend`). Output is written into **your** `app-frontend/dist` and `app-install-frontend/dist` via `ORIGINAL_CWD`. |
+| **`pack`** | Runs **`bundle-frontend`**, adjusts `app-frontend/dist/index.html` paths where needed, copies **`app-frontend`**, **`app-backend`**, **`app-install-frontend`**, and **`manifest.json`** into **`appnest-app-pack/`**, then zips that folder to **`app-pack-zip/app-pack-<timestamp>.zip`**. For deployment / distribution packs. |
+| **`validate`** | Run linting (and related validation) on **`app-backend`** and **`app-frontend`**, and validate **`manifest.json`**. |
+| **`ai-context`** | Download AI context from GitHub into **`appnest-ai-context/`** at project root. Replaces existing folder if present. |
+
+---
+
+## Other invocations
+
+| Invocation | Purpose |
+|------------|---------|
+| **`appnest-engine --version`** | Show engine version from root `package.json`. |
+| **`appnest-engine help`** | Print the built-in short list of `app` actions. |
+| **`appnest-engine app`** (no param) | Same as above — lists all app actions. |
+| **`appnest-engine app help`** | Same as above. |
+| **`appnest-engine app -h`** | Same as above (Commander built-in help). |
+
+---
+
+## Notes
+
+- **`install-packages`** does **not** run `npm install` in the user’s `app-backend` / `app-frontend`; those are your app’s own dependencies—install them in those folders as usual.
+- **`app-install-frontend`** is **optional**; if the folder is missing, install UI is skipped and zip may warn for that path.
+- Engine folder **`appnest-install-frontend`** serves the user folder **`app-install-frontend`** (names differ on purpose).

package/appnest-install-frontend/package.json

@@ -4,7 +4,7 @@
   "version": "0.0.0",
   "type": "module",
   "scripts": {
-    "dev": "VITE_BASE_PATH=/app-installation-frontend/ vite",
+    "dev": "VITE_BASE_PATH=/app-install-frontend/ vite",
     "build": "vite build",
     "lint": "eslint .",
     "preview": "vite preview"

package/appnest-install-frontend/vite.config.js

@@ -5,7 +5,7 @@ import path from 'path';
 console.log('📂 User Directory from vite:', process.env.ORIGINAL_CWD);
 const userProjectPath = process.env.ORIGINAL_CWD;
 const projectPath = path.resolve(__dirname, '..');
-console.log('📂 Resolved Appnest app-installation-frontend Project Path:', projectPath);
+console.log('📂 Resolved Appnest app-install-frontend Project Path:', projectPath);
 const defaultClientScriptUrl =
   'https://d345rit115hm0w.cloudfront.net/client123.js';
 const clientScriptUrl =
@@ -19,7 +19,7 @@ if (!userProjectPath) {
   console.error('❌ ORIGINAL_CWD not set!');
   process.exit(1);
 } else {
-  console.log('✅ In app-installation-frontend Using user project path:', userProjectPath);
+  console.log('✅ In app-install-frontend Using user project path:', userProjectPath);
 }
 
 // https://vite.dev/config/
@@ -46,7 +46,7 @@ export default defineConfig({
   resolve: {
     alias: {
       // 👇 create a virtual import "@dev"
-      '@dev': path.resolve(userProjectPath, 'app-installation-frontend/src'),
+      '@dev': path.resolve(userProjectPath, 'app-install-frontend/src'),
       // 👇 Force developer’s React imports to use *your* React
       react: path.resolve(__dirname, 'node_modules/react'),
       'react-dom': path.resolve(__dirname, 'node_modules/react-dom'),
@@ -58,7 +58,7 @@ export default defineConfig({
   },
   build: {
     // Output dist folder inside the developer’s project
-    outDir: path.resolve(userProjectPath, 'app-installation-frontend/dist'),
+    outDir: path.resolve(userProjectPath, 'app-install-frontend/dist'),
 
     // 👇 optional but helps keep bundle stable
     emptyOutDir: true,