awc-zns-mtd 2.8.0 → 2.10.0

package/tools/cli/utils/validators.js

@@ -0,0 +1,144 @@
+/**
+ * Utilidades de validación
+ * Validadores para inputs del usuario y paths del filesystem
+ */
+
+const path = require('path');
+
+/**
+ * Valida un nombre de proyecto
+ * @param {string} name - Nombre del proyecto
+ * @returns {boolean} - true si es válido
+ */
+function validateProjectName(name) {
+  if (!name || typeof name !== 'string') {
+    return false;
+  }
+
+  const trimmed = name.trim();
+
+  // Verificar que no esté vacío
+  if (trimmed.length === 0) {
+    return false;
+  }
+
+  // Solo letras, números, guiones y guiones bajos
+  const validPattern = /^[a-zA-Z0-9-_]+$/;
+  if (!validPattern.test(trimmed)) {
+    return false;
+  }
+
+  // Nombres reservados
+  const reserved = [
+    'node_modules',
+    'package.json',
+    'package-lock.json',
+    '.git',
+    '.awc',
+    'test',
+    'dist',
+    'build'
+  ];
+
+  if (reserved.includes(trimmed.toLowerCase())) {
+    return false;
+  }
+
+  // No debe contener path traversal
+  if (trimmed.includes('..') || trimmed.includes('/') || trimmed.includes('\\')) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Valida que un path sea seguro
+ * @param {string} filePath - Path a validar
+ * @returns {boolean} - true si es seguro
+ */
+function validatePath(filePath) {
+  if (!filePath || typeof filePath !== 'string') {
+    return false;
+  }
+
+  // Normalizar el path
+  const normalized = path.normalize(filePath);
+
+  // Detectar path traversal
+  if (normalized.includes('..')) {
+    return false;
+  }
+
+  // Paths del sistema prohibidos (lista básica)
+  const forbiddenPaths = [
+    '/etc',
+    '/sys',
+    '/proc',
+    'C:\\Windows',
+    'C:\\Program Files',
+    '/usr/bin',
+    '/usr/sbin'
+  ];
+
+  for (const forbidden of forbiddenPaths) {
+    if (normalized.startsWith(forbidden)) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+/**
+ * Sanitiza un path removiendo caracteres peligrosos
+ * @param {string} filePath - Path a sanitizar
+ * @returns {string} - Path sanitizado
+ */
+function sanitizePath(filePath) {
+  if (!filePath) {
+    return '';
+  }
+
+  let sanitized = filePath;
+
+  // Normalizar separadores
+  sanitized = sanitized.replace(/\\/g, '/');
+
+  // Eliminar múltiples slashes
+  sanitized = sanitized.replace(/\/+/g, '/');
+
+  // Eliminar path traversal
+  sanitized = sanitized.replace(/\.\.\//g, '');
+  sanitized = sanitized.replace(/\.\//g, '');
+
+  return path.normalize(sanitized);
+}
+
+/**
+ * Valida opciones del comando
+ * @param {Object} options - Opciones a validar
+ * @param {Array<string>} required - Campos requeridos
+ * @returns {Object} - { valid: boolean, errors: string[] }
+ */
+function validateCommandOptions(options, required = []) {
+  const errors = [];
+
+  for (const field of required) {
+    if (!options[field]) {
+      errors.push(`Campo requerido: ${field}`);
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+module.exports = {
+  validateProjectName,
+  validatePath,
+  sanitizePath,
+  validateCommandOptions
+};

package/tools/cli/utils/version.js

@@ -47,8 +47,12 @@ async function checkForUpdates(currentVersion) {
  * @returns {number} -1 si v1 < v2, 0 si v1 === v2, 1 si v1 > v2
  */
 function compareVersions(v1, v2) {
-  if (semver.lt(v1, v2)) return -1;
-  if (semver.gt(v1, v2)) return 1;
+  if (semver.lt(v1, v2)) {
+    return -1;
+  }
+  if (semver.gt(v1, v2)) {
+    return 1;
+  }
   return 0;
 }
 

package/tools/config/config-manager.js

@@ -0,0 +1,243 @@
+/**
+ * ConfigManager - Gestión centralizada de configuración
+ * Centraliza paths, constantes y configuración del framework
+ */
+
+const path = require('path');
+const os = require('os');
+
+class ConfigManager {
+  /**
+   * Directorios principales
+   */
+  static get AWC_DIR() {
+    return '.awc';
+  }
+
+  static get AGENTS_DIR() {
+    return path.join(this.AWC_DIR, 'agents');
+  }
+
+  static get WORKFLOWS_DIR() {
+    return path.join(this.AWC_DIR, 'workflows');
+  }
+
+  static get TEMPLATES_DIR() {
+    return path.join(this.AWC_DIR, 'templates');
+  }
+
+  static get RESOURCES_DIR() {
+    return path.join(this.AWC_DIR, 'resources');
+  }
+
+  static get LOGS_DIR() {
+    return path.join(this.AWC_DIR, 'logs');
+  }
+
+  static get CONFIG_FILE() {
+    return path.join(this.AWC_DIR, 'config.yaml');
+  }
+
+  /**
+   * Módulos del framework
+   */
+  static get CORE_MODULE_PATH() {
+    return 'src/modules/awc-zns-mtd';
+  }
+
+  static get CUSTOM_MODULE_PATH() {
+    return 'src/modules/custom-agents';
+  }
+
+  /**
+   * Configuración de agentes
+   */
+  static get CORE_AGENTS() {
+    return ['zen-master', 'architect-senior', 'developer-pro', 'qa-specialist'];
+  }
+
+  static get AGENT_CATEGORIES() {
+    return [
+      'core',
+      'development',
+      'qa_testing',
+      'product_strategy',
+      'support_maintenance',
+      'frontend',
+      'backend',
+      'infrastructure',
+      'architecture',
+      'quality',
+      'business',
+      'ai',
+      'documentation'
+    ];
+  }
+
+  /**
+   * Configuración de workflows
+   */
+  static get WORKFLOW_TYPES() {
+    return [
+      'quick',
+      'standard',
+      'enterprise',
+      'comercial-flow',
+      'inception-flow',
+      'development-flow',
+      'qa-flow',
+      'deployment-flow',
+      'support-flow'
+    ];
+  }
+
+  /**
+   * Tipos de proyecto
+   */
+  static get PROJECT_TYPES() {
+    return ['code-audit', 'greenfield', 'migration', 'maintenance', 'mobile', 'api', 'enterprise'];
+  }
+
+  /**
+   * Tecnologías soportadas
+   */
+  static get SUPPORTED_TECHNOLOGIES() {
+    return [
+      'java',
+      'dotnet',
+      'python',
+      'php',
+      'nodejs',
+      'react',
+      'angular',
+      'vue',
+      'react-native',
+      'sql',
+      'nosql'
+    ];
+  }
+
+  /**
+   * Configuración de logs
+   */
+  static get LOG_LEVELS() {
+    return ['error', 'warn', 'info', 'debug', 'verbose'];
+  }
+
+  static get DEFAULT_LOG_LEVEL() {
+    return process.env.LOG_LEVEL || 'info';
+  }
+
+  /**
+   * Configuración de versiones
+   */
+  static get SEMVER_TYPES() {
+    return ['major', 'minor', 'patch'];
+  }
+
+  /**
+   * Límites y validaciones
+   */
+  static get MAX_PROJECT_NAME_LENGTH() {
+    return 50;
+  }
+
+  static get MIN_PROJECT_NAME_LENGTH() {
+    return 3;
+  }
+
+  static get RESERVED_NAMES() {
+    return [
+      'node_modules',
+      'package.json',
+      'package-lock.json',
+      '.git',
+      '.awc',
+      'test',
+      'dist',
+      'build',
+      'coverage'
+    ];
+  }
+
+  /**
+   * Paths del sistema
+   */
+  static get HOME_DIR() {
+    return os.homedir();
+  }
+
+  static get TEMP_DIR() {
+    return os.tmpdir();
+  }
+
+  /**
+   * Obtiene la ruta completa a un directorio del proyecto
+   * @param {string} cwd - Directorio actual
+   * @param {string} subPath - Subdirectorio
+   * @returns {string} - Path completo
+   */
+  static getProjectPath(cwd, subPath = '') {
+    return path.join(cwd, this.AWC_DIR, subPath);
+  }
+
+  /**
+   * Obtiene la ruta a los agentes del proyecto
+   * @param {string} cwd - Directorio actual
+   * @returns {string} - Path a agentes
+   */
+  static getAgentsPath(cwd) {
+    return this.getProjectPath(cwd, 'agents');
+  }
+
+  /**
+   * Obtiene la ruta a workflows del proyecto
+   * @param {string} cwd - Directorio actual
+   * @returns {string} - Path a workflows
+   */
+  static getWorkflowsPath(cwd) {
+    return this.getProjectPath(cwd, 'workflows');
+  }
+
+  /**
+   * Obtiene la configuración del entorno
+   * @returns {Object} - Configuración de entorno
+   */
+  static getEnvironmentConfig() {
+    return {
+      nodeVersion: process.version,
+      platform: os.platform(),
+      arch: os.arch(),
+      cwd: process.cwd(),
+      env: process.env.NODE_ENV || 'development'
+    };
+  }
+
+  /**
+   * Valida la configuración del proyecto
+   * @param {Object} config - Configuración a validar
+   * @returns {Object} - { valid: boolean, errors: string[] }
+   */
+  static validateConfig(config) {
+    const errors = [];
+
+    if (!config.projectName) {
+      errors.push('projectName es requerido');
+    }
+
+    if (!config.version) {
+      errors.push('version es requerida');
+    }
+
+    if (config.workflow && !this.WORKFLOW_TYPES.includes(config.workflow)) {
+      errors.push(`workflow inválido: ${config.workflow}`);
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+}
+
+module.exports = ConfigManager;