@aifabrix/builder 2.36.2 → 2.37.0

package/lib/cli/setup-dev.js

@@ -0,0 +1,101 @@
+/**
+ * CLI developer configuration command setup (dev config, dev set-id).
+ *
+ * @fileoverview Developer command definitions for AI Fabrix Builder CLI
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const chalk = require('chalk');
+const config = require('../core/config');
+const devConfig = require('../utils/dev-config');
+const logger = require('../utils/logger');
+const { handleCommandError } = require('../utils/cli-utils');
+
+/**
+ * Display developer configuration
+ * @param {string} devId - Developer ID
+ * @returns {Promise<void>}
+ */
+async function displayDevConfig(devId) {
+  const devIdNum = parseInt(devId, 10);
+  const ports = devConfig.getDevPorts(devIdNum);
+  const configVars = [
+    { key: 'aifabrix-home', value: await config.getAifabrixHomeOverride() },
+    { key: 'aifabrix-secrets', value: await config.getAifabrixSecretsPath() },
+    { key: 'aifabrix-env-config', value: await config.getAifabrixEnvConfigPath() }
+  ].filter(v => v.value);
+
+  logger.log('\n🔧 Developer Configuration\n');
+  logger.log(`Developer ID: ${devId}`);
+  logger.log('\nPorts:');
+  logger.log(`  App: ${ports.app}`);
+  logger.log(`  Postgres: ${ports.postgres}`);
+  logger.log(`  Redis: ${ports.redis}`);
+  logger.log(`  pgAdmin: ${ports.pgadmin}`);
+  logger.log(`  Redis Commander: ${ports.redisCommander}`);
+
+  if (configVars.length > 0) {
+    logger.log('\nConfiguration:');
+    configVars.forEach(v => logger.log(`  ${v.key}: ${v.value}`));
+  }
+  logger.log('');
+}
+
+/**
+ * Sets up developer configuration commands
+ * @param {Command} program - Commander program instance
+ */
+function setupDevCommands(program) {
+  const dev = program
+    .command('dev')
+    .description('Developer configuration and isolation');
+
+  dev
+    .command('config')
+    .description('Show or set developer configuration')
+    .option('--set-id <id>', 'Set developer ID')
+    .action(async(options) => {
+      try {
+        const setIdValue = options.setId || options['set-id'];
+        if (setIdValue) {
+          const digitsOnly = /^[0-9]+$/.test(setIdValue);
+          if (!digitsOnly) {
+            throw new Error('Developer ID must be a non-negative digit string (0 = default infra, > 0 = developer-specific)');
+          }
+          await config.setDeveloperId(setIdValue);
+          process.env.AIFABRIX_DEVELOPERID = setIdValue;
+          logger.log(chalk.green(`✓ Developer ID set to ${setIdValue}`));
+          await displayDevConfig(setIdValue);
+          return;
+        }
+
+        const devId = await config.getDeveloperId();
+        await displayDevConfig(devId);
+      } catch (error) {
+        handleCommandError(error, 'dev config');
+        process.exit(1);
+      }
+    });
+
+  dev
+    .command('set-id <id>')
+    .description('Set developer ID (convenience alias for "dev config --set-id")')
+    .action(async(id) => {
+      try {
+        const digitsOnly = /^[0-9]+$/.test(id);
+        if (!digitsOnly) {
+          throw new Error('Developer ID must be a non-negative digit string (0 = default infra, > 0 = developer-specific)');
+        }
+        await config.setDeveloperId(id);
+        process.env.AIFABRIX_DEVELOPERID = id;
+        logger.log(chalk.green(`✓ Developer ID set to ${id}`));
+        await displayDevConfig(id);
+      } catch (error) {
+        handleCommandError(error, 'dev set-id');
+        process.exit(1);
+      }
+    });
+}
+
+module.exports = { setupDevCommands };

package/lib/cli/setup-environment.js

@@ -0,0 +1,53 @@
+/**
+ * CLI environment deployment command setup (environment deploy, env deploy).
+ *
+ * @fileoverview Environment command definitions for AI Fabrix Builder CLI
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const { handleCommandError } = require('../utils/cli-utils');
+
+/**
+ * Sets up environment deployment commands
+ * @param {Command} program - Commander program instance
+ */
+function setupEnvironmentCommands(program) {
+  const deployEnvHandler = async(envKey, options) => {
+    try {
+      const environmentDeploy = require('../deployment/environment');
+      await environmentDeploy.deployEnvironment(envKey, options);
+    } catch (error) {
+      handleCommandError(error, 'environment deploy');
+      process.exit(1);
+    }
+  };
+
+  const environment = program
+    .command('environment')
+    .description('Manage environments');
+
+  environment
+    .command('deploy <env>')
+    .description('Deploy/setup environment in Miso Controller')
+    .option('--config <file>', 'Environment configuration file')
+    .option('--skip-validation', 'Skip environment validation')
+    .option('--poll', 'Poll for deployment status', true)
+    .option('--no-poll', 'Do not poll for status')
+    .action(deployEnvHandler);
+
+  const env = program
+    .command('env')
+    .description('Environment management (alias for environment)');
+
+  env
+    .command('deploy <env>')
+    .description('Deploy/setup environment in Miso Controller')
+    .option('--config <file>', 'Environment configuration file')
+    .option('--skip-validation', 'Skip environment validation')
+    .option('--poll', 'Poll for deployment status', true)
+    .option('--no-poll', 'Do not poll for status')
+    .action(deployEnvHandler);
+}
+
+module.exports = { setupEnvironmentCommands };

