@aifabrix/builder 2.6.3 → 2.8.0

package/lib/validate.js

@@ -0,0 +1,299 @@
+/**
+ * Main Validation Command
+ *
+ * Validates applications or external integration files.
+ * Supports app name validation (including externalIntegration block) or direct file validation.
+ *
+ * @fileoverview Main validation command for AI Fabrix Builder
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const validator = require('./validator');
+const { resolveExternalFiles } = require('./utils/schema-resolver');
+const { loadExternalSystemSchema, loadExternalDataSourceSchema, detectSchemaType } = require('./utils/schema-loader');
+const { formatValidationErrors } = require('./utils/error-formatter');
+const logger = require('./utils/logger');
+
+/**
+ * Validates a single external file against its schema
+ *
+ * @async
+ * @function validateExternalFile
+ * @param {string} filePath - Path to the file
+ * @param {string} type - File type: 'system' | 'datasource'
+ * @returns {Promise<Object>} Validation result
+ */
+async function validateExternalFile(filePath, type) {
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`File not found: ${filePath}`);
+  }
+
+  const content = fs.readFileSync(filePath, 'utf8');
+  let parsed;
+
+  try {
+    parsed = JSON.parse(content);
+  } catch (error) {
+    return {
+      valid: false,
+      errors: [`Invalid JSON syntax: ${error.message}`],
+      warnings: []
+    };
+  }
+
+  let validate;
+  if (type === 'system') {
+    validate = loadExternalSystemSchema();
+  } else if (type === 'datasource') {
+    validate = loadExternalDataSourceSchema();
+  } else {
+    throw new Error(`Unknown file type: ${type}`);
+  }
+
+  const valid = validate(parsed);
+
+  return {
+    valid,
+    errors: valid ? [] : formatValidationErrors(validate.errors),
+    warnings: []
+  };
+}
+
+/**
+ * Validates application or external integration file
+ * Detects if input is app name or file path and validates accordingly
+ *
+ * @async
+ * @function validateAppOrFile
+ * @param {string} appOrFile - Application name or file path
+ * @returns {Promise<Object>} Validation result with aggregated results
+ * @throws {Error} If validation fails
+ *
+ * @example
+ * const result = await validateAppOrFile('myapp');
+ * // Returns: { valid: true, application: {...}, externalFiles: [...] }
+ */
+async function validateAppOrFile(appOrFile) {
+  if (!appOrFile || typeof appOrFile !== 'string') {
+    throw new Error('App name or file path is required');
+  }
+
+  // Check if it's a file path (exists and is a file)
+  const isFilePath = fs.existsSync(appOrFile) && fs.statSync(appOrFile).isFile();
+
+  if (isFilePath) {
+    // Validate single file
+    const schemaType = detectSchemaType(appOrFile);
+    let result;
+
+    if (schemaType === 'application') {
+      // For application files, we'd need to transform them first
+      // For now, just validate JSON structure
+      const content = fs.readFileSync(appOrFile, 'utf8');
+      try {
+        JSON.parse(content);
+      } catch (error) {
+        return {
+          valid: false,
+          errors: [`Invalid JSON syntax: ${error.message}`],
+          warnings: []
+        };
+      }
+      // Note: Full application validation requires variables.yaml transformation
+      // This is a simplified validation for direct JSON files
+      result = {
+        valid: true,
+        errors: [],
+        warnings: ['Application file validation is simplified. Use app name for full validation.']
+      };
+    } else if (schemaType === 'external-system') {
+      result = await validateExternalFile(appOrFile, 'system');
+    } else if (schemaType === 'external-datasource') {
+      result = await validateExternalFile(appOrFile, 'datasource');
+    } else {
+      throw new Error(`Unknown schema type: ${schemaType}`);
+    }
+
+    return {
+      valid: result.valid,
+      file: appOrFile,
+      type: schemaType,
+      errors: result.errors,
+      warnings: result.warnings
+    };
+  }
+
+  // Treat as app name
+  const appName = appOrFile;
+
+  // Validate application
+  const appValidation = await validator.validateApplication(appName);
+
+  // Check for externalIntegration block
+  const variablesPath = path.join(process.cwd(), 'builder', appName, 'variables.yaml');
+  if (!fs.existsSync(variablesPath)) {
+    return {
+      valid: appValidation.valid,
+      application: appValidation,
+      externalFiles: []
+    };
+  }
+
+  const yamlLib = require('js-yaml');
+  const content = fs.readFileSync(variablesPath, 'utf8');
+  let variables;
+
+  try {
+    variables = yamlLib.load(content);
+  } catch (error) {
+    return {
+      valid: appValidation.valid,
+      application: appValidation,
+      externalFiles: [],
+      warnings: [`Could not parse variables.yaml to check externalIntegration: ${error.message}`]
+    };
+  }
+
+  // If no externalIntegration block, return app validation only
+  if (!variables.externalIntegration) {
+    return {
+      valid: appValidation.valid,
+      application: appValidation,
+      externalFiles: []
+    };
+  }
+
+  // Resolve and validate external files
+  const externalFiles = await resolveExternalFiles(appName);
+  const externalValidations = [];
+
+  for (const fileInfo of externalFiles) {
+    try {
+      const validation = await validateExternalFile(fileInfo.path, fileInfo.type);
+      externalValidations.push({
+        file: fileInfo.fileName,
+        path: fileInfo.path,
+        type: fileInfo.type,
+        ...validation
+      });
+    } catch (error) {
+      externalValidations.push({
+        file: fileInfo.fileName,
+        path: fileInfo.path,
+        type: fileInfo.type,
+        valid: false,
+        errors: [error.message],
+        warnings: []
+      });
+    }
+  }
+
+  // Aggregate results
+  const allValid = appValidation.valid && externalValidations.every(v => v.valid);
+  const allErrors = [
+    ...appValidation.errors,
+    ...externalValidations.flatMap(v => v.errors.map(e => `${v.file}: ${e}`))
+  ];
+  const allWarnings = [
+    ...appValidation.warnings,
+    ...externalValidations.flatMap(v => v.warnings)
+  ];
+
+  return {
+    valid: allValid,
+    application: appValidation,
+    externalFiles: externalValidations,
+    errors: allErrors,
+    warnings: allWarnings
+  };
+}
+
+/**
+ * Displays validation results in a user-friendly format
+ *
+ * @function displayValidationResults
+ * @param {Object} result - Validation result from validateAppOrFile
+ */
+function displayValidationResults(result) {
+  if (result.valid) {
+    logger.log(chalk.green('\n✓ Validation passed!'));
+  } else {
+    logger.log(chalk.red('\n✗ Validation failed!'));
+  }
+
+  // Display application validation
+  if (result.application) {
+    logger.log(chalk.blue('\nApplication:'));
+    if (result.application.valid) {
+      logger.log(chalk.green('  ✓ Application configuration is valid'));
+    } else {
+      logger.log(chalk.red('  ✗ Application configuration has errors:'));
+      result.application.errors.forEach(error => {
+        logger.log(chalk.red(`    • ${error}`));
+      });
+    }
+    if (result.application.warnings && result.application.warnings.length > 0) {
+      result.application.warnings.forEach(warning => {
+        logger.log(chalk.yellow(`    ⚠ ${warning}`));
+      });
+    }
+  }
+
+  // Display external files validation
+  if (result.externalFiles && result.externalFiles.length > 0) {
+    logger.log(chalk.blue('\nExternal Integration Files:'));
+    result.externalFiles.forEach(file => {
+      if (file.valid) {
+        logger.log(chalk.green(`  ✓ ${file.file} (${file.type})`));
+      } else {
+        logger.log(chalk.red(`  ✗ ${file.file} (${file.type}):`));
+        file.errors.forEach(error => {
+          logger.log(chalk.red(`    • ${error}`));
+        });
+      }
+      if (file.warnings && file.warnings.length > 0) {
+        file.warnings.forEach(warning => {
+          logger.log(chalk.yellow(`    ⚠ ${warning}`));
+        });
+      }
+    });
+  }
+
+  // Display file validation (for direct file validation)
+  if (result.file) {
+    logger.log(chalk.blue(`\nFile: ${result.file}`));
+    logger.log(chalk.blue(`Type: ${result.type}`));
+    if (result.valid) {
+      logger.log(chalk.green('  ✓ File is valid'));
+    } else {
+      logger.log(chalk.red('  ✗ File has errors:'));
+      result.errors.forEach(error => {
+        logger.log(chalk.red(`    • ${error}`));
+      });
+    }
+    if (result.warnings && result.warnings.length > 0) {
+      result.warnings.forEach(warning => {
+        logger.log(chalk.yellow(`    ⚠ ${warning}`));
+      });
+    }
+  }
+
+  // Display aggregated warnings
+  if (result.warnings && result.warnings.length > 0) {
+    logger.log(chalk.yellow('\nWarnings:'));
+    result.warnings.forEach(warning => {
+      logger.log(chalk.yellow(`  • ${warning}`));
+    });
+  }
+}
+
+module.exports = {
+  validateAppOrFile,
+  displayValidationResults,
+  validateExternalFile
+};
+

