g360-cli 1.3.0 → 1.5.0

package/src/lib/i18n.js

@@ -0,0 +1,238 @@
+/**
+ * @file i18n.js
+ * @description Sistema de internacionalización para G360-CLI
+ */
+
+/**
+ * Traducciones disponibles
+ * @type {Object.<string, Object.<string, string>>}
+ */
+const translations = {
+  es: {
+    // Comandos
+    'command.init.title': '🚀 Inicialización de Proyecto G360',
+    'command.init.project': 'Proyecto',
+    'command.init.template': 'Plantilla',
+    'command.init.skill': 'Skill',
+    'command.init.target': 'Destino',
+    'command.init.success': '✅ Proyecto creado exitosamente',
+    'command.init.portable': '📦 Versión portable habilitada',
+    'command.init.next_steps': 'Próximos pasos',
+    
+    'command.list.title': '📋 Assets G360',
+    'command.list.templates': '📁 Plantillas',
+    'command.list.components': '🧩 Componentes',
+    'command.list.skills': '⚡ Skills',
+    'command.list.snippets': '📝 Snippets',
+    'command.list.no_templates': 'No se encontraron plantillas',
+    'command.list.no_components': 'No se encontraron componentes',
+    'command.list.no_skills': 'No se encontraron skills',
+    'command.list.no_snippets': 'No se encontraron snippets',
+    
+    'command.set-skill.title': '🎨 Selector de Skill G360',
+    'command.set-skill.success': '✅ Skill configurado correctamente',
+    'command.set-skill.not_found': '❌ Skill no encontrado',
+    'command.set-skill.already_exists': '⚠️ El proyecto ya tiene un skill configurado',
+    'command.set-skill.use_force': 'Usa --force para sobrescribir',
+    
+    'command.audit.title': '🔍 Auditoría de Proyecto G360',
+    'command.audit.results': '📊 Resultados de Auditoría',
+    'command.audit.passed': 'Pasaron',
+    'command.audit.failed': 'Fallaron',
+    'command.audit.warnings': 'Advertencias',
+    'command.audit.issues': 'Issues Encontrados',
+    'command.audit.compliant': '✅ El proyecto es compliant con G360',
+    'command.audit.issues_found': '⚠️ Algunos issues necesitan atención',
+    
+    'command.health.title': '🏥 Verificación de Salud G360',
+    'command.health.status': 'Estado del Sistema',
+    'command.health.healthy': '✅ El sistema está saludable',
+    'command.health.failed': '❌ Algunos checks fallaron',
+    
+    'command.clean.title': '🧹 Limpieza de Proyecto G360',
+    'command.clean.preview': '📋 DRY RUN - No se eliminarán archivos',
+    'command.clean.success': '✅ Limpieza completada',
+    
+    // Errores
+    'error.templates_not_found': '❌ Plantillas no encontradas. Ejecuta: g360 update',
+    'error.template_not_found': '❌ Plantilla no encontrada',
+    'error.directory_exists': '❌ El directorio ya existe. Usa --force para sobrescribir',
+    'error.path_not_found': '❌ Ruta no encontrada',
+    'error.config_not_found': '❌ No se pudo cargar la configuración de skills',
+    
+    // General
+    'general.available': 'Disponibles',
+    'general.device': 'Dispositivo',
+    'general.description': 'Descripción',
+    'general.language': 'Lenguaje',
+    'general.loading': 'Cargando...',
+    'general.done': 'Completado',
+    'general.cancelled': 'Cancelado',
+    'general.error': 'Error',
+    'general.warning': 'Advertencia',
+    'general.info': 'Información',
+    'general.success': 'Éxito'
+  },
+  
+  en: {
+    // Commands
+    'command.init.title': '🚀 G360 Project Initialization',
+    'command.init.project': 'Project',
+    'command.init.template': 'Template',
+    'command.init.skill': 'Skill',
+    'command.init.target': 'Target',
+    'command.init.success': '✅ Project created successfully',
+    'command.init.portable': '📦 Portable version enabled',
+    'command.init.next_steps': 'Next steps',
+    
+    'command.list.title': '📋 G360 Assets',
+    'command.list.templates': '📁 Templates',
+    'command.list.components': '🧩 Components',
+    'command.list.skills': '⚡ Skills',
+    'command.list.snippets': '📝 Snippets',
+    'command.list.no_templates': 'No templates found',
+    'command.list.no_components': 'No components found',
+    'command.list.no_skills': 'No skills found',
+    'command.list.no_snippets': 'No snippets found',
+    
+    'command.set-skill.title': '🎨 G360 Skill Selector',
+    'command.set-skill.success': '✅ Skill configured successfully',
+    'command.set-skill.not_found': '❌ Skill not found',
+    'command.set-skill.already_exists': '⚠️ Project already has a skill configured',
+    'command.set-skill.use_force': 'Use --force to overwrite',
+    
+    'command.audit.title': '🔍 G360 Project Audit',
+    'command.audit.results': '📊 Audit Results',
+    'command.audit.passed': 'Passed',
+    'command.audit.failed': 'Failed',
+    'command.audit.warnings': 'Warnings',
+    'command.audit.issues': 'Issues Found',
+    'command.audit.compliant': '✅ Project is G360 compliant',
+    'command.audit.issues_found': '⚠️ Some issues need attention',
+    
+    'command.health.title': '🏥 G360 Health Check',
+    'command.health.status': 'System Status',
+    'command.health.healthy': '✅ System is healthy',
+    'command.health.failed': '❌ Some checks failed',
+    
+    'command.clean.title': '🧹 G360 Project Clean',
+    'command.clean.preview': '📋 DRY RUN - No files will be removed',
+    'command.clean.success': '✅ Cleanup completed',
+    
+    // Errors
+    'error.templates_not_found': '❌ Templates not found. Run: g360 update',
+    'error.template_not_found': '❌ Template not found',
+    'error.directory_exists': '❌ Directory already exists. Use --force to overwrite',
+    'error.path_not_found': '❌ Path not found',
+    'error.config_not_found': '❌ Could not load skills configuration',
+    
+    // General
+    'general.available': 'Available',
+    'general.device': 'Device',
+    'general.description': 'Description',
+    'general.language': 'Language',
+    'general.loading': 'Loading...',
+    'general.done': 'Done',
+    'general.cancelled': 'Cancelled',
+    'general.error': 'Error',
+    'general.warning': 'Warning',
+    'general.info': 'Info',
+    'general.success': 'Success'
+  }
+};
+
+/**
+ * Idioma actual
+ * @type {string}
+ */
+let currentLanguage = 'es';
+
+/**
+ * Módulo de internacionalización para G360-CLI
+ * @namespace i18n
+ */
+export const i18n = {
+  /**
+   * Establece el idioma actual
+   * @param {string} language - Código de idioma ('es' | 'en')
+   * @returns {void}
+   * @example
+   * i18n.setLanguage('en');
+   */
+  setLanguage(language) {
+    if (translations[language]) {
+      currentLanguage = language;
+    } else {
+      console.warn(`Language '${language}' not supported, using 'es'`);
+    }
+  },
+
+  /**
+   * Obtiene el idioma actual
+   * @returns {string} Código de idioma actual
+   * @example
+   * const lang = i18n.getLanguage();
+   */
+  getLanguage() {
+    return currentLanguage;
+  },
+
+  /**
+   * Traduce una clave de texto
+   * @param {string} key - Clave de traducción
+   * @param {Object} [params] - Parámetros para interpolación
+   * @returns {string} Texto traducido
+   * @example
+   * const text = i18n.t('command.init.success');
+   * const text = i18n.t('command.init.project', { name: 'my-project' });
+   */
+  t(key, params = {}) {
+    const lang = translations[currentLanguage] || translations.es;
+    let text = lang[key] || translations.es[key] || key;
+    
+    // Interpolación de parámetros
+    Object.keys(params).forEach(param => {
+      text = text.replace(`{${param}}`, params[param]);
+    });
+    
+    return text;
+  },
+
+  /**
+   * Verifica si una clave de traducción existe
+   * @param {string} key - Clave de traducción
+   * @returns {boolean} true si existe, false en caso contrario
+   * @example
+   * if (i18n.has('command.init.success')) {
+   *   console.log(i18n.t('command.init.success'));
+   * }
+   */
+  has(key) {
+    const lang = translations[currentLanguage] || translations.es;
+    return key in lang;
+  },
+
+  /**
+   * Obtiene todos los idiomas disponibles
+   * @returns {string[]} Lista de códigos de idioma
+   * @example
+   * const languages = i18n.getAvailableLanguages();
+   * console.log('Available languages:', languages);
+   */
+  getAvailableLanguages() {
+    return Object.keys(translations);
+  },
+
+  /**
+   * Obtiene las traducciones para un idioma específico
+   * @param {string} language - Código de idioma
+   * @returns {Object|null} Objeto de traducciones o null si no existe
+   * @example
+   * const esTranslations = i18n.getTranslations('es');
+   */
+  getTranslations(language) {
+    return translations[language] || null;
+  }
+};
+
+export default i18n;

