siesa-agents 2.1.16-dev.0 → 2.1.17

package/README.md

@@ -1,4 +1,4 @@
-# SIESA BMAD Agents
+# SIESA Agents
 
 Paquete para instalar y configurar agentes SIESA en tu proyecto.
 
@@ -52,6 +52,7 @@ El paquete instala las siguientes carpetas en tu directorio actual:
 - **`.bmad-core/`** - Archivos principales del sistema BMAD
 - **`.vscode/`** - Configuración de Visual Studio Code
 - **`.github/`** - Configuración de GitHub Actions y workflows
+- **`.claude/`** - Configuración de Claude Code Commands y workflows
 
 ## Características
 
@@ -70,22 +71,17 @@ El paquete instala las siguientes carpetas en tu directorio actual:
 
 Para actualizar una instalación existente, simplemente ejecuta el comando nuevamente:
 
-**Versión estable (recomendado):**
 ```bash
 npx siesa-agents
 ```
 
-**Versión de desarrollo:**
-```bash
-npx siesa-agents@dev
-```
-
 El sistema detectará automáticamente que ya existe una instalación y la actualizará.
 
 ## Requisitos
 
 - Node.js >= 14.0.0
 - npm >= 6.0.0
+- Python >= 3.7 (requerido para hooks de Claude Code)
 
 ## Estructura de archivos instalados
 
