agent-mp 0.5.6 → 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,113 +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:
 
-DEVUELVE el contenido de TODOS los archivos a crear en este formato EXACTO (separados por marcadores):
+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
 
-=== ARCHITECTURE.md ===
-# ${this.config.project} — Architecture
+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
 
-Breve descripcion del proyecto y su stack.
+FORMATO EXACTO de los archivos a devolver (separados por marcadores):
 
-## Estructura General
+=== architecture.md ===
+# ${this.config.project} — Architecture Overview
 
-Tabla resumen de todos los directorios/modulos al nivel del proyecto:
-| Directorio/Modulo | Stack | Proposito | Entry Point | Estado |
+Descripcion general del proyecto.
 
-## Como se relacionan los componentes
+## Componentes del Proyecto
 
-Explica como interactuan entre si los modulos/servicios:
-- Dependencias entre componentes
-- Flujo de datos principal
-- Variables de entorno compartidas
-- Bases de datos o servicios externos comunes
+| 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 |
 
-## Prerequisitos Generales
-- Que se necesita instalado globalmente (node, python, java, docker, etc.)
-- Versiones requeridas
-- Servicios externos necesarios (BD, cache, etc.)
+## Como se Relacionan los Componentes
 
-## Directorios
+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
 
-Para CADA directorio al nivel del proyecto (excluyendo .agent):
-### [nombre-del-directorio]
-- **Proposito:** que hace
-- **Stack:** tecnologias
-- **Entry point:** archivo principal
-- **Como levantar:** comando para iniciar
-- **Documentacion detallada:** [modules/nombre-del-directorio.md](modules/nombre-del-directorio.md)
+### Diagrama de Flujo (texto)
+\`\`\`
+[Frontend] --fetch--> [API 1] --HTTP--> [API 2]
+[API 1] --> [Database]
+\`\`\`
 
-## Comandos de Desarrollo Globales
+## Prerequisitos Generales
+- Node.js x.x, Python x.x, Docker, etc.
+- Bases de datos, servicios externos
 
+## Comandos de Desarrollo Globales
 | Comando | Descripcion | Directorio |
 |---------|-------------|------------|
-| build | como compilar todo | . |
-| test | como testear todo | . |
-| run | como ejecutar todo | . |
-| install | como instalar deps | . |
+| ... | ... | ... |
 
-=== modules/[nombre].md ===
-# [nombre-del-directorio]
+=== [nombre]/architecture.md ===
+# [nombre] — Arquitectura Interna
 
-## Descripcion
-Que es este modulo y que problema resuelve.
+Descripcion de este componente y su rol en el proyecto.
 
-## Estructura
+## Estructura Interna
 \`\`\`
 src/
-  ├── main.py      # entry point
-  ├── models/      # modelos de datos
-  └── routes/      # endpoints API
+  ├── main.ts          # entry point
+  ├── config/          # configuracion
+  ├── controllers/     # endpoints
+  └── services/        # logica de negocio
 \`\`\`
 
-## Componentes Principales
-### [componente]
-- **Archivo:** ruta relativa
-- **Funcion:** que hace
-- **Dependencias:** que necesita
-
-## Que necesita para levantar
-- **Dependencias locales:** libs del package.json, requirements.txt, pom.xml, etc.
-- **Servicios:** BD, redis, APIs externas que necesita
-- **Variables de entorno:** cuales necesita y para que sirven
-- **Prerequisitos:** que debe estar corriendo antes
+## Modulos Internos
+| Modulo | Archivo | Descripcion |
+|--------|---------|-------------|
+| config | modules/config.md | Configuracion |
+| controller | modules/controller.md | Endpoints |
 
-## Comandos para ejecutar
+## Como Levantar
+- **Instalar deps:** comando
+- **Servicios necesarios:** BD, redis, etc.
+- **Variables de entorno:** listarlas con su proposito
+- **Comando para iniciar:** \`...\`
 
+## Comandos Disponibles
 | Comando | Que hace |
 |---------|----------|
-| \`npm run dev\` | levanta en modo desarrollo |
-| \`npm run build\` | compila para produccion |
-| \`npm test\` | ejecuta tests |
-| (incluir TODOS los comandos utiles del package.json, Makefile, etc.) |
+| ... | ... |
 
-## API / Interfaces
-Endpoints, funciones publicas, interfaces expuestas.
+## Comunicacion con Otros Componentes
+- A que APIs llama o que APIs lo llaman
+- Protocolo (fetch, HTTP, gRPC, etc.)
 
-## Dependencias
-- Internas: que modulos del proyecto usa
-- Externas: librerias de terceros
+=== [nombre]/modules/[modulo].md ===
+# [nombre-del-modulo]
+
+## Funcion
+Que hace este modulo especifico.
+
+## Archivo Principal
+- **Ruta:** path relativo
+- **Funciones/Clases principales**
+
+## Endpoints / Interfaces Publicas
+Si es un controller/router:
+- \`GET /ruta\` — descripcion
+- \`POST /ruta\` — descripcion
 
-## Configuracion
-Variables de entorno, archivos de config relevantes.
+## Dependencias
+- **Internas:** modulos del mismo componente
+- **Externas:** librerias de terceros
 
 REGLAS:
-- Devuelve UNICAMENTE los archivos separados por === NOMBRE.md ===
-- NO incluyas explicaciones fuera de los archivos
+- 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 un directorio es trivial (solo config o docs), documentalo brevemente en architecture.md sin modulo separado
-- Para cada modulo incluye SIEMPRE: estructura, que necesita para levantar, comandos ejecutables
 - 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
-        // and write each section to its corresponding file
+        // 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) {
@@ -1132,16 +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.startsWith('modules/')) {
-                    const modPath = path.join(contextDir, fileName);
-                    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.6",
+  "version": "0.5.8",
   "description": "Deterministic multi-agent CLI orchestrator — plan, code, review",
   "type": "module",
   "main": "./dist/index.js",