package/lib/cli/setup-external-system.js

@@ -0,0 +1,86 @@
+/**
+ * CLI external system command setup (download, delete, test, test-integration).
+ *
+ * @fileoverview External system command definitions for AI Fabrix Builder CLI
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const { handleCommandError } = require('../utils/cli-utils');
+
+/**
+ * Sets up external system commands
+ * @param {Command} program - Commander program instance
+ */
+function setupExternalSystemCommands(program) {
+  program.command('download <system-key>')
+    .description('Download external system from dataplane to local development structure')
+    .option('--dry-run', 'Show what would be downloaded without actually downloading')
+    .action(async(systemKey, options) => {
+      try {
+        const download = require('../external-system/download');
+        await download.downloadExternalSystem(systemKey, options);
+      } catch (error) {
+        handleCommandError(error, 'download');
+        process.exit(1);
+      }
+    });
+
+  program.command('delete <system-key>')
+    .description('Delete external system from dataplane (also deletes all associated datasources)')
+    .option('--type <type>', 'Application type (external) - required for external systems')
+    .option('--yes', 'Skip confirmation prompt')
+    .option('--force', 'Skip confirmation prompt (alias for --yes)')
+    .action(async(systemKey, options) => {
+      try {
+        if (options.type !== 'external') {
+          throw new Error('Delete command for external systems requires --type external');
+        }
+        const externalDelete = require('../external-system/delete');
+        await externalDelete.deleteExternalSystem(systemKey, options);
+      } catch (error) {
+        handleCommandError(error, 'delete');
+        process.exit(1);
+      }
+    });
+
+  program.command('test <app>')
+    .description('Run unit tests for external system (local validation, no API calls)')
+    .option('-d, --datasource <key>', 'Test specific datasource only')
+    .option('-v, --verbose', 'Show detailed validation output')
+    .action(async(appName, options) => {
+      try {
+        const test = require('../external-system/test');
+        const results = await test.testExternalSystem(appName, options);
+        test.displayTestResults(results, options.verbose);
+        if (!results.valid) {
+          process.exit(1);
+        }
+      } catch (error) {
+        handleCommandError(error, 'test');
+        process.exit(1);
+      }
+    });
+
+  program.command('test-integration <app>')
+    .description('Run integration tests via dataplane pipeline API')
+    .option('-d, --datasource <key>', 'Test specific datasource only')
+    .option('-p, --payload <file>', 'Path to custom test payload file')
+    .option('-v, --verbose', 'Show detailed test output')
+    .option('--timeout <ms>', 'Request timeout in milliseconds', '30000')
+    .action(async(appName, options) => {
+      try {
+        const test = require('../external-system/test');
+        const results = await test.testExternalSystemIntegration(appName, options);
+        test.displayIntegrationTestResults(results, options.verbose);
+        if (!results.success) {
+          process.exit(1);
+        }
+      } catch (error) {
+        handleCommandError(error, 'test-integration');
+        process.exit(1);
+      }
+    });
+}
+
+module.exports = { setupExternalSystemCommands };

package/lib/cli/setup-infra.js