package/lib/validator.js

@@ -14,6 +14,8 @@ const path = require('path');
 const yaml = require('js-yaml');
 const Ajv = require('ajv');
 const applicationSchema = require('./schema/application-schema.json');
+const externalSystemSchema = require('./schema/external-system.schema.json');
+const externalDataSourceSchema = require('./schema/external-datasource.schema.json');
 const { transformVariablesForValidation } = require('./utils/variable-transformer');
 const { checkEnvironment } = require('./utils/environment-checker');
 const { formatValidationErrors } = require('./utils/error-formatter');
@@ -56,13 +58,45 @@ async function validateVariables(appName) {
   const transformed = transformVariablesForValidation(variables, appName);
 
   const ajv = new Ajv({ allErrors: true, strict: false });
+  // Register external schemas with their $id (GitHub raw URLs)
+  // Create copies to avoid modifying the original schemas
+  const externalSystemSchemaCopy = { ...externalSystemSchema };
+  const externalDataSourceSchemaCopy = { ...externalDataSourceSchema };
+  // Remove $schema for draft-2020-12 to avoid AJV issues
+  if (externalDataSourceSchemaCopy.$schema && externalDataSourceSchemaCopy.$schema.includes('2020-12')) {
+    delete externalDataSourceSchemaCopy.$schema;
+  }
+  ajv.addSchema(externalSystemSchemaCopy, externalSystemSchema.$id);
+  ajv.addSchema(externalDataSourceSchemaCopy, externalDataSourceSchema.$id);
   const validate = ajv.compile(applicationSchema);
   const valid = validate(transformed);
 
+  // Additional explicit validation for external type
+  const errors = valid ? [] : formatValidationErrors(validate.errors);
+  const warnings = [];
+
+  // If type is external, perform additional checks
+  if (variables.app && variables.app.type === 'external') {
+    // Check for externalIntegration block
+    if (!variables.externalIntegration) {
+      errors.push('externalIntegration block is required when app.type is "external"');
+    } else {
+      // Validate externalIntegration structure
+      if (!variables.externalIntegration.schemaBasePath) {
+        errors.push('externalIntegration.schemaBasePath is required');
+      }
+      if (!variables.externalIntegration.systems || !Array.isArray(variables.externalIntegration.systems) || variables.externalIntegration.systems.length === 0) {
+        errors.push('externalIntegration.systems must be a non-empty array');
+      }
+      // Note: dataSources can be empty, so we don't validate that here
+      // File existence is validated during build/deploy, not during schema validation
+    }
+  }
+
   return {
-    valid,
-    errors: valid ? [] : formatValidationErrors(validate.errors),
-    warnings: []
+    valid: valid && errors.length === 0,
+    errors,
+    warnings
   };
 }
 
