siesa-agents 2.1.16 → 2.1.17-dev.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # SIESA Agents
1
+ # SIESA BMAD Agents
2
2
 
3
3
  Paquete para instalar y configurar agentes SIESA en tu proyecto.
4
4
 
@@ -52,7 +52,6 @@ El paquete instala las siguientes carpetas en tu directorio actual:
52
52
  - **`.bmad-core/`** - Archivos principales del sistema BMAD
53
53
  - **`.vscode/`** - Configuración de Visual Studio Code
54
54
  - **`.github/`** - Configuración de GitHub Actions y workflows
55
- - **`.claude/`** - Configuración de Claude Code Commands y workflows
56
55
 
57
56
  ## Características
58
57
 
@@ -71,17 +70,22 @@ El paquete instala las siguientes carpetas en tu directorio actual:
71
70
 
72
71
  Para actualizar una instalación existente, simplemente ejecuta el comando nuevamente:
73
72
 
73
+ **Versión estable (recomendado):**
74
74
  ```bash
75
75
  npx siesa-agents
76
76
  ```
77
77
 
78
+ **Versión de desarrollo:**
79
+ ```bash
80
+ npx siesa-agents@dev
81
+ ```
82
+
78
83
  El sistema detectará automáticamente que ya existe una instalación y la actualizará.
79
84
 
80
85
  ## Requisitos
81
86
 
82
87
  - Node.js >= 14.0.0
83
88
  - npm >= 6.0.0
84
- - Python >= 3.7 (requerido para hooks de Claude Code)
85
89
 
86
90
  ## Estructura de archivos instalados
87
91
 
@@ -95,6 +99,8 @@ tu-proyecto/
95
99
  └── [workflows y configuración de GitHub]