@@ -0,0 +1,219 @@
+/**
+ * CLI infrastructure command setup (up-infra, up-platform, up-miso, up-dataplane, down-infra, doctor, status, restart).
+ *
+ * @fileoverview Infrastructure command definitions for AI Fabrix Builder CLI
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const chalk = require('chalk');
+const infra = require('../infrastructure');
+const appLib = require('../app');
+const validator = require('../validation/validator');
+const config = require('../core/config');
+const logger = require('../utils/logger');
+const { handleCommandError } = require('../utils/cli-utils');
+const { handleUpMiso } = require('../commands/up-miso');
+const { handleUpDataplane } = require('../commands/up-dataplane');
+
+/**
+ * Runs the up-infra command: resolves developer ID, traefik, and starts infra.
+ * @param {Object} options - Commander options (developer, traefik)
+ * @returns {Promise<void>}
+ */
+async function runUpInfraCommand(options) {
+  await config.ensureSecretsEncryptionKey();
+  let developerId = null;
+  if (options.developer) {
+    const id = parseInt(options.developer, 10);
+    if (isNaN(id) || id < 0) {
+      throw new Error('Developer ID must be a non-negative number (0 = default infra, > 0 = developer-specific)');
+    }
+    await config.setDeveloperId(id);
+    process.env.AIFABRIX_DEVELOPERID = id.toString();
+    developerId = id;
+    logger.log(chalk.green(`✓ Developer ID set to ${id}`));
+  }
+  const cfg = await config.getConfig();
+  if (options.traefik === true) {
+    cfg.traefik = true;
+    await config.saveConfig(cfg);
+    logger.log(chalk.green('✓ Traefik enabled and saved to config'));
+  } else if (options.traefik === false) {
+    cfg.traefik = false;
+    await config.saveConfig(cfg);
+    logger.log(chalk.green('✓ Traefik disabled and saved to config'));
+  }
+  const useTraefik = options.traefik === true ? true : (options.traefik === false ? false : !!(cfg.traefik));
+  await infra.startInfra(developerId, { traefik: useTraefik });
+}
+
+/**
+ * Sets up infrastructure commands
+ * @param {Command} program - Commander program instance
+ */
+function setupInfraCommands(program) {
+  program.command('up-infra')
+    .description('Start local infrastructure: Postgres, Redis, optional Traefik')
+    .option('-d, --developer <id>', 'Set developer ID and start infrastructure')
+    .option('--traefik', 'Include Traefik reverse proxy and save to config')
+    .option('--no-traefik', 'Exclude Traefik and save to config')
+    .action(async(options) => {
+      try {
+        await runUpInfraCommand(options);
+      } catch (error) {
+        handleCommandError(error, 'up-infra');
+        process.exit(1);
+      }
+    });
+
+  program.command('up-platform')
+    .description('Start platform (Keycloak, Miso Controller, Dataplane) from community images; infra must be up')
+    .option('-r, --registry <url>', 'Override registry for all apps (e.g. myacr.azurecr.io)')
+    .option('--registry-mode <mode>', 'Override registry mode (acr|external)')
+    .option('-i, --image <key>=<value>', 'Override image (e.g. keycloak=myreg/k:v1, miso-controller=myreg/m:v1, dataplane=myreg/d:v1); can be repeated', (v, prev) => (prev || []).concat([v]))
+    .action(async(options) => {
+      try {
+        await handleUpMiso(options);
+        await handleUpDataplane(options);
+      } catch (error) {
+        handleCommandError(error, 'up-platform');
+        process.exit(1);
+      }
+    });
+
+  program.command('up-miso')
+    .description('Install keycloak, miso-controller, and dataplane from images (no build). Infra must be up. Uses auto-generated secrets for testing.')
+    .option('-r, --registry <url>', 'Override registry for all apps (e.g. myacr.azurecr.io)')
+    .option('--registry-mode <mode>', 'Override registry mode (acr|external)')
+    .option('-i, --image <key>=<value>', 'Override image (e.g. keycloak=myreg/k:v1, miso-controller=myreg/m:v1, dataplane=myreg/d:v1); can be repeated', (v, prev) => (prev || []).concat([v]))
+    .action(async(options) => {
+      try {
+        await handleUpMiso(options);
+      } catch (error) {
+        handleCommandError(error, 'up-miso');
+        process.exit(1);
+      }
+    });
+
+  program.command('up-dataplane')
+    .description('Register and deploy dataplane app in dev (requires login, environment must be dev)')
+    .option('-r, --registry <url>', 'Override registry for dataplane image')
+    .option('--registry-mode <mode>', 'Override registry mode (acr|external)')
+    .option('-i, --image <ref>', 'Override dataplane image reference (e.g. myreg/dataplane:latest)')
+    .action(async(options) => {
+      try {
+        await handleUpDataplane(options);
+      } catch (error) {
+        handleCommandError(error, 'up-dataplane');
+        process.exit(1);
+      }
+    });
+
+  program.command('down-infra [app]')
+    .description('Stop and remove local infrastructure services or a specific application')
+    .option('-v, --volumes', 'Remove volumes (deletes all data)')
+    .action(async(appName, options) => {
+      try {
+        if (typeof appName === 'string' && appName.trim().length > 0) {
+          await appLib.downApp(appName, { volumes: !!options.volumes });
+        } else {
+          if (options.volumes) {
+            await infra.stopInfraWithVolumes();
+          } else {
+            await infra.stopInfra();
+          }
+        }
+      } catch (error) {
+        handleCommandError(error, 'down-infra');
+        process.exit(1);
+      }
+    });
+
+  program.command('doctor')
+    .description('Check environment and configuration')
+    .action(async() => {
+      try {
+        const result = await validator.checkEnvironment();
+        logger.log('\n🔍 AI Fabrix Environment Check\n');
+
+        logger.log(`Docker: ${result.docker === 'ok' ? '✅ Running' : '❌ Not available'}`);
+        logger.log(`Ports: ${result.ports === 'ok' ? '✅ Available' : '⚠️  Some ports in use'}`);
+        logger.log(`Secrets: ${result.secrets === 'ok' ? '✅ Configured' : '❌ Missing'}`);
+
+        if (result.recommendations.length > 0) {
+          logger.log('\n📋 Recommendations:');
+          result.recommendations.forEach(rec => logger.log(`  • ${rec}`));
+        }
+
+        if (result.docker === 'ok') {
+          try {
+            const health = await infra.checkInfraHealth();
+            logger.log('\n🏥 Infrastructure Health:');
+            Object.entries(health).forEach(([service, status]) => {
+              const icon = status === 'healthy' ? '✅' : status === 'unknown' ? '❓' : '❌';
+              logger.log(`  ${icon} ${service}: ${status}`);
+            });
+          } catch (error) {
+            logger.log('\n🏥 Infrastructure: Not running');
+          }
+        }
+
+        logger.log('');
+      } catch (error) {
+        handleCommandError(error, 'doctor');
+        process.exit(1);
+      }
+    });
+
+  program.command('status')
+    .description('Show detailed infrastructure service status and running applications')
+    .action(async() => {
+      try {
+        const status = await infra.getInfraStatus();
+        logger.log('\n📊 Infrastructure Status\n');
+
+        Object.entries(status).forEach(([service, info]) => {
+          const normalizedStatus = String(info.status).trim().toLowerCase();
+          const icon = normalizedStatus === 'running' ? '✅' : '❌';
+          logger.log(`${icon} ${service}:`);
+          logger.log(`   Status: ${info.status}`);
+          logger.log(`   Port: ${info.port}`);
+          logger.log(`   URL: ${info.url}`);
+          logger.log('');
+        });
+
+        const apps = await infra.getAppStatus();
+        if (apps.length > 0) {
+          logger.log('📱 Running Applications\n');
+          apps.forEach((appInfo) => {
+            const normalizedStatus = String(appInfo.status).trim().toLowerCase();
+            const icon = normalizedStatus.includes('running') || normalizedStatus.includes('up') ? '✅' : '❌';
+            logger.log(`${icon} ${appInfo.name}:`);
+            logger.log(`   Container: ${appInfo.container}`);
+            logger.log(`   Port: ${appInfo.port}`);
+            logger.log(`   Status: ${appInfo.status}`);
+            logger.log(`   URL: ${appInfo.url}`);
+            logger.log('');
+          });
+        }
+      } catch (error) {
+        handleCommandError(error, 'status');
+        process.exit(1);
+      }
+    });
+
+  program.command('restart <service>')
+    .description('Restart a specific infrastructure service')
+    .action(async(service) => {
+      try {
+        await infra.restartService(service);
+        logger.log(`✅ ${service} service restarted successfully`);
+      } catch (error) {
+        handleCommandError(error, 'restart');
+        process.exit(1);
+      }
+    });
+}
+
+module.exports = { setupInfraCommands };

