awc-zns-mtd 2.8.0 → 2.10.0

package/tools/version/update-checker.js

@@ -17,11 +17,7 @@ class UpdateChecker {
    * @param {object} options - Opciones de verificación
    */
   async checkForUpdates(options = {}) {
-    const {
-      registry = 'https://registry.npmjs.org',
-      includePrerelease = false,
-      timeout = 5000
-    } = options;
+    const { registry = 'https://registry.npmjs.org', timeout = 5000 } = options;
 
     try {
       // En producción, esto consultaría el registro de npm
@@ -65,7 +61,7 @@ class UpdateChecker {
    * Obtiene la última versión disponible
    * @private
    */
-  async fetchLatestVersion(registry, timeout) {
+  async fetchLatestVersion(_registry, _timeout) {
     // Simulación - en producción haría fetch real al registro
     // const url = `${registry}/${versionManager.packageName}/latest`;
 
@@ -95,10 +91,10 @@ class UpdateChecker {
    */
   getUpdateSeverity(changeType) {
     const severities = {
-      'major': 'critical',    // Breaking changes
-      'minor': 'important',   // New features
-      'patch': 'low',         // Bug fixes
-      'none': 'none'
+      major: 'critical', // Breaking changes
+      minor: 'important', // New features
+      patch: 'low', // Bug fixes
+      none: 'none'
     };
 
     return severities[changeType] || 'none';
@@ -109,7 +105,9 @@ class UpdateChecker {
    * @param {Date} lastCheck - Última vez que se verificó
    */
   shouldCheckForUpdates(lastCheck) {
-    if (!lastCheck) return true;
+    if (!lastCheck) {
+      return true;
+    }
 
     const now = new Date();
     const timeSinceLastCheck = now - new Date(lastCheck);
@@ -132,20 +130,23 @@ class UpdateChecker {
     }
 
     const messages = {
-      'critical': `🚨 ACTUALIZACIÓN CRÍTICA DISPONIBLE: v${updateInfo.latestVersion}\n` +
-                  `   Versión actual: v${updateInfo.currentVersion}\n` +
-                  `   Esta actualización incluye cambios importantes (breaking changes).\n` +
-                  `   Actualiza con: npm install -g awc-zns-mtd@latest`,
-
-      'important': `⚡ Nueva versión disponible: v${updateInfo.latestVersion}\n` +
-                   `   Versión actual: v${updateInfo.currentVersion}\n` +
-                   `   Incluye nuevas funcionalidades.\n` +
-                   `   Actualiza con: npm install -g awc-zns-mtd@latest`,
-
-      'low': `💡 Actualización disponible: v${updateInfo.latestVersion}\n` +
-             `   Versión actual: v${updateInfo.currentVersion}\n` +
-             `   Incluye correcciones de bugs.\n` +
-             `   Actualiza con: npm install -g awc-zns-mtd@latest`
+      critical:
+        `🚨 ACTUALIZACIÓN CRÍTICA DISPONIBLE: v${updateInfo.latestVersion}\n` +
+        `   Versión actual: v${updateInfo.currentVersion}\n` +
+        '   Esta actualización incluye cambios importantes (breaking changes).\n' +
+        '   Actualiza con: npm install -g awc-zns-mtd@latest',
+
+      important:
+        `⚡ Nueva versión disponible: v${updateInfo.latestVersion}\n` +
+        `   Versión actual: v${updateInfo.currentVersion}\n` +
+        '   Incluye nuevas funcionalidades.\n' +
+        '   Actualiza con: npm install -g awc-zns-mtd@latest',
+
+      low:
+        `💡 Actualización disponible: v${updateInfo.latestVersion}\n` +
+        `   Versión actual: v${updateInfo.currentVersion}\n` +
+        '   Incluye correcciones de bugs.\n' +
+        '   Actualiza con: npm install -g awc-zns-mtd@latest'
     };
 
     return {
@@ -184,9 +185,7 @@ class UpdateChecker {
     // Verificar compatibilidad de Node.js
     const requiredNode = versionManager.getVersionInfo().compatibility?.minimumNodeVersion;
     if (requiredNode) {
-      compatibility.recommendations.push(
-        `Asegúrate de tener Node.js ${requiredNode} o superior`
-      );
+      compatibility.recommendations.push(`Asegúrate de tener Node.js ${requiredNode} o superior`);
     }
 
     return compatibility;
@@ -195,7 +194,7 @@ class UpdateChecker {
   /**
    * Obtiene historial de versiones
    */
-  async getVersionHistory(limit = 10) {
+  async getVersionHistory() {
     // En producción, esto consultaría el registro real
     return {
       current: this.currentVersion,
@@ -217,11 +216,12 @@ class UpdateChecker {
   async isVersionDeprecated() {
     const updateInfo = await this.checkForUpdates();
 
-    if (!updateInfo.hasUpdate) return false;
+    if (!updateInfo.hasUpdate) {
+      return false;
+    }
 
     // Versión deprecada si hay 2+ major versions de diferencia
-    const majorDiff = semver.major(updateInfo.latestVersion) -
-                     semver.major(this.currentVersion);
+    const majorDiff = semver.major(updateInfo.latestVersion) - semver.major(this.currentVersion);
 
     return majorDiff >= 2;
   }

package/tools/version/version-bump.js

@@ -1,90 +1,89 @@
-#!/usr/bin/env node
-
-/**
- * Version Bump Script
- * Script para incrementar versión del proyecto AWC ZNS-MTD
- * 
- * Uso:
- *   node version-bump.js <major|minor|patch> [--message "mensaje"]
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const versionManager = require('./version-manager');
-const changelogManager = require('./changelog-manager');
-
-async function bumpVersion() {
-  // Parsear argumentos
-  const args = process.argv.slice(2);
-  
-  if (args.length === 0) {
-    console.error('❌ Uso: node version-bump.js <major|minor|patch> [--message "mensaje"]');
-    process.exit(1);
-  }
-
-  const bumpType = args[0];
-  const validTypes = ['major', 'minor', 'patch'];
-
-  if (!validTypes.includes(bumpType)) {
-    console.error(`❌ Tipo inválido: ${bumpType}`);
-    console.error(`   Tipos válidos: ${validTypes.join(', ')}`);
-    process.exit(1);
-  }
-
-  // Obtener mensaje personalizado si existe
-  const messageIndex = args.indexOf('--message');
-  const customMessage = messageIndex !== -1 ? args[messageIndex + 1] : null;
-
-  try {
-    console.log('🚀 Incrementando versión...\n');
-
-    // Obtener versión actual
-    const currentVersion = versionManager.getCurrentVersion();
-    console.log(`   Versión actual: ${currentVersion}`);
-
-    // Calcular nueva versión
-    const newVersion = versionManager.incrementVersion(bumpType);
-    console.log(`   Nueva versión:  ${newVersion}`);
-    console.log(`   Tipo de cambio: ${bumpType}\n`);
-
-    // Actualizar package.json
-    const packageJsonPath = path.join(__dirname, '../../package.json');
-    const packageJson = await fs.readJSON(packageJsonPath);
-    packageJson.version = newVersion;
-    await fs.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
-    console.log('✓ package.json actualizado');
-
-    // Generar entrada de changelog
-    const date = new Date().toISOString().split('T')[0];
-    const changes = {
-      added: [],
-      changed: [`Versión incrementada de ${currentVersion} a ${newVersion}`],
-      deprecated: [],
-      removed: [],
-      fixed: [],
-      security: []
-    };
-
-    if (customMessage) {
-      changes.added.push(customMessage);
-    }
-
-    await changelogManager.addVersion(newVersion, date, changes);
-    console.log('✓ CHANGELOG.md actualizado');
-
-    // Resumen
-    console.log('\n✅ Versión incrementada exitosamente\n');
-    console.log('📋 Próximos pasos:');
-    console.log('   1. Revisa los cambios en CHANGELOG.md');
-    console.log('   2. Commit: git add . && git commit -m "chore: bump version to ' + newVersion + '"');
-    console.log('   3. Tag: git tag -a v' + newVersion + ' -m "Release v' + newVersion + '"');
-    console.log('   4. Push: git push && git push --tags\n');
-
-  } catch (error) {
-    console.error('❌ Error al incrementar versión:', error.message);
-    process.exit(1);
-  }
-}
-
-// Ejecutar
-bumpVersion();
+#!/usr/bin/env node
+
+/**
+ * Version Bump Script
+ * Script para incrementar versión del proyecto AWC ZNS-MTD
+ *
+ * Uso:
+ *   node version-bump.js <major|minor|patch> [--message "mensaje"]
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const versionManager = require('./version-manager');
+const changelogManager = require('./changelog-manager');
+
+async function bumpVersion() {
+  // Parsear argumentos
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('❌ Uso: node version-bump.js <major|minor|patch> [--message "mensaje"]');
+    process.exit(1);
+  }
+
+  const bumpType = args[0];
+  const validTypes = ['major', 'minor', 'patch'];
+
+  if (!validTypes.includes(bumpType)) {
+    console.error(`❌ Tipo inválido: ${bumpType}`);
+    console.error(`   Tipos válidos: ${validTypes.join(', ')}`);
+    process.exit(1);
+  }
+
+  // Obtener mensaje personalizado si existe
+  const messageIndex = args.indexOf('--message');
+  const customMessage = messageIndex !== -1 ? args[messageIndex + 1] : null;
+
+  try {
+    console.log('🚀 Incrementando versión...\n');
+
+    // Obtener versión actual
+    const currentVersion = versionManager.getCurrentVersion();
+    console.log(`   Versión actual: ${currentVersion}`);
+
+    // Calcular nueva versión
+    const newVersion = versionManager.incrementVersion(bumpType);
+    console.log(`   Nueva versión:  ${newVersion}`);
+    console.log(`   Tipo de cambio: ${bumpType}\n`);
+
+    // Actualizar package.json
+    const packageJsonPath = path.join(__dirname, '../../package.json');
+    const packageJson = await fs.readJSON(packageJsonPath);
+    packageJson.version = newVersion;
+    await fs.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
+    console.log('✓ package.json actualizado');
+
+    // Generar entrada de changelog
+    const date = new Date().toISOString().split('T')[0];
+    const changes = {
+      added: [],
+      changed: [`Versión incrementada de ${currentVersion} a ${newVersion}`],
+      deprecated: [],
+      removed: [],
+      fixed: [],
+      security: []
+    };
+
+    if (customMessage) {
+      changes.added.push(customMessage);
+    }
+
+    await changelogManager.addVersion(newVersion, date, changes);
+    console.log('✓ CHANGELOG.md actualizado');
+
+    // Resumen
+    console.log('\n✅ Versión incrementada exitosamente\n');
+    console.log('📋 Próximos pasos:');
+    console.log('   1. Revisa los cambios en CHANGELOG.md');
+    console.log(`   2. Commit: git add . && git commit -m "chore: bump version to ${newVersion}"`);
+    console.log(`   3. Tag: git tag -a v${newVersion} -m "Release v${newVersion}"`);
+    console.log('   4. Push: git push && git push --tags\n');
+  } catch (error) {
+    console.error('❌ Error al incrementar versión:', error.message);
+    process.exit(1);
+  }
+}
+
+// Ejecutar
+bumpVersion();

package/tools/version/version-manager.js

@@ -48,8 +48,12 @@ class VersionManager {
       throw new Error('Versiones inválidas');
     }
 
-    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;
   }
 
@@ -63,7 +67,7 @@ class VersionManager {
 
     try {
       return semver.satisfies(version, requiredVersion);
-    } catch (error) {
+    } catch {
       return false;
     }
   }
@@ -81,9 +85,15 @@ class VersionManager {
 
     const diff = semver.diff(oldVersion, newVersion);
 
-    if (diff === 'major' || diff === 'premajor') return 'major';
-    if (diff === 'minor' || diff === 'preminor') return 'minor';
-    if (diff === 'patch' || diff === 'prepatch') return 'patch';
+    if (diff === 'major' || diff === 'premajor') {
+      return 'major';
+    }
+    if (diff === 'minor' || diff === 'preminor') {
+      return 'minor';
+    }
+    if (diff === 'patch' || diff === 'prepatch') {
+      return 'patch';
+    }
 
     return 'none';
   }
@@ -134,7 +144,7 @@ class VersionManager {
       const content = await fs.readFile(configPath, 'utf8');
       const config = yaml.load(content);
       return config.version || null;
-    } catch (error) {
+    } catch {
       return null;
     }
   }

package/tsconfig.json

@@ -0,0 +1,47 @@
+{
+  "compilerOptions": {
+    /* Language and Environment */
+    "target": "ES2021",
+    "lib": ["ES2021"],
+    "module": "commonjs",
+
+    /* Modules */
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+
+    /* Emit */
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "removeComments": true,
+    "newLine": "lf",
+
+    /* Interop Constraints */
+    "forceConsistentCasingInFileNames": true,
+    "allowJs": true,
+    "checkJs": false,
+
+    /* Type Checking */
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+
+    /* Completeness */
+    "skipLibCheck": true
+  },
+  "include": ["tools/**/*.ts", "tools/**/*.js", "src/**/*.ts", "src/**/*.js"],
+  "exclude": ["node_modules", "dist", "coverage", "test", "**/*.test.ts", "**/*.test.js"]
+}

package/types/index.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Type Definitions - AWC ZNS-MTD
+ * Definiciones de tipos centralizadas para el proyecto
+ */
+
+/**
+ * Metadata de un agente
+ */
+export interface AgentMetadata {
+  name: string;
+  id: string;
+  title: string;
+  version: string;
+  category: AgentCategory;
+  stack: string[];
+  author?: string;
+  description?: string;
+}
+
+/**
+ * Categorías de agentes
+ */
+export type AgentCategory = 
+  | 'core'
+  | 'development'
+  | 'qa_testing'
+  | 'product_strategy'
+  | 'support_maintenance'
+  | 'frontend'
+  | 'backend'
+  | 'infrastructure'
+  | 'architecture'
+  | 'quality'
+  | 'business'
+  | 'ai'
+  | 'documentation';
+
+/**
+ * Workflow de un agente
+ */
+export interface Workflow {
+  name: string;
+  description: string;
+  steps: WorkflowStep[];
+  deliverables?: string[];
+  estimatedTime?: string;
+}
+
+/**
+ * Paso de un workflow
+ */
+export interface WorkflowStep {
+  id: string;
+  name: string;
+  action: string;
+  inputs?: string[];
+  outputs?: string[];
+  validations?: string[];
+}
+
+/**
+ * Definición completa de un agente
+ */
+export interface Agent {
+  metadata: AgentMetadata;
+  role: string;
+  expertise: string[];
+  workflows: Workflow[];
+  deliverables: Deliverable[];
+  constraints?: string[];
+  bestPractices?: string[];
+}
+
+/**
+ * Deliverable de un agente
+ */
+export interface Deliverable {
+  name: string;
+  type: DeliverableType;
+  format: string;
+  description?: string;
+  template?: string;
+}
+
+/**
+ * Tipos de deliverables
+ */
+export type DeliverableType = 
+  | 'document'
+  | 'diagram'
+  | 'code'
+  | 'report'
+  | 'specification'
+  | 'test'
+  | 'artifact';
+
+/**
+ * Configuración del proyecto
+ */
+export interface ProjectConfig {
+  projectName: string;
+  version: string;
+  responsible: string;
+  description?: string;
+  initialized: boolean;
+  projectType?: ProjectType;
+  workflow?: WorkflowType;
+  technologies?: Technology[];
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+/**
+ * Tipos de proyecto
+ */
+export type ProjectType = 
+  | 'code-audit'
+  | 'greenfield'
+  | 'migration'
+  | 'maintenance'
+  | 'mobile'
+  | 'api'
+  | 'enterprise';
+
+/**
+ * Tipos de workflow
+ */
+export type WorkflowType = 
+  | 'quick'
+  | 'standard'
+  | 'enterprise'
+  | 'comercial-flow'
+  | 'inception-flow'
+  | 'development-flow'
+  | 'qa-flow'
+  | 'deployment-flow'
+  | 'support-flow';
+
+/**
+ * Tecnologías soportadas
+ */
+export type Technology = 
+  | 'java'
+  | 'dotnet'
+  | 'python'
+  | 'php'
+  | 'nodejs'
+  | 'react'
+  | 'angular'
+  | 'vue'
+  | 'react-native'
+  | 'sql'
+  | 'nosql';
+
+/**
+ * Opciones de comando CLI
+ */
+export interface CommandOptions {
+  force?: boolean;
+  verbose?: boolean;
+  dir?: string;
+  type?: string;
+  [key: string]: any;
+}
+
+/**
+ * Resultado de validación
+ */
+export interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings?: string[];
+}
+
+/**
+ * Información de versión
+ */
+export interface VersionInfo {
+  current: string;
+  latest?: string;
+  updateAvailable: boolean;
+  releaseNotes?: string;
+}
+
+/**
+ * Contexto de logging
+ */
+export interface LogContext {
+  command?: string;
+  options?: any;
+  timestamp: string;
+  duration?: number;
+  success?: boolean;
+  error?: Error;
+}
+
+/**
+ * Configuración de entorno
+ */
+export interface EnvironmentConfig {
+  nodeVersion: string;
+  platform: string;
+  arch: string;
+  cwd: string;
+  env: string;
+}