96
100
  ```
97
101
 
102
+
103
+
98
104
  ## Soporte
99
105
 
100
106
  Si encuentras algún problema durante la instalación, por favor verifica:
@@ -109,7 +115,4 @@ MIT
109
115
 
110
116
  ## Autor
111
117
 
112
- SIESA - Sistemas de Información Empresarial
113
-
114
- ---
115
- *Versión actualizada automáticamente por CI/CD*
118
+ SIESA - Sistemas de Información Empresarial
package/bin/install.js CHANGED
@@ -13,18 +13,9 @@ class SiesaBmadInstaller {
13
13
  { source: 'github', target: '.github' },
14
14
  { source: 'claude', target: '.claude' }
15
15
  ];
16
-
17
- // Lista de archivos que se preservan automáticamente (no se crean backups)
18
- this.ignoredFiles = [
19
- 'data/technical-preferences.md'
20
- ];
21
-
22
16
  this.targetDir = process.cwd();
23
17
  // Intentar múltiples ubicaciones posibles para el paquete
24
18
  this.packageDir = this.findPackageDir();
25
-
26
- // Almacenamiento temporal para contenido de archivos ignorados
27
- this.preservedContent = new Map();
28
19
  }
29
20
 
30
21
  showBanner() {
@@ -35,7 +26,7 @@ class SiesaBmadInstaller {
35
26
  console.log('╚════██║██║██╔══╝ ╚════██║██╔══██║ ██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ╚════██║');
36
27
  console.log('███████║██║███████╗███████║██║ ██║ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ███████║');
37
28
  console.log('╚══════╝╚═╝╚══════╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚══════╝');
38
- console.log('');
29
+ console.log('Version de Desarrollador');
39
30
  }
40
31
 
41
32
  findPackageDir() {
@@ -132,8 +123,7 @@ class SiesaBmadInstaller {
132
123
  modifiedFiles.push({
133
124
  folder: mapping.target,
134
125
  file: relativePath,
135
- fullPath: targetFile,
136
- is_ignored: this.ignoredFiles.includes(relativePath)
126
+ fullPath: targetFile
137
127
  });
138
128
  }
139
129
  } catch (error) {
@@ -145,8 +135,7 @@ class SiesaBmadInstaller {
145
135
  modifiedFiles.push({
146
136
  folder: mapping.target,
147
137
  file: relativePath,
148
- fullPath: targetFile,
149
- is_ignored: this.ignoredFiles.includes(relativePath)
138
+ fullPath: targetFile
150
139
  });
151
140
  }
152
141
  }
@@ -177,10 +166,6 @@ class SiesaBmadInstaller {
177
166
  }
178
167
 
179
168
  async promptUser(modifiedFiles) {
180
-
181
- const hasNonIgnoredFiles = modifiedFiles.some(file => file.is_ignored == false)
182
- if (!hasNonIgnoredFiles) return '2'
183
-
184
169
  console.log('\n⚠️ Se detectaron archivos modificados:');
185
170
 
186
171
  // Agrupar por carpeta
@@ -221,12 +206,6 @@ class SiesaBmadInstaller {
221
206
  console.log('\n🔄 Creando backup de archivos modificados...');
222
207
 
223
208
  for (const item of modifiedFiles) {
224
- // No crear backup de archivos ignorados
225
- if (item.is_ignored) {
226
- console.log(`✓ Preservando: ${item.file} (sin backup)`);
227
- continue;
228
- }
229
-
230
209
  const originalPath = item.fullPath;
231
210
  const backupPath = this.getBackupPath(originalPath);
232
211
 
@@ -291,19 +270,10 @@ class SiesaBmadInstaller {
291
270
  // Obtener todos los archivos backup existentes
292
271
  const backupFiles = await this.findBackupFiles(targetPath);
293
272
 
294
- // Copiar la carpeta preservando technical-preferences.md
273
+ // Copiar la carpeta completa sobrescribiendo
295
274
  await fs.copy(sourcePath, targetPath, {
296
275
  overwrite: true,
297
- recursive: true,
298
- filter: (src) => {
299
- const relativePath = path.relative(sourcePath, src);
300
- // No sobrescribir archivos ignorados si ya existen
301
- if (this.ignoredFiles.includes(relativePath)) {
302
- const targetFile = path.join(targetPath, relativePath);
303
- return !fs.existsSync(targetFile);
304
- }
305
- return true;
306
- }
276
+ recursive: true
307
277
  });
308
278
 
309
279
  // Restaurar los archivos backup
@@ -358,16 +328,7 @@ class SiesaBmadInstaller {
358
328
  if (fs.existsSync(sourcePath)) {
359
329
  await fs.copy(sourcePath, targetPath, {
360
330
  overwrite: true,
361
- recursive: true,
362
- filter: (src) => {
363
- const relativePath = path.relative(sourcePath, src);
364
- // No sobrescribir archivos ignorados si ya existen
365
- if (this.ignoredFiles.includes(relativePath)) {
366
- const targetFile = path.join(targetPath, relativePath);
367
- return !fs.existsSync(targetFile);
368
- }
369
- return true;
370
- }
331
+ recursive: true
371
332
  });
372
333
  } else {
373
334
  console.warn(`⚠️ Carpeta ${mapping.source} no encontrada en el paquete`);
@@ -403,9 +364,6 @@ class SiesaBmadInstaller {
403
364
  await this.performUpdateWithBackups();
404
365
  } else {
405
366
  // Si no hay backups, hacer actualización normal (remover y copiar)
406
- // Pero primero preservar archivos ignorados
407
- await this.preserveIgnoredFiles();
408
-
409
367
  for (const mapping of this.folderMappings) {
410
368
  const targetPath = path.join(this.targetDir, mapping.target);
411
369
 
@@ -416,66 +374,9 @@ class SiesaBmadInstaller {
416
374
 
417
375
  // Realizar instalación nueva
418
376
  await this.performInstallation();
419
-
420
- // Restaurar archivos ignorados
421
- await this.restoreIgnoredFiles();
422
- }
423
- }
424
-
425
- async preserveIgnoredFiles() {
426
- console.log('🔒 Preservando archivos de configuración...');
427
-
428
- for (const mapping of this.folderMappings) {
429
- const targetFolderPath = path.join(this.targetDir, mapping.target);
430
-
431
- if (!fs.existsSync(targetFolderPath)) {
432
- continue;
433
- }
434
-
435
- for (const ignoredFile of this.ignoredFiles) {
436
- const filePath = path.join(targetFolderPath, ignoredFile);
437
-
438
- if (fs.existsSync(filePath)) {
439
- try {
440
- const content = await fs.readFile(filePath, 'utf8');
441
- const key = `${mapping.target}/${ignoredFile}`;
442
- this.preservedContent.set(key, content);
443
- console.log(`✓ Preservando: ${ignoredFile}`);
444
- } catch (error) {
445
- console.warn(`⚠️ Error leyendo ${ignoredFile}: ${error.message}`);
446
- }
447
- }
448
- }
449
377
  }
450
378
  }
451
379
 
452
- async restoreIgnoredFiles() {
453
- if (this.preservedContent.size === 0) {
454
- return;
455
- }
456
-
457
- console.log('🔄 Restaurando archivos de configuración...');
458
-
459
- for (const [key, content] of this.preservedContent) {
460
- const [targetFolder, ...filePathParts] = key.split('/');
461
- const filePath = path.join(this.targetDir, targetFolder, ...filePathParts);
462
-
463
- try {
464
- // Asegurar que el directorio existe
465
- await fs.ensureDir(path.dirname(filePath));
466
-
467
- // Restaurar el contenido
468
- await fs.writeFile(filePath, content, 'utf8');
469
- console.log(`✓ Restaurado: ${filePathParts.join('/')}`);
470
- } catch (error) {
471
- console.warn(`⚠️ Error restaurando ${filePathParts.join('/')}: ${error.message}`);
472
- }
473
- }
474
-
475
- // Limpiar el mapa después de restaurar
476
- this.preservedContent.clear();
477
- }
478
-
479
380
  showPostInstallMessage() {
480
381
  console.log('\n📚 Carpetas instaladas:');
481
382
  this.folderMappings.forEach(mapping => {
@@ -81,8 +81,6 @@ dependencies:
81
81
  - architect-checklist.md
82
82
  data:
83
83
  - technical-preferences.md
84
- - technology-stack.md
85
- - architecture-patterns.md
86
84
  tasks:
87
85
  - create-deep-research-prompt.md
88
86
  - create-doc.md
@@ -60,7 +60,6 @@ commands:
60
60
  dependencies:
61
61
  data:
62
62
  - technical-preferences.md
63
- - technology-stack.md
64
63
  tasks:
65
64
  - create-doc.md
66
65
  - execute-checklist.md
@@ -0,0 +1,51 @@
1
+ import sys
2
+ import json
3
+ import os
4
+
5
+ try:
6
+ # Leer JSON desde stdin
7
+ data = json.load(sys.stdin)
8
+
9
+ # Obtener información del archivo y sesión
10
+ file_path = data.get('tool_input', {}).get('file_path', '')
11
+ extension = os.path.splitext(file_path)[1].lower() if file_path else ''
12
+ session_id = data.get('session_id', '')
13
+ cwd = data.get('cwd', '')
14
+
15
+ # Construir ruta relativa al log desde el cwd
16
+ log_file = os.path.join(cwd, '.claude', 'logs', 'active_agents.json')
17
+
18
+ # Agentes que solo pueden escribir markdown
19
+ MARKDOWN_ONLY_AGENTS = ['PO', 'SM', 'PM', 'ANALYST', 'ARCHITECT', 'UX-EXPERT']
20
+
21
+ # Verificar si la sesión actual tiene un agente activo
22
+ if session_id and os.path.exists(log_file):
23
+ try:
24
+ with open(log_file, 'r', encoding='utf-8') as f:
25
+ active_agents = json.load(f)
26
+
27
+ # Si la sesión actual tiene un agente activo
28
+ if session_id in active_agents:
29
+ agent_type = active_agents[session_id]['agent']
30
+
31
+ # Si el agente está en la lista de solo markdown
32
+ if agent_type in MARKDOWN_ONLY_AGENTS:
33
+ # Solo permitir archivos markdown
34
+ if extension != '.md':
35
+ result = {
36
+ "hookSpecificOutput": {
37
+ "hookEventName": "PreToolUse",
38
+ "permissionDecision": "deny",
39
+ "permissionDecisionReason": f"⛔ El agente de tipo {agent_type} solo puede redactar archivos markdown"
40
+ }
41
+ }
42
+ print(json.dumps(result))
43
+ sys.exit(0)
44
+ except:
45
+ # Si hay error leyendo el log, permitir la operación
46
+ pass
47
+
48
+ # Si no está bloqueado, permitir la operación (no imprimir nada)
49
+ except Exception as e:
50
+ # En caso de error, permitir la operación
51
+ pass
@@ -0,0 +1,67 @@
1
+ import sys
2
+ import json
3
+ import os
4
+ from datetime import datetime
5
+
6
+ try:
7
+ # Leer JSON desde stdin
8
+ data = json.load(sys.stdin)
9
+
10
+ session_id = data.get('session_id', '')
11
+ prompt = data.get('prompt', '').lower()
12
+ cwd = data.get('cwd', '')
13
+
14
+ # Construir ruta relativa al log desde el cwd
15
+ log_file = os.path.join(cwd, '.claude', 'logs', 'active_agents.json')
16
+
17
+ # Crear directorio si no existe
18
+ log_dir = os.path.dirname(log_file)
19
+ os.makedirs(log_dir, exist_ok=True)
20
+
21
+ # Lista completa de agentes disponibles
22
+ agent_identifiers = {
23
+ 'agents:po': 'PO',
24
+ 'agents:sm': 'SM',
25
+ 'agents:pm': 'PM',
26
+ 'agents:analyst': 'ANALYST',
27
+ 'agents:architect': 'ARCHITECT',
28
+ 'agents:dev': 'DEV',
29
+ 'agents:backend': 'BACKEND',
30
+ 'agents:frontend': 'FRONTEND',
31
+ 'agents:qa': 'QA',
32
+ 'agents:ux-expert': 'UX-EXPERT',
33
+ 'agents:bmad-master': 'BMAD-MASTER',
34
+ 'agents:bmad-orchestrator': 'BMAD-ORCHESTRATOR'
35
+ }
36
+
37
+ # Detectar si se está invocando un agente
38
+ agent_type = None
39
+ for identifier, agent_name in agent_identifiers.items():
40
+ if identifier in prompt or f'/bmad:{identifier}' in prompt:
41
+ agent_type = agent_name
42
+ break
43
+
44
+ if agent_type and session_id:
45
+ # Leer log existente
46
+ active_agents = {}
47
+ if os.path.exists(log_file):
48
+ try:
49
+ with open(log_file, 'r', encoding='utf-8') as f:
50
+ active_agents = json.load(f)
51
+ except:
52
+ active_agents = {}
53
+
54
+ # Actualizar o agregar la sesión con el agente actual
55
+ active_agents[session_id] = {
56
+ 'agent': agent_type,
57
+ 'timestamp': datetime.now().isoformat(),
58
+ 'last_prompt': prompt[:100] # Guardar inicio del prompt para debug
59
+ }
60
+
61
+ # Guardar log actualizado
62
+ with open(log_file, 'w', encoding='utf-8') as f:
63
+ json.dump(active_agents, f, indent=2, ensure_ascii=False)
64
+
65
+ except Exception as e:
66
+ # En caso de error, no bloquear la operación
67
+ pass
@@ -16,5 +16,41 @@
16
16
  ],
17
17
  "deny": [],
18
18
  "ask": []
19
- }
19
+ },
20
+ "hooks": {
21
+ "UserPromptSubmit": [
22
+ {
23
+ "matcher": ".*",
24
+ "hooks": [
25
+ {
26
+ "type": "command",
27
+ "command": "python .claude/hooks/track-agent.py"
28
+ }
29
+ ]
30
+ }
31
+ ],
32
+ "PreToolUse": [
33
+ {
34
+ "matcher": "Write|Edit",
35
+ "hooks": [
36
+ {
37
+ "type": "command",
38
+ "command": "python .claude/hooks/file-restriction-hook.py"
39
+ }
40
+ ]
41
+ }
42
+ ],
43
+ "SessionEnd": [
44
+ {
45
+ "matcher": ".*",
46
+ "hooks": [
47
+ {
48
+ "type": "command",
49
+ "command": "python .claude/hooks/cleanup-agent.py"
50
+ }
51
+ ]
52
+ }
53
+ ]
54
+ },
55
+ "disableAllHooks": false
20
56
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siesa-agents",
3
- "version": "2.1.16",
3
+ "version": "2.1.17-dev.0",
4
4
  "description": "Paquete para instalar y configurar agentes SIESA en tu proyecto",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -1,114 +0,0 @@
1
- # Architecture Patterns & Design Decisions
2
-
3
- ## Frontend Architecture
4
-
5
- ### Architecture Style
6
- - **Clean Architecture** + **Domain-Driven Design (DDD)**
7
-
8
- ### Folder Structure
9
-
10
- Next.js 15 App Router Structure with Clean Architecture + DDD:
11
-
12
- ```
13
- ├── app/ # Next.js App Router directory
14
- │ ├── (dashboard)/ # Route groups for dashboard
15
- │ ├── sales/ # Routes for sales module
16
- │ │ ├── quotes/ # Quote management pages
17
- │ │ └── invoices/ # Invoice pages
18
- │ ├── inventory/ # Inventory routes
19
- │ ├── globals.css # Global styles
20
- │ ├── layout.tsx # Root layout component
21
- │ ├── page.tsx # Home page
22
- │ ├── loading.tsx # Global loading UI
23
- │ └── not-found.tsx # 404 page
24
-
25
- ├── src/
26
- │ ├── modules/ # Business modules following DDD
27
- │ │ ├── sales/ # Sales module
28
- │ │ │ ├── quotes/ # Quote domain
29
- │ │ │ │ ├── cart/ # Shopping cart feature
30
- │ │ │ │ │ ├── domain/
31
- │ │ │ │ │ │ ├── entities/
32
- │ │ │ │ │ │ ├── repositories/
33
- │ │ │ │ │ │ ├── services/
34
- │ │ │ │ │ │ └── types/
35
- │ │ │ │ │ ├── application/
36
- │ │ │ │ │ │ ├── use-cases/
37
- │ │ │ │ │ │ ├── hooks/
38
- │ │ │ │ │ │ └── store/
39
- │ │ │ │ │ ├── infrastructure/
40
- │ │ │ │ │ │ ├── repositories/
41
- │ │ │ │ │ │ ├── api/
42
- │ │ │ │ │ │ └── adapters/
43
- │ │ │ │ │ └── presentation/
44
- │ │ │ │ │ └── components/ # Only components, pages in app/
45
- │ │ │ │ └── products/ # Products feature
46
- │ │ │ └── billing/ # Billing domain
47
- │ │ ├── inventory/ # Inventory module
48
- │ │ └── users/ # User module
49
- │ │
50
- │ ├── shared/
51
- │ │ ├── components/ # Reusable UI components
52
- │ │ ├── hooks/ # Shared hooks
53
- │ │ ├── utils/ # Utility functions
54
- │ │ ├── types/ # Common TypeScript types
55
- │ │ └── constants/ # App constants
56
- │ │
57
- │ ├── providers/ # React context providers
58
- │ ├── store/ # Global Zustand stores
59
- │ └── middleware.ts # Next.js middleware
60
-
61
- ├── lib/ # Next.js utilities and configurations
62
- ├── components/ # Global UI components (alternative to src/shared)
63
- ├── public/ # Static assets and PWA manifest
64
- └── styles/ # Additional stylesheets
65
- ```
66
-
67
- ### Core Principles
68
-
69
- #### Clean Architecture First
70
- Strict separation of:
71
- - **Domain layer** - Business entities, repositories interfaces, domain services, and types
72
- - **Application layer** - Use cases, hooks, and state management (Zustand stores)
73
- - **Infrastructure layer** - Repository implementations, API clients, and adapters
74
- - **Presentation layer** - UI components (pages go in `app/`, components in `presentation/`)
75
-
76
- #### Domain-Driven Design
77
- Business logic drives architecture decisions. Organize by business modules and domains, not technical layers.
78
-
79
- #### Component Composition
80
- Build complex UIs from simple, reusable components.
81
-
82
- #### Type Safety
83
- Leverage TypeScript for compile-time safety and developer experience.
84
-
85
- #### Performance by Design
86
- - Lazy loading
87
- - Memoization
88
- - Bundle optimization
89
-
90
- #### Accessibility as Standard
91
- WCAG 2.1 AA compliance in all components.
92
-
93
- #### Test-Driven Development
94
- Unit tests for all use cases and components.
95
-
96
- #### Progressive Web App
97
- Offline-first approach with service workers.
98
-
99
- #### Minimal and Functional
100
- Only build what's explicitly requested, nothing more.
101
-
102
- #### User-Centered Design
103
- Start with user needs and work backward to implementation.
104
-
105
- #### MCP Shadcn Available
106
- Use MCP to install Shadcn components instead of creating manually.
107
-
108
- ### Framework Selection Rules
109
-
110
- **Default**: Always use Next.js 15 with App Router unless explicitly told otherwise.
111
-
112
- **Exceptions**: Only use pure React + Vite when user specifically mentions offline-first functionality or requests non-Next.js setup.
113
-
114
- **Reasoning**: Next.js provides better developer experience, built-in optimization, and easier deployment while maintaining PWA capabilities.
@@ -1,81 +0,0 @@
1
- # Technology Stack
2
-
3
- ## Frontend Stack
4
-
5
- ### Framework
6
- - **Next.js 15** with TypeScript (App Router)
7
- - Default framework unless explicitly told otherwise
8
- - Built-in Turbopack/Webpack for building
9
- - File-based routing with App Router
10
- - Exception: Use pure React + Vite only when user specifically mentions offline-first functionality or requests non-Next.js setup
11
-
12
- ### State Management
13
- - **Zustand**
14
-
15
- ### UI Framework & Styling
16
- - **Shadcn/ui** (component library)
17
- - **Radix UI** (primitives)
18
- - **TailwindCSS v4** (styling)
19
-
20
- ### Architecture
21
- - **Clean Architecture** + **Domain-Driven Design (DDD)**
22
-
23
- ### Testing
24
- - **Vitest** (test runner)
25
- - **React Testing Library** (component testing)
26
- - **MSW** (Mock Service Worker - API mocking)
27
-
28
- ### Forms & Validation
29
- - **React Hook Form** (form management)
30
- - **Zod** (schema validation)
31
-
32
- ### HTTP Client
33
- - **Axios** with interceptors
34
-
35
- ### Progressive Web App (PWA)
36
- - **Next.js PWA plugin**
37
- - **Workbox** (service worker library)
38
-
39
- ### Routing
40
- - **Next.js App Router** (file-based routing)
41
-
42
- ## Core Principles
43
-
44
- ### Clean Architecture First
45
- Strict separation of:
46
- - Domain layer
47
- - Application layer
48
- - Infrastructure layer
49
- - Presentation layer
50
-
51
- ### Domain-Driven Design
52
- Business logic drives architecture decisions
53
-
54
- ### Component Composition
55
- Build complex UIs from simple, reusable components
56
-
57
- ### Type Safety
58
- Leverage TypeScript for compile-time safety and developer experience
59
-
60
- ### Performance by Design
61
- - Lazy loading
62
- - Memoization
63
- - Bundle optimization
64
-
65
- ### Accessibility as Standard
66
- WCAG 2.1 AA compliance in all components
67
-
68
- ### Test-Driven Development
69
- Unit tests for all use cases and components
70
-
71
- ### Progressive Web App
72
- Offline-first approach with service workers
73
-
74
- ### Minimal and Functional
75
- Only build what's explicitly requested, nothing more
76
-
77
- ### User-Centered Design
78
- Start with user needs and work backward to implementation
79
-
80
- ### MCP Shadcn Available
81
- Use MCP to install Shadcn components instead of creating manually