package/lib/cli/setup-secrets.js

@@ -0,0 +1,48 @@
+/**
+ * CLI secrets and security command setup (secrets set, secure).
+ *
+ * @fileoverview Secrets command definitions for AI Fabrix Builder CLI
+ * @author AI Fabrix Team
+ * @version 2.0.0
+ */
+
+const { handleCommandError } = require('../utils/cli-utils');
+const { handleSecretsSet } = require('../commands/secrets-set');
+const { handleSecure } = require('../commands/secure');
+
+/**
+ * Sets up secrets and security commands
+ * @param {Command} program - Commander program instance
+ */
+function setupSecretsCommands(program) {
+  const secretsCmd = program
+    .command('secrets')
+    .description('Manage secrets in secrets files');
+
+  secretsCmd
+    .command('set <key> <value>')
+    .description('Set a secret value in secrets file')
+    .option('--shared', 'Save to general secrets file (from config.yaml aifabrix-secrets) instead of user secrets')
+    .action(async(key, value, options) => {
+      try {
+        await handleSecretsSet(key, value, options);
+      } catch (error) {
+        handleCommandError(error, 'secrets set');
+        process.exit(1);
+      }
+    });
+
+  program.command('secure')
+    .description('Encrypt secrets in secrets.local.yaml files for ISO 27001 compliance')
+    .option('--secrets-encryption <key>', 'Encryption key (32 bytes, hex or base64)')
+    .action(async(options) => {
+      try {
+        await handleSecure(options);
+      } catch (error) {
+        handleCommandError(error, 'secure');
+        process.exit(1);
+      }
+    });
+}
+
+module.exports = { setupSecretsCommands };