@@ -239,6 +273,16 @@ function validateDeploymentJson(deployment) {
   }
 
   const ajv = new Ajv({ allErrors: true, strict: false });
+  // Register external schemas with their $id (GitHub raw URLs)
+  // Create copies to avoid modifying the original schemas
+  const externalSystemSchemaCopy = { ...externalSystemSchema };
+  const externalDataSourceSchemaCopy = { ...externalDataSourceSchema };
+  // Remove $schema for draft-2020-12 to avoid AJV issues
+  if (externalDataSourceSchemaCopy.$schema && externalDataSourceSchemaCopy.$schema.includes('2020-12')) {
+    delete externalDataSourceSchemaCopy.$schema;
+  }
+  ajv.addSchema(externalSystemSchemaCopy, externalSystemSchema.$id);
+  ajv.addSchema(externalDataSourceSchemaCopy, externalDataSourceSchema.$id);
   const validate = ajv.compile(applicationSchema);
   const valid = validate(deployment);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aifabrix/builder",
-  "version": "2.6.3",
+  "version": "2.8.0",
   "description": "AI Fabrix Local Fabric & Deployment SDK",
   "main": "lib/index.js",
   "bin": {

package/tatus

@@ -0,0 +1,181 @@
+
+                   SSUUMMMMAARRYY OOFF LLEESSSS CCOOMMMMAANNDDSS
+
+      Commands marked with * may be preceded by a number, _N.
+      Notes in parentheses indicate the behavior if _N is given.
+      A key preceded by a caret indicates the Ctrl key; thus ^K is ctrl-K.
+
+  h  H                 Display this help.
+  q  :q  Q  :Q  ZZ     Exit.
+ ---------------------------------------------------------------------------
+
+                           MMOOVVIINNGG
+
+  e  ^E  j  ^N  CR  *  Forward  one line   (or _N lines).
+  y  ^Y  k  ^K  ^P  *  Backward one line   (or _N lines).
+  f  ^F  ^V  SPACE  *  Forward  one window (or _N lines).
+  b  ^B  ESC-v      *  Backward one window (or _N lines).
+  z                 *  Forward  one window (and set window to _N).
+  w                 *  Backward one window (and set window to _N).
+  ESC-SPACE         *  Forward  one window, but don't stop at end-of-file.
+  d  ^D             *  Forward  one half-window (and set half-window to _N).
+  u  ^U             *  Backward one half-window (and set half-window to _N).
+  ESC-)  RightArrow *  Right one half screen width (or _N positions).
+  ESC-(  LeftArrow  *  Left  one half screen width (or _N positions).
+  ESC-}  ^RightArrow   Right to last column displayed.
+  ESC-{  ^LeftArrow    Left  to first column.
+  F                    Forward forever; like "tail -f".
+  ESC-F                Like F but stop when search pattern is found.
+  r  ^R  ^L            Repaint screen.
+  R                    Repaint screen, discarding buffered input.
+        ---------------------------------------------------
+        Default "window" is the screen height.
+        Default "half-window" is half of the screen height.
+ ---------------------------------------------------------------------------
+
+                          SSEEAARRCCHHIINNGG
+
+  /_p_a_t_t_e_r_n          *  Search forward for (_N-th) matching line.
+  ?_p_a_t_t_e_r_n          *  Search backward for (_N-th) matching line.
+  n                 *  Repeat previous search (for _N-th occurrence).
+  N                 *  Repeat previous search in reverse direction.
+  ESC-n             *  Repeat previous search, spanning files.
+  ESC-N             *  Repeat previous search, reverse dir. & spanning files.
+  ^O^N  ^On         *  Search forward for (_N-th) OSC8 hyperlink.
+  ^O^P  ^Op         *  Search backward for (_N-th) OSC8 hyperlink.
+  ^O^L  ^Ol            Jump to the currently selected OSC8 hyperlink.
+  ESC-u                Undo (toggle) search highlighting.
+  ESC-U                Clear search highlighting.
+  &_p_a_t_t_e_r_n          *  Display only matching lines.
+        ---------------------------------------------------
+        A search pattern may begin with one or more of:
+        ^N or !  Search for NON-matching lines.
+        ^E or *  Search multiple files (pass thru END OF FILE).
+        ^F or @  Start search at FIRST file (for /) or last file (for ?).
+        ^K       Highlight matches, but don't move (KEEP position).
+        ^R       Don't use REGULAR EXPRESSIONS.
+        ^S _n     Search for match in _n-th parenthesized subpattern.
+        ^W       WRAP search if no match found.
+        ^L       Enter next character literally into pattern.
+ ---------------------------------------------------------------------------
+
+                           JJUUMMPPIINNGG
+
+  g  <  ESC-<       *  Go to first line in file (or line _N).
+  G  >  ESC->       *  Go to last line in file (or line _N).
+  p  %              *  Go to beginning of file (or _N percent into file).
+  t                 *  Go to the (_N-th) next tag.
+  T                 *  Go to the (_N-th) previous tag.
+  {  (  [           *  Find close bracket } ) ].
+  }  )  ]           *  Find open bracket { ( [.
+  ESC-^F _<_c_1_> _<_c_2_>  *  Find close bracket _<_c_2_>.
+  ESC-^B _<_c_1_> _<_c_2_>  *  Find open bracket _<_c_1_>.
+        ---------------------------------------------------
+        Each "find close bracket" command goes forward to the close bracket 
+          matching the (_N-th) open bracket in the top line.
+        Each "find open bracket" command goes backward to the open bracket 
+          matching the (_N-th) close bracket in the bottom line.
+
+  m_<_l_e_t_t_e_r_>            Mark the current top line with <letter>.
+  M_<_l_e_t_t_e_r_>            Mark the current bottom line with <letter>.
+  '_<_l_e_t_t_e_r_>            Go to a previously marked position.
+  ''                   Go to the previous position.
+  ^X^X                 Same as '.
+  ESC-m_<_l_e_t_t_e_r_>        Clear a mark.
+        ---------------------------------------------------
+        A mark is any upper-case or lower-case letter.
+        Certain marks are predefined:
+             ^  means  beginning of the file
+             $  means  end of the file
+ ---------------------------------------------------------------------------
+
+                        CCHHAANNGGIINNGG FFIILLEESS
+
+  :e [_f_i_l_e]            Examine a new file.
+  ^X^V                 Same as :e.
+  :n                *  Examine the (_N-th) next file from the command line.
+  :p                *  Examine the (_N-th) previous file from the command line.
+  :x                *  Examine the first (or _N-th) file from the command line.
+  ^O^O                 Open the currently selected OSC8 hyperlink.
+  :d                   Delete the current file from the command line list.
+  =  ^G  :f            Print current file name.
+ ---------------------------------------------------------------------------
+
+                    MMIISSCCEELLLLAANNEEOOUUSS CCOOMMMMAANNDDSS
+
+  -_<_f_l_a_g_>              Toggle a command line option [see OPTIONS below].
+  --_<_n_a_m_e_>             Toggle a command line option, by name.
+  __<_f_l_a_g_>              Display the setting of a command line option.
+  ___<_n_a_m_e_>             Display the setting of an option, by name.
+  +_c_m_d                 Execute the less cmd each time a new file is examined.
+
+  !_c_o_m_m_a_n_d             Execute the shell command with $SHELL.
+  #_c_o_m_m_a_n_d             Execute the shell command, expanded like a prompt.
+  |XX_c_o_m_m_a_n_d            Pipe file between current pos & mark XX to shell command.
+  s _f_i_l_e               Save input to a file.
+  v                    Edit the current file with $VISUAL or $EDITOR.
+  V                    Print version number of "less".
+ ---------------------------------------------------------------------------
+
+                           OOPPTTIIOONNSS
+
+        Most options may be changed either on the command line,
+        or from within less by using the - or -- command.
+        Options may be given in one of two forms: either a single
+        character preceded by a -, or a name preceded by --.
+
+  -?  ........  --help
+                  Display help (from command line).
+  -a  ........  --search-skip-screen
+                  Search skips current screen.
+  -A  ........  --SEARCH-SKIP-SCREEN
+                  Search starts just after target line.
+  -b [_N]  ....  --buffers=[_N]
+                  Number of buffers.
+  -B  ........  --auto-buffers
+                  Don't automatically allocate buffers for pipes.
+  -c  ........  --clear-screen
+                  Repaint by clearing rather than scrolling.
+  -d  ........  --dumb
+                  Dumb terminal.
+  -D xx_c_o_l_o_r  .  --color=xx_c_o_l_o_r
+                  Set screen colors.
+  -e  -E  ....  --quit-at-eof  --QUIT-AT-EOF
+                  Quit at end of file.
+  -f  ........  --force
+                  Force open non-regular files.
+  -F  ........  --quit-if-one-screen
+                  Quit if entire file fits on first screen.
+  -g  ........  --hilite-search
+                  Highlight only last match for searches.
+  -G  ........  --HILITE-SEARCH
+                  Don't highlight any matches for searches.
+  -h [_N]  ....  --max-back-scroll=[_N]
+                  Backward scroll limit.
+  -i  ........  --ignore-case
+                  Ignore case in searches that do not contain uppercase.
+  -I  ........  --IGNORE-CASE
+                  Ignore case in all searches.
+  -j [_N]  ....  --jump-target=[_N]
+                  Screen position of target lines.
+  -J  ........  --status-column
+                  Display a status column at left edge of screen.
+  -k _f_i_l_e  ...  --lesskey-file=_f_i_l_e
+                  Use a compiled lesskey file.
+  -K  ........  --quit-on-intr
+                  Exit less in response to ctrl-C.
+  -L  ........  --no-lessopen
+                  Ignore the LESSOPEN environment variable.
+  -m  -M  ....  --long-prompt  --LONG-PROMPT
+                  Set prompt style.
+  -n .........  --line-numbers
+                  Suppress line numbers in prompts and messages.
+  -N .........  --LINE-NUMBERS
+                  Display line number at start of each line.
+  -o [_f_i_l_e] ..  --log-file=[_f_i_l_e]
+                  Copy to log file (standard input only).
+  -O [_f_i_l_e] ..  --LOG-FILE=[_f_i_l_e]
+                  Copy to log file (unconditionally overwrite).
+  -p _p_a_t_t_e_r_n .  --pattern=[_p_a_t_t_e_r_n]
+                  Start at pattern (from command line).
+  -P [_p_r_o_m_p_t]   --prompt=[_p_r_o_m_p_t]

package/templates/external-system/external-datasource.json.hbs

@@ -0,0 +1,55 @@
+{
+  "key": "{{datasourceKey}}",
+  "displayName": "{{datasourceDisplayName}}",
+  "description": "{{datasourceDescription}}",
+  "systemKey": "{{systemKey}}",
+  "entityKey": "{{entityKey}}",
+  "resourceType": "{{resourceType}}",
+  "enabled": true,
+  "version": "1.0.0",
+  "metadataSchema": {
+    "type": "object",
+    "properties": {}
+  },
+  "fieldMappings": {
+    "accessFields": ["id", "name"],
+    "fields": {
+      "id": {
+        "expression": "{{raw.id}}",
+        "type": "string",
+        "description": "Unique identifier",
+        "required": true
+      },
+      "name": {
+        "expression": "{{raw.name}}",
+        "type": "string",
+        "description": "Display name",
+        "required": true
+      }
+    }
+  },
+  "exposed": {
+    "fields": ["id", "name"],
+    "description": "Exposed fields for {{datasourceDisplayName}}"
+  }{{#if (eq systemType "openapi")}},
+  "openapi": {
+    "enabled": true,
+    "documentKey": "{{systemKey}}-api",
+    "baseUrl": "https://api.example.com",
+    "resourcePath": "/{{entityKey}}",
+    "operations": {
+      "list": {
+        "operationId": "list{{entityKey}}",
+        "method": "GET",
+        "path": "/{{entityKey}}"
+      },
+      "get": {
+        "operationId": "get{{entityKey}}",
+        "method": "GET",
+        "path": "/{{entityKey}}/{id}"
+      }
+    },
+    "autoRbac": true
+  }{{/if}}
+}
+

package/templates/external-system/external-system.json.hbs

@@ -0,0 +1,37 @@
+{
+  "key": "{{systemKey}}",
+  "displayName": "{{systemDisplayName}}",
+  "description": "{{systemDescription}}",
+  "type": "{{systemType}}",
+  "enabled": true,
+  "environment": {
+    "baseUrl": "https://api.example.com"
+  },
+  "authentication": {
+    "mode": "{{authType}}"{{#if (eq authType "oauth2")}},
+    "oauth2": {
+      "tokenUrl": "https://api.example.com/oauth/token",
+      "clientId": "kv://{{systemKey}}-oauth2-client-id",
+      "clientSecret": "kv://{{systemKey}}-oauth2-client-secret",
+      "scopes": []
+    }{{/if}}{{#if (eq authType "apikey")}},
+    "apikey": {
+      "headerName": "X-API-Key",
+      "key": "kv://{{systemKey}}-api-key"
+    }{{/if}}{{#if (eq authType "basic")}},
+    "basic": {
+      "username": "kv://{{systemKey}}-username",
+      "password": "kv://{{systemKey}}-password"
+    }{{/if}}
+  }{{#if (eq systemType "openapi")}},
+  "openapi": {
+    "documentKey": "{{systemKey}}-api",
+    "autoDiscoverEntities": false
+  }{{/if}}{{#if (eq systemType "mcp")}},
+  "mcp": {
+    "serverUrl": "https://mcp.example.com",
+    "toolPrefix": "{{systemKey}}"
+  }{{/if}},
+  "tags": []
+}
+