package/src/lib/logger.js

@@ -0,0 +1,100 @@
+import winston from 'winston';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Niveles de log disponibles
+ * @enum {string}
+ */
+const LogLevel = {
+  ERROR: 'error',
+  WARN: 'warn',
+  INFO: 'info',
+  DEBUG: 'debug'
+};
+
+/**
+ * Formato personalizado para logs
+ * @param {Object} info - Información del log
+ * @returns {string} Log formateado
+ */
+const customFormat = winston.format.combine(
+  winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
+  winston.format.errors({ stack: true }),
+  winston.format.printf(({ level, message, timestamp, ...metadata }) => {
+    let msg = `${timestamp} [${level.toUpperCase()}]: ${message}`;
+    
+    if (Object.keys(metadata).length > 0) {
+      msg += ` ${JSON.stringify(metadata)}`;
+    }
+    
+    return msg;
+  })
+);
+
+/**
+ * Logger configurado para G360-CLI
+ * @type {winston.Logger}
+ */
+export const logger = winston.createLogger({
+  level: process.env.LOG_LEVEL || 'info',
+  format: customFormat,
+  transports: [
+    // Console transport para desarrollo
+    new winston.transports.Console({
+      format: winston.format.combine(
+        winston.format.colorize(),
+        customFormat
+      )
+    }),
+    
+    // File transport para logs persistentes
+    new winston.transports.File({
+      filename: path.join(__dirname, '../../logs/g360-cli.log'),
+      level: 'info',
+      maxsize: 5242880, // 5MB
+      maxFiles: 3
+    }),
+    
+    // Error file transport
+    new winston.transports.File({
+      filename: path.join(__dirname, '../../logs/error.log'),
+      level: 'error',
+      maxsize: 5242880, // 5MB
+      maxFiles: 3
+    })
+  ]
+});
+
+/**
+ * Crea un logger hijo con contexto específico
+ * @param {string} context - Contexto del logger
+ * @returns {winston.Logger} Logger hijo con contexto
+ */
+export function createChildLogger(context) {
+  return logger.child({ context });
+}
+
+/**
+ * Logger para comandos CLI
+ */
+export const commandLogger = createChildLogger('command');
+
+/**
+ * Logger para operaciones de archivos
+ */
+export const fileLogger = createChildLogger('file');
+
+/**
+ * Logger para validaciones
+ */
+export const validationLogger = createChildLogger('validation');
+
+/**
+ * Logger para auditoría
+ */
+export const auditLogger = createChildLogger('audit');
+
+export default logger;