@@ -99,8 +95,6 @@ tu-proyecto/
     └── [workflows y configuración de GitHub]
 ```
 
-
-
 ## Soporte
 
 Si encuentras algún problema durante la instalación, por favor verifica:
@@ -115,4 +109,7 @@ MIT
 
 ## Autor
 
-SIESA - Sistemas de Información Empresarial
+SIESA - Sistemas de Información Empresarial
+
+---
+*Versión actualizada automáticamente por CI/CD*

package/bin/install.js

@@ -13,9 +13,18 @@ class SiesaBmadInstaller {
       { source: 'github', target: '.github' },
       { source: 'claude', target: '.claude' }
     ];
+    
+    // Lista de archivos que se preservan automáticamente (no se crean backups)
+    this.ignoredFiles = [
+      'data/technical-preferences.md'
+    ];
+    
     this.targetDir = process.cwd();
     // Intentar múltiples ubicaciones posibles para el paquete
     this.packageDir = this.findPackageDir();
+    
+    // Almacenamiento temporal para contenido de archivos ignorados
+    this.preservedContent = new Map();
   }
 
   showBanner() {
@@ -26,7 +35,7 @@ class SiesaBmadInstaller {
     console.log('╚════██║██║██╔══╝  ╚════██║██╔══██║    ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║');
     console.log('███████║██║███████╗███████║██║  ██║    ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║');
     console.log('╚══════╝╚═╝╚══════╝╚══════╝╚═╝  ╚═╝    ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝');
-    console.log('Version de Desarrollador');
+    console.log('');
   }
 
   findPackageDir() {
@@ -123,7 +132,8 @@ class SiesaBmadInstaller {
               modifiedFiles.push({
                 folder: mapping.target,
                 file: relativePath,
-                fullPath: targetFile
+                fullPath: targetFile,
+                is_ignored: this.ignoredFiles.includes(relativePath)
               });
             }
           } catch (error) {
@@ -135,7 +145,8 @@ class SiesaBmadInstaller {
               modifiedFiles.push({
                 folder: mapping.target,
                 file: relativePath,
-                fullPath: targetFile
+                fullPath: targetFile,
+                is_ignored: this.ignoredFiles.includes(relativePath)
               });
             }
           }
@@ -166,6 +177,10 @@ class SiesaBmadInstaller {
   }
 
   async promptUser(modifiedFiles) {
+
+    const hasNonIgnoredFiles = modifiedFiles.some(file => file.is_ignored == false)
+    if (!hasNonIgnoredFiles) return '2'
+
     console.log('\n⚠️  Se detectaron archivos modificados:');
 
     // Agrupar por carpeta
@@ -206,6 +221,12 @@ class SiesaBmadInstaller {
     console.log('\n🔄 Creando backup de archivos modificados...');
 
     for (const item of modifiedFiles) {
+      // No crear backup de archivos ignorados
+      if (item.is_ignored) {
+        console.log(`✓ Preservando: ${item.file} (sin backup)`);
+        continue;
+      }
+
       const originalPath = item.fullPath;
       const backupPath = this.getBackupPath(originalPath);
 
@@ -270,10 +291,19 @@ class SiesaBmadInstaller {
     // Obtener todos los archivos backup existentes
     const backupFiles = await this.findBackupFiles(targetPath);
     
-    // Copiar la carpeta completa sobrescribiendo
+    // Copiar la carpeta preservando technical-preferences.md
     await fs.copy(sourcePath, targetPath, {
       overwrite: true,
-      recursive: true
+      recursive: true,
+      filter: (src) => {
+        const relativePath = path.relative(sourcePath, src);
+        // No sobrescribir archivos ignorados si ya existen
+        if (this.ignoredFiles.includes(relativePath)) {
+          const targetFile = path.join(targetPath, relativePath);
+          return !fs.existsSync(targetFile);
+        }
+        return true;
+      }
     });
 
     // Restaurar los archivos backup
@@ -328,7 +358,16 @@ class SiesaBmadInstaller {
       if (fs.existsSync(sourcePath)) {
         await fs.copy(sourcePath, targetPath, {
           overwrite: true,
-          recursive: true
+          recursive: true,
+          filter: (src) => {
+            const relativePath = path.relative(sourcePath, src);
+            // No sobrescribir archivos ignorados si ya existen
+            if (this.ignoredFiles.includes(relativePath)) {
+              const targetFile = path.join(targetPath, relativePath);
+              return !fs.existsSync(targetFile);
+            }
+            return true;
+          }
         });
       } else {
         console.warn(`⚠️  Carpeta ${mapping.source} no encontrada en el paquete`);
@@ -364,6 +403,9 @@ class SiesaBmadInstaller {
       await this.performUpdateWithBackups();
     } else {
       // Si no hay backups, hacer actualización normal (remover y copiar)
+      // Pero primero preservar archivos ignorados
+      await this.preserveIgnoredFiles();
+      
       for (const mapping of this.folderMappings) {
         const targetPath = path.join(this.targetDir, mapping.target);
 
@@ -374,9 +416,66 @@ class SiesaBmadInstaller {
 
       // Realizar instalación nueva
       await this.performInstallation();
+      
+      // Restaurar archivos ignorados
+      await this.restoreIgnoredFiles();
+    }
+  }
+
+  async preserveIgnoredFiles() {
+    console.log('🔒 Preservando archivos de configuración...');
+    
+    for (const mapping of this.folderMappings) {
+      const targetFolderPath = path.join(this.targetDir, mapping.target);
+      
+      if (!fs.existsSync(targetFolderPath)) {
+        continue;
+      }
+      
+      for (const ignoredFile of this.ignoredFiles) {
+        const filePath = path.join(targetFolderPath, ignoredFile);
+        
+        if (fs.existsSync(filePath)) {
+          try {
+            const content = await fs.readFile(filePath, 'utf8');
+            const key = `${mapping.target}/${ignoredFile}`;
+            this.preservedContent.set(key, content);
+            console.log(`✓ Preservando: ${ignoredFile}`);
+          } catch (error) {
+            console.warn(`⚠️  Error leyendo ${ignoredFile}: ${error.message}`);
+          }
+        }
+      }
     }
   }
 
+  async restoreIgnoredFiles() {
+    if (this.preservedContent.size === 0) {
+      return;
+    }
+    
+    console.log('🔄 Restaurando archivos de configuración...');
+    
+    for (const [key, content] of this.preservedContent) {
+      const [targetFolder, ...filePathParts] = key.split('/');
+      const filePath = path.join(this.targetDir, targetFolder, ...filePathParts);
+      
+      try {
+        // Asegurar que el directorio existe
+        await fs.ensureDir(path.dirname(filePath));
+        
+        // Restaurar el contenido
+        await fs.writeFile(filePath, content, 'utf8');
+        console.log(`✓ Restaurado: ${filePathParts.join('/')}`);
+      } catch (error) {
+        console.warn(`⚠️  Error restaurando ${filePathParts.join('/')}: ${error.message}`);
+      }
+    }
+    
+    // Limpiar el mapa después de restaurar
+    this.preservedContent.clear();
+  }
+
   showPostInstallMessage() {
     console.log('\n📚 Carpetas instaladas:');
     this.folderMappings.forEach(mapping => {

package/bmad-core/agents/architect.md

@@ -81,6 +81,8 @@ dependencies:
     - architect-checklist.md
   data:
     - technical-preferences.md
+    - technology-stack.md
+    - architecture-patterns.md
   tasks:
     - create-deep-research-prompt.md
     - create-doc.md

package/bmad-core/agents/ux-expert.md

@@ -60,6 +60,7 @@ commands:
 dependencies:
   data:
     - technical-preferences.md
+    - technology-stack.md
   tasks:
     - create-doc.md
     - execute-checklist.md

package/bmad-core/data/architecture-patterns.md

@@ -0,0 +1,114 @@
+# Architecture Patterns & Design Decisions
+
+## Frontend Architecture
+
+### Architecture Style
+- **Clean Architecture** + **Domain-Driven Design (DDD)**
+
+### Folder Structure
+
+Next.js 15 App Router Structure with Clean Architecture + DDD:
+
+```
+├── app/                         # Next.js App Router directory
+│   ├── (dashboard)/            # Route groups for dashboard
+│   ├── sales/                  # Routes for sales module
+│   │   ├── quotes/             # Quote management pages
+│   │   └── invoices/           # Invoice pages
+│   ├── inventory/              # Inventory routes
+│   ├── globals.css             # Global styles
+│   ├── layout.tsx              # Root layout component
+│   ├── page.tsx               # Home page
+│   ├── loading.tsx            # Global loading UI
+│   └── not-found.tsx          # 404 page
+│
+├── src/
+│   ├── modules/                # Business modules following DDD
+│   │   ├── sales/              # Sales module
+│   │   │   ├── quotes/         # Quote domain
+│   │   │   │   ├── cart/       # Shopping cart feature
+│   │   │   │   │   ├── domain/
+│   │   │   │   │   │   ├── entities/
+│   │   │   │   │   │   ├── repositories/
+│   │   │   │   │   │   ├── services/
+│   │   │   │   │   │   └── types/
+│   │   │   │   │   ├── application/
+│   │   │   │   │   │   ├── use-cases/
+│   │   │   │   │   │   ├── hooks/
+│   │   │   │   │   │   └── store/
+│   │   │   │   │   ├── infrastructure/
+│   │   │   │   │   │   ├── repositories/
+│   │   │   │   │   │   ├── api/
+│   │   │   │   │   │   └── adapters/
+│   │   │   │   │   └── presentation/
+│   │   │   │   │       └── components/    # Only components, pages in app/
+│   │   │   │   └── products/              # Products feature
+│   │   │   └── billing/                   # Billing domain
+│   │   ├── inventory/                     # Inventory module
+│   │   └── users/                         # User module
+│   │
+│   ├── shared/
+│   │   ├── components/         # Reusable UI components
+│   │   ├── hooks/              # Shared hooks
+│   │   ├── utils/              # Utility functions
+│   │   ├── types/              # Common TypeScript types
+│   │   └── constants/          # App constants
+│   │
+│   ├── providers/              # React context providers
+│   ├── store/                  # Global Zustand stores
+│   └── middleware.ts           # Next.js middleware
+│
+├── lib/                        # Next.js utilities and configurations
+├── components/                 # Global UI components (alternative to src/shared)
+├── public/                     # Static assets and PWA manifest
+└── styles/                     # Additional stylesheets
+```
+
+### Core Principles
+
+#### Clean Architecture First
+Strict separation of:
+- **Domain layer** - Business entities, repositories interfaces, domain services, and types
+- **Application layer** - Use cases, hooks, and state management (Zustand stores)
+- **Infrastructure layer** - Repository implementations, API clients, and adapters
+- **Presentation layer** - UI components (pages go in `app/`, components in `presentation/`)
+
+#### Domain-Driven Design
+Business logic drives architecture decisions. Organize by business modules and domains, not technical layers.
+
+#### Component Composition
+Build complex UIs from simple, reusable components.
+
+#### Type Safety
+Leverage TypeScript for compile-time safety and developer experience.
+
+#### Performance by Design
+- Lazy loading
+- Memoization
+- Bundle optimization
+
+#### Accessibility as Standard
+WCAG 2.1 AA compliance in all components.
+
+#### Test-Driven Development
+Unit tests for all use cases and components.
+
+#### Progressive Web App
+Offline-first approach with service workers.
+
+#### Minimal and Functional
+Only build what's explicitly requested, nothing more.
+
+#### User-Centered Design
+Start with user needs and work backward to implementation.
+
+#### MCP Shadcn Available
+Use MCP to install Shadcn components instead of creating manually.
+
+### Framework Selection Rules
+
+**Default**: Always use Next.js 15 with App Router unless explicitly told otherwise.
+
+**Exceptions**: Only use pure React + Vite when user specifically mentions offline-first functionality or requests non-Next.js setup.
+
+**Reasoning**: Next.js provides better developer experience, built-in optimization, and easier deployment while maintaining PWA capabilities.

package/bmad-core/data/technology-stack.md

@@ -0,0 +1,81 @@
+# Technology Stack
+
+## Frontend Stack
+
+### Framework
+- **Next.js 15** with TypeScript (App Router)
+  - Default framework unless explicitly told otherwise
+  - Built-in Turbopack/Webpack for building
+  - File-based routing with App Router
+  - Exception: Use pure React + Vite only when user specifically mentions offline-first functionality or requests non-Next.js setup
+
+### State Management
+- **Zustand**
+
+### UI Framework & Styling
+- **Shadcn/ui** (component library)
+- **Radix UI** (primitives)
+- **TailwindCSS v4** (styling)
+
+### Architecture
+- **Clean Architecture** + **Domain-Driven Design (DDD)**
+
+### Testing
+- **Vitest** (test runner)
+- **React Testing Library** (component testing)
+- **MSW** (Mock Service Worker - API mocking)
+
+### Forms & Validation
+- **React Hook Form** (form management)
+- **Zod** (schema validation)
+
+### HTTP Client
+- **Axios** with interceptors
+
+### Progressive Web App (PWA)
+- **Next.js PWA plugin**
+- **Workbox** (service worker library)
+
+### Routing
+- **Next.js App Router** (file-based routing)
+
+## Core Principles
+
+### Clean Architecture First
+Strict separation of:
+- Domain layer
+- Application layer
+- Infrastructure layer
+- Presentation layer
+
+### Domain-Driven Design
+Business logic drives architecture decisions
+
+### Component Composition
+Build complex UIs from simple, reusable components
+
+### Type Safety
+Leverage TypeScript for compile-time safety and developer experience
+
+### Performance by Design
+- Lazy loading
+- Memoization
+- Bundle optimization
+
+### Accessibility as Standard
+WCAG 2.1 AA compliance in all components
+
+### Test-Driven Development
+Unit tests for all use cases and components
+
+### Progressive Web App
+Offline-first approach with service workers
+
+### Minimal and Functional
+Only build what's explicitly requested, nothing more
+
+### User-Centered Design
+Start with user needs and work backward to implementation
+
+### MCP Shadcn Available
+Use MCP to install Shadcn components instead of creating manually

package/claude/settings.local.json

@@ -16,41 +16,5 @@
     ],
     "deny": [],
     "ask": []
-  },
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python .claude/hooks/track-agent.py"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python .claude/hooks/file-restriction-hook.py"
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python .claude/hooks/cleanup-agent.py"
-          }
-        ]
-      }
-    ]
-  },
-  "disableAllHooks": false
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siesa-agents",
-  "version": "2.1.16-dev.0",
+  "version": "2.1.17",
   "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
   "main": "index.js",
   "bin": {

package/claude/hooks/file-restriction-hook.py

@@ -1,51 +0,0 @@
-import sys
-import json
-import os
-
-try:
-    # Leer JSON desde stdin
-    data = json.load(sys.stdin)
-
-    # Obtener información del archivo y sesión
-    file_path = data.get('tool_input', {}).get('file_path', '')
-    extension = os.path.splitext(file_path)[1].lower() if file_path else ''
-    session_id = data.get('session_id', '')
-    cwd = data.get('cwd', '')
-
-    # Construir ruta relativa al log desde el cwd
-    log_file = os.path.join(cwd, '.claude', 'logs', 'active_agents.json')
-
-    # Agentes que solo pueden escribir markdown
-    MARKDOWN_ONLY_AGENTS = ['PO', 'SM', 'PM', 'ANALYST', 'ARCHITECT', 'UX-EXPERT']
-
-    # Verificar si la sesión actual tiene un agente activo
-    if session_id and os.path.exists(log_file):
-        try:
-            with open(log_file, 'r', encoding='utf-8') as f:
-                active_agents = json.load(f)
-            
-            # Si la sesión actual tiene un agente activo
-            if session_id in active_agents:
-                agent_type = active_agents[session_id]['agent']
-                
-                # Si el agente está en la lista de solo markdown
-                if agent_type in MARKDOWN_ONLY_AGENTS:
-                    # Solo permitir archivos markdown
-                    if extension != '.md':
-                        result = {
-                            "hookSpecificOutput": {
-                                "hookEventName": "PreToolUse",
-                                "permissionDecision": "deny",
-                                "permissionDecisionReason": f"⛔ El agente de tipo {agent_type} solo puede redactar archivos markdown"
-                            }
-                        }
-                        print(json.dumps(result))
-                        sys.exit(0)
-        except:
-            # Si hay error leyendo el log, permitir la operación
-            pass
-
-    # Si no está bloqueado, permitir la operación (no imprimir nada)
-except Exception as e:
-    # En caso de error, permitir la operación
-    pass

package/claude/hooks/track-agent.py

@@ -1,67 +0,0 @@
-import sys
-import json
-import os
-from datetime import datetime
-
-try:
-    # Leer JSON desde stdin
-    data = json.load(sys.stdin)
-    
-    session_id = data.get('session_id', '')
-    prompt = data.get('prompt', '').lower()
-    cwd = data.get('cwd', '')
-    
-    # Construir ruta relativa al log desde el cwd
-    log_file = os.path.join(cwd, '.claude', 'logs', 'active_agents.json')
-    
-    # Crear directorio si no existe
-    log_dir = os.path.dirname(log_file)
-    os.makedirs(log_dir, exist_ok=True)
-    
-    # Lista completa de agentes disponibles
-    agent_identifiers = {
-        'agents:po': 'PO',
-        'agents:sm': 'SM',
-        'agents:pm': 'PM',
-        'agents:analyst': 'ANALYST',
-        'agents:architect': 'ARCHITECT',
-        'agents:dev': 'DEV',
-        'agents:backend': 'BACKEND',
-        'agents:frontend': 'FRONTEND',
-        'agents:qa': 'QA',
-        'agents:ux-expert': 'UX-EXPERT',
-        'agents:bmad-master': 'BMAD-MASTER',
-        'agents:bmad-orchestrator': 'BMAD-ORCHESTRATOR'
-    }
-    
-    # Detectar si se está invocando un agente
-    agent_type = None
-    for identifier, agent_name in agent_identifiers.items():
-        if identifier in prompt or f'/bmad:{identifier}' in prompt:
-            agent_type = agent_name
-            break
-    
-    if agent_type and session_id:
-        # Leer log existente
-        active_agents = {}
-        if os.path.exists(log_file):
-            try:
-                with open(log_file, 'r', encoding='utf-8') as f:
-                    active_agents = json.load(f)
-            except:
-                active_agents = {}
-        
-        # Actualizar o agregar la sesión con el agente actual
-        active_agents[session_id] = {
-            'agent': agent_type,
-            'timestamp': datetime.now().isoformat(),
-            'last_prompt': prompt[:100]  # Guardar inicio del prompt para debug
-        }
-        
-        # Guardar log actualizado
-        with open(log_file, 'w', encoding='utf-8') as f:
-            json.dump(active_agents, f, indent=2, ensure_ascii=False)
-
-except Exception as e:
-    # En caso de error, no bloquear la operación
-    pass