agent-mp 0.5.7 → 0.5.8

package/dist/core/engine.js

@@ -985,27 +985,32 @@ INSTRUCCIONES:
         let fsSnapshot = '';
         try {
             const { execSync } = await import('child_process');
-            // Use find but exclude .agent, node_modules, .git, dist, __pycache__, .venv, target, build
             fsSnapshot = execSync(`find "${this.projectDir}" -maxdepth 3 -not -path '*/.agent/*' -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' -not -path '*/__pycache__/*' -not -path '*/.venv/*' -not -path '*/target/*' -not -path '*/build/*' -not -name '.git' | sort | head -300`, { encoding: 'utf-8', timeout: 10000 });
         }
         catch { /* ignore */ }
-        // Read existing architecture docs if any
-        const archPath = path.join(contextDir, 'architecture.md');
-        let existingArch = '';
+        // Read existing main architecture doc
+        const mainArchPath = path.join(contextDir, 'architecture.md');
+        let existingMainArch = '';
         try {
-            existingArch = await readFile(archPath);
+            existingMainArch = await readFile(mainArchPath);
         }
-        catch { /* new project */ }
-        // Read existing module docs if any
-        const modulesDir = path.join(contextDir, 'modules');
-        let existingModules = '';
+        catch { /* new */ }
+        // Read existing per-component docs
+        let existingComponentDocs = '';
         try {
-            const modFiles = await fs.readdir(modulesDir);
-            for (const f of modFiles.filter(f => f.endsWith('.md'))) {
-                existingModules += `\n--- ${f} ---\n${await readFile(path.join(modulesDir, f)).then(c => c.slice(0, 2000))}\n`;
+            const ctxEntries = await fs.readdir(contextDir);
+            for (const entry of ctxEntries.filter(e => e !== 'architecture.md' && e !== 'explorer-last.md' && e !== 'modules')) {
+                const entryPath = path.join(contextDir, entry);
+                const stat = await fs.stat(entryPath);
+                if (stat.isDirectory()) {
+                    const compArch = path.join(entryPath, 'architecture.md');
+                    if (await fileExists(compArch)) {
+                        existingComponentDocs += `\n=== EXISTING: ${entry}/architecture.md ===\n${(await readFile(compArch)).slice(0, 1500)}\n`;
+                    }
+                }
             }
         }
-        catch { /* no modules yet */ }
+        catch { /* ignore */ }
         const effectiveTask = task || 'Explorar y documentar todas las aplicaciones y servicios del proyecto';
         const prompt = `TAREA DE EXPLORACION: ${effectiveTask}
 DIRECTORIO_TRABAJO: ${this.projectDir}
@@ -1015,114 +1020,124 @@ STACK: ${this.config.stack}
 ESTRUCTURA DE ARCHIVOS DEL PROYECTO (excluyendo .agent, node_modules, .git, dist, __pycache__, .venv, target, build):
 ${fsSnapshot}
 
-${existingArch ? `--- DOCUMENTACION EXISTENTE: architecture.md ---\n${existingArch.slice(0, 2000)}\n` : ''}
-${existingModules ? `--- DOCUMENTACION EXISTENTE: modules/ ---\n${existingModules.slice(0, 3000)}\n` : ''}
+${existingMainArch ? `=== DOCUMENTACION EXISTENTE: architecture.md (principal) ===\n${existingMainArch.slice(0, 2000)}\n` : ''}
+${existingComponentDocs ? `=== DOCUMENTACION EXISTENTE por componente ===\n${existingComponentDocs.slice(0, 3000)}\n` : ''}
 
 INSTRUCCIONES:
-Analiza la estructura de archivos y genera documentación COMPLETA y ESCALONADA del proyecto.
-Para cada directorio/modulo debes documentar: QUE ES, COMO SE ESTRUCTURA, QUE NECESITA PARA LEVANTAR, y QUE COMANDOS PUEDE EJECUTAR.
+Analiza la estructura de archivos y genera documentación ESCALONADA en DOS NIVELES:
+
+NIVEL 1: architecture.md (raiz de .agent/context/)
+  - Lista TODOS los directorios al nivel del proyecto
+  - Indica si son independientes o conectados entre si (ej: front consume back, dos APIs se consumen entre si)
+  - Prerequisitos generales para levantar el proyecto
+  - Comandos globales de desarrollo
 
-IMPORTANTE: Si un directorio contiene una API o servicio con multiples modulos (rutas, controllers, models, etc.),
-ese directorio debe tener SU PROPIA subcarpeta dentro de modules/ con un index.md y un archivo por cada modulo interno.
+NIVEL 2: Para CADA directorio que sea un servicio/API/app/funcionalidad:
+  - Crea subcarpeta: [nombre-del-directorio]/architecture.md → explica como se estructura internamente
+  - Crea subcarpeta: [nombre-del-directorio]/modules/[modulo].md → detalle de cada modulo interno
+  - Si un directorio es trivial (solo scripts, docs, configs), NO crees subcarpeta, solo mencionarlo en el architecture.md principal
 
-DEVUELVE el contenido de TODOS los archivos a crear en este formato EXACTO (separados por marcadores):
+FORMATO EXACTO de los archivos a devolver (separados por marcadores):
 
-=== ARCHITECTURE.md ===
-# ${this.config.project} — Architecture
+=== architecture.md ===
+# ${this.config.project} — Architecture Overview
 
-Breve descripcion del proyecto y su stack.
+Descripcion general del proyecto.
 
-## Estructura General
+## Componentes del Proyecto
 
-Tabla resumen de todos los directorios al nivel del proyecto:
-| Directorio | Tipo | Stack | Proposito | Entry Point |
+| Componente | Tipo | Stack | Proposito | Entry Point |
+|------------|------|-------|-----------|-------------|
+| datamart-data-access-api | API Backend | NestJS | Acceso a datos | src/main.ts |
+| nexus-core-api | API Backend | NestJS | Core business logic | src/main.ts |
 
-## Como se relacionan los componentes
+## Como se Relacionan los Componentes
 
-Explica como interactuan entre si los directorios/servicios:
-- Dependencias entre componentes
-- Flujo de datos principal
-- Variables de entorno compartidas
-- Bases de datos o servicios externos comunes
+Explica las conexiones entre componentes:
+- Si un front consume un back, explicar como
+- Si dos APIs se consumen entre sí (fetch, HTTP), explicar el flujo
+- Si son independientes, indicar que cada uno funciona por su cuenta
+
+### Diagrama de Flujo (texto)
+\`\`\`
+[Frontend] --fetch--> [API 1] --HTTP--> [API 2]
+[API 1] --> [Database]
+\`\`\`
 
 ## Prerequisitos Generales
-- Que se necesita instalado globalmente (node, python, java, docker, etc.)
-- Versiones requeridas
-- Servicios externos necesarios (BD, cache, etc.)
+- Node.js x.x, Python x.x, Docker, etc.
+- Bases de datos, servicios externos
 
 ## Comandos de Desarrollo Globales
-
 | Comando | Descripcion | Directorio |
 |---------|-------------|------------|
 | ... | ... | ... |
 
-=== modules/[nombre]/index.md ===
-# [nombre] — Estructura Interna
+=== [nombre]/architecture.md ===
+# [nombre] — Arquitectura Interna
 
-Descripcion general de este servicio/API y que problema resuelve.
+Descripcion de este componente y su rol en el proyecto.
 
-## Estructura del Servicio
+## Estructura Interna
 \`\`\`
 src/
-  ├── main.py          # entry point
-  ├── models/          # modelos de datos
-  └── routes/          # endpoints
+  ├── main.ts          # entry point
+  ├── config/          # configuracion
+  ├── controllers/     # endpoints
+  └── services/        # logica de negocio
 \`\`\`
 
 ## Modulos Internos
 | Modulo | Archivo | Descripcion |
 |--------|---------|-------------|
-| auth | auth.md | Autenticacion y tokens |
-| users | users.md | Gestion de usuarios |
+| config | modules/config.md | Configuracion |
+| controller | modules/controller.md | Endpoints |
 
 ## Como Levantar
-- **Dependencias:** instalar con \`npm install\` o \`pip install -r requirements.txt\`
+- **Instalar deps:** comando
 - **Servicios necesarios:** BD, redis, etc.
-- **Variables de entorno:** cuales y para que
-- **Comando para iniciar:** \`npm run dev\` o equivalente
+- **Variables de entorno:** listarlas con su proposito
+- **Comando para iniciar:** \`...\`
 
 ## Comandos Disponibles
-
 | Comando | Que hace |
 |---------|----------|
 | ... | ... |
 
-=== modules/[nombre]/[modulo].md ===
+## Comunicacion con Otros Componentes
+- A que APIs llama o que APIs lo llaman
+- Protocolo (fetch, HTTP, gRPC, etc.)
+
+=== [nombre]/modules/[modulo].md ===
 # [nombre-del-modulo]
 
 ## Funcion
-Que hace este modulo y que parte del servicio cubre.
+Que hace este modulo especifico.
 
 ## Archivo Principal
-- **Ruta:** path relativo al proyecto
-- **Funciones/Clases principales:** listar las mas importantes
+- **Ruta:** path relativo
+- **Funciones/Clases principales**
 
 ## Endpoints / Interfaces Publicas
-Si es un modulo de API:
-- \`GET /endpoint\` — descripcion
-- \`POST /endpoint\` — descripcion
-
-Si es otro tipo de modulo:
-- Funciones publicas exportadas
-- Interfaces que implementa
+Si es un controller/router:
+- \`GET /ruta\` — descripcion
+- \`POST /ruta\` — descripcion
 
 ## Dependencias
-- **Internas:** otros modulos del mismo servicio que usa
-- **Externas:** librerias de terceros especificas de este modulo
-
-## Notas
-Cualquier detalle relevante especifico de este modulo.
+- **Internas:** modulos del mismo componente
+- **Externas:** librerias de terceros
 
 REGLAS:
-- Devuelve UNICAMENTE los archivos separados por === modules/path/file.md ===
-- NO incluyas explicaciones fuera de los archivos
-- Para CADA API/servicio con modulos internos: crea modules/[nombre]/index.md + un archivo por cada modulo
-- Para directorios triviales (solo docs, configs sueltos): documenta en architecture.md sin crear subcarpeta
+- Devuelve UNICAMENTE los archivos separados por === path/file.md ===
+- NO incluyas texto explicativo fuera de los archivos
+- El archivo principal SIEMPRE es === architecture.md ===
+- Para cada componente con modulos internos: === [nombre]/architecture.md === + === [nombre]/modules/[modulo].md ===
+- Para componentes triviales (scripts, docs): solo mencionarlos en architecture.md principal
 - Documenta TODOS los directorios al nivel de DIRECTORIO_TRABAJO (excluyendo .agent)
 - Si hay documentacion existente, actualizala con los cambios detectados`;
         const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
         const text = extractCliText(res);
-        // Parse the response: split by === FILENAME.md === markers
+        // Parse sections separated by === path/file.md === markers
         const sections = text.split(/===\s+(.+?\.md)\s*===/).slice(1);
         let filesWritten = 0;
         for (let i = 0; i < sections.length; i += 2) {
@@ -1133,20 +1148,30 @@ REGLAS:
             // Clean up code fences if present
             content = content.replace(/^```markdown\s*/i, '').replace(/^```\s*$/gm, '').trim();
             try {
-                if (fileName === 'ARCHITECTURE.md') {
-                    await writeFile(archPath, content);
-                    filesWritten++;
+                let targetPath;
+                if (fileName === 'architecture.md' || fileName === 'ARCHITECTURE.md') {
+                    // Main architecture doc
+                    targetPath = mainArchPath;
                 }
-                else if (fileName.toLowerCase().includes('modules/')) {
-                    // Extract the modules/ path from the marker
-                    const modMatch = fileName.match(/modules\/(.+\.md)/i);
-                    if (modMatch) {
-                        const modPath = path.join(contextDir, 'modules', modMatch[1]);
-                        await fs.mkdir(path.dirname(modPath), { recursive: true });
-                        await writeFile(modPath, content);
-                        filesWritten++;
+                else {
+                    // Component doc: [component]/architecture.md or [component]/modules/[mod].md
+                    // fileName could be: "datamart-data-access-api/architecture.md" or "datamart-data-access-api/modules/config.md"
+                    const compMatch = fileName.match(/^(.+?)\/architecture\.md$/i);
+                    const modMatch = fileName.match(/^(.+?)\/modules\/(.+\.md)$/i);
+                    if (compMatch) {
+                        targetPath = path.join(contextDir, compMatch[1], 'architecture.md');
+                    }
+                    else if (modMatch) {
+                        targetPath = path.join(contextDir, modMatch[1], 'modules', modMatch[2]);
+                    }
+                    else {
+                        // Fallback: treat as modules file in legacy modules/ dir
+                        targetPath = path.join(contextDir, 'modules', fileName.replace(/.*\//, ''));
                     }
                 }
+                await fs.mkdir(path.dirname(targetPath), { recursive: true });
+                await writeFile(targetPath, content);
+                filesWritten++;
             }
             catch (err) {
                 log.warn(`Failed to write ${fileName}: ${err.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-mp",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "Deterministic multi-agent CLI orchestrator — plan, code, review",
   "type": "module",
   "main": "./dist/index.js",