package/src/lib/manifest.js

@@ -1,7 +1,42 @@
 import fs from 'fs-extra';
 import path from 'path';
 
+/**
+ * @typedef {Object} ProjectManifest
+ * @property {string} name - Nombre del proyecto
+ * @property {string} template - Plantilla utilizada
+ * @property {string} version - Versión del proyecto
+ * @property {string} createdAt - Fecha de creación en formato ISO
+ * @property {Asset[]} assets - Lista de assets del proyecto
+ */
+
+/**
+ * @typedef {Object} Asset
+ * @property {string} name - Nombre del asset
+ * @property {string} type - Tipo del asset
+ * @property {string} addedAt - Fecha de adición en formato ISO
+ */
+
+/**
+ * Módulo para gestión de manifiestos de proyectos G360
+ * @namespace manifest
+ */
 export const manifest = {
+  /**
+   * Inicializa un nuevo manifiesto de proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @param {Object} data - Datos del proyecto
+   * @param {string} data.name - Nombre del proyecto
+   * @param {string} data.template - Plantilla utilizada
+   * @param {string} data.version - Versión del proyecto
+   * @returns {Promise<ProjectManifest>} Manifiesto creado
+   * @example
+   * const manifest = await manifest.init('/my/project', {
+   *   name: 'my-project',
+   *   template: 'web-pwa',
+   *   version: '1.0.0'
+   * });
+   */
   async init(projectDir, data) {
     const manifestPath = path.join(projectDir, 'g360-manifest.json');
     const manifest = {
@@ -15,14 +50,41 @@ export const manifest = {
     return manifest;
   },
 
+  /**
+   * Carga el manifiesto de un proyecto existente
+   * @param {string} projectDir - Directorio del proyecto
+   * @returns {Promise<ProjectManifest|null>} Manifiesto del proyecto o null si no existe
+   * @example
+   * const manifest = await manifest.load('/my/project');
+   * if (manifest) {
+   *   console.log('Proyecto:', manifest.name);
+   * }
+   */
   async load(projectDir) {
     const manifestPath = path.join(projectDir, 'g360-manifest.json');
     if (fs.existsSync(manifestPath)) {
-      return fs.readJson(manifestPath);
+      try {
+        return await fs.readJson(manifestPath);
+      } catch (error) {
+        return null;
+      }
     }
     return null;
   },
 
+  /**
+   * Agrega un asset al manifiesto del proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @param {Object} asset - Asset a agregar
+   * @param {string} asset.name - Nombre del asset
+   * @param {string} asset.type - Tipo del asset
+   * @returns {Promise<void>}
+   * @example
+   * await manifest.addAsset('/my/project', {
+   *   name: 'components',
+   *   type: 'directory'
+   * });
+   */
   async addAsset(projectDir, asset) {
     const data = await this.load(projectDir);
     if (data) {
@@ -34,6 +96,13 @@ export const manifest = {
     }
   },
 
+  /**
+   * Elimina el manifiesto del proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @returns {Promise<void>}
+   * @example
+   * await manifest.remove('/my/project');
+   */
   async remove(projectDir) {
     const manifestPath = path.join(projectDir, 'g360-manifest.json');
     if (fs.existsSync(manifestPath)) {

package/src/lib/validator.js

@@ -1,10 +1,37 @@
 import fs from 'fs-extra';
 
+/**
+ * @typedef {Object} ValidationResult
+ * @property {boolean} valid - Indica si la validación fue exitosa
+ * @property {string[]} errors - Lista de errores encontrados
+ * @property {string[]} warnings - Lista de advertencias encontradas
+ */
+
+/**
+ * Módulo de validación para proyectos G360
+ * @namespace validator
+ */
 export const validator = {
+  /**
+   * Valida si un nombre de proyecto es válido
+   * @param {string} name - Nombre del proyecto a validar
+   * @returns {boolean} true si el nombre es válido, false en caso contrario
+   * @example
+   * validator.isValidProjectName('my-project') // true
+   * validator.isValidProjectName('My-Project') // false
+   */
   isValidProjectName(name) {
     return /^[a-z0-9][a-z0-9-]*$/.test(name);
   },
 
+  /**
+   * Valida si una ruta existe en el sistema de archivos
+   * @param {string} path - Ruta a validar
+   * @returns {boolean} true si la ruta existe, false en caso contrario
+   * @example
+   * validator.isValidPath('/existing/path') // true
+   * validator.isValidPath('/non/existing') // false
+   */
   isValidPath(path) {
     try {
       return fs.existsSync(path);
@@ -13,6 +40,18 @@ export const validator = {
     }
   },
 
+  /**
+   * Valida si un directorio es un proyecto G360 válido
+   * @param {string} projectDir - Ruta del directorio del proyecto
+   * @returns {ValidationResult} Objeto con resultado de la validación
+   * @example
+   * const result = validator.validateProject('/my/project');
+   * if (result.valid) {
+   *   console.log('Proyecto válido');
+   * } else {
+   *   console.error('Errores:', result.errors);
+   * }
+   */
   validateProject(projectDir) {
     const errors = [];
     const warnings = [];

package/src/schemas/skills-schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"skills":{"items":{"properties":{"colors":{"properties":{"accent":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"bg":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"muted":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"surface":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"text":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"}},"required":["bg","surface","accent","text","muted"],"type":"object"},"description":{"minLength":1,"type":"string"},"device":{"enum":["pc","movil","both"],"type":"string"},"name":{"pattern":"^[a-z0-9-]+$","type":"string"},"signature":{"properties":{"mode":{"enum":["powered","own","optional","custom"],"type":"string"},"text":{"minLength":1,"type":"string"}},"required":["mode","text"],"type":"object"}},"required":["name","description","device","colors","signature"],"type":"object"},"type":"array"}},"required":["skills"],"title":"G360 Skills Configuration","type":"object"}

package/src/schemas/snippets-schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"snippets":{"items":{"properties":{"code":{"minLength":1,"type":"string"},"description":{"minLength":1,"type":"string"},"language":{"minLength":1,"type":"string"},"name":{"pattern":"^[a-z0-9-]+$","type":"string"}},"required":["name","description","code"],"type":"object"},"type":"array"}},"required":["snippets"],"title":"G360 Snippets Configuration","type":"object"}

package/src/assets/templates/web-pwa/app.js

@@ -1 +0,0 @@
-console.log('G360 Project initialized');

package/src/assets/templates/web-pwa/styles.css

@@ -1,28 +0,0 @@
-:root {
-  --g360-primary: #3B82F6;
-  --g360-secondary: #10B981;
-  --g360-accent: #8B5CF6;
-  --g360-bg: #ffffff;
-  --g360-text: #1f2937;
-}
-
-* { box-sizing: border-box; margin: 0; padding: 0; }
-
-body {
-  font-family: system-ui, sans-serif;
-  background: var(--g360-bg);
-  color: var(--g360-text);
-  line-height: 1.6;
-}
-
-.g360-header {
-  background: var(--g360-primary);
-  color: white;
-  padding: 1rem 2rem;
-}
-
-.g360-footer {
-  text-align: center;
-  padding: 1rem;
-  color: #6b7280;
-}