agent-mp 0.5.5 → 0.5.7

package/dist/core/engine.js

@@ -981,60 +981,179 @@ INSTRUCCIONES:
         await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
         // Clean up stray files before running
         await this._cleanContextDir(contextDir);
-        // Read existing architecture doc if any
+        // Build a quick filesystem snapshot to give the explorer context
+        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 = '';
         try {
             existingArch = await readFile(archPath);
         }
         catch { /* new project */ }
-        // Build a quick filesystem snapshot to give the explorer context
-        let fsSnapshot = '';
+        // Read existing module docs if any
+        const modulesDir = path.join(contextDir, 'modules');
+        let existingModules = '';
         try {
-            const { execSync } = await import('child_process');
-            // Use tree/find but exclude .agent, node_modules, .git, dist, __pycache__, .venv
-            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/*' | head -200`, { encoding: 'utf-8', timeout: 10000 });
+            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`;
+            }
         }
-        catch { /* ignore */ }
+        catch { /* no modules yet */ }
         const effectiveTask = task || 'Explorar y documentar todas las aplicaciones y servicios del proyecto';
         const prompt = `TAREA DE EXPLORACION: ${effectiveTask}
 DIRECTORIO_TRABAJO: ${this.projectDir}
 PROYECTO: ${this.config.project}
 STACK: ${this.config.stack}
 
-LISTADO DE ARCHIVOS DEL PROYECTO (excluyendo .agent, node_modules, .git, dist, __pycache__, .venv):
+ESTRUCTURA DE ARCHIVOS DEL PROYECTO (excluyendo .agent, node_modules, .git, dist, __pycache__, .venv, target, build):
 ${fsSnapshot}
 
-${existingArch ? `DOCUMENTACION EXISTENTE (actualizar si hay cambios):\n${existingArch.slice(0, 3000)}\n` : 'DOCUMENTACION EXISTENTE: ninguna — crear desde cero.\n'}
+${existingArch ? `--- DOCUMENTACION EXISTENTE: architecture.md ---\n${existingArch.slice(0, 2000)}\n` : ''}
+${existingModules ? `--- DOCUMENTACION EXISTENTE: modules/ ---\n${existingModules.slice(0, 3000)}\n` : ''}
+
 INSTRUCCIONES:
-Analiza el listado de archivos y genera documentación completa.
-DEVUELVE SOLO el contenido del archivo architecture.md como texto markdown. No incluyas explicaciones adicionales.
+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.
+
+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.
+
+DEVUELVE el contenido de TODOS los archivos a crear en este formato EXACTO (separados por marcadores):
+
+=== ARCHITECTURE.md ===
+# ${this.config.project} — Architecture
+
+Breve descripcion del proyecto y su stack.
+
+## Estructura General
+
+Tabla resumen de todos los directorios al nivel del proyecto:
+| Directorio | Tipo | Stack | Proposito | Entry Point |
+
+## 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
+
+## Prerequisitos Generales
+- Que se necesita instalado globalmente (node, python, java, docker, etc.)
+- Versiones requeridas
+- Servicios externos necesarios (BD, cache, etc.)
+
+## Comandos de Desarrollo Globales
+
+| Comando | Descripcion | Directorio |
+|---------|-------------|------------|
+| ... | ... | ... |
 
-El archivo DEBE contener:
-1. Tabla resumen: | Servicio/Modulo | Stack | Proposito | Entry Point | Archivos clave |
-2. Analisis de la estructura de directorios principal
-3. Por cada servicio/app: dependencias clave (de package.json, pyproject.toml, pom.xml, build.gradle, etc.), entry points, modulos principales
-4. Mapa de dependencias entre componentes
-5. Variables de entorno o configuraciones relevantes
-6. Comandos de desarrollo comunes (build, test, run)
+=== modules/[nombre]/index.md ===
+# [nombre] — Estructura Interna
+
+Descripcion general de este servicio/API y que problema resuelve.
+
+## Estructura del Servicio
+\`\`\`
+src/
+  ├── main.py          # entry point
+  ├── models/          # modelos de datos
+  └── routes/          # endpoints
+\`\`\`
+
+## Modulos Internos
+| Modulo | Archivo | Descripcion |
+|--------|---------|-------------|
+| auth | auth.md | Autenticacion y tokens |
+| users | users.md | Gestion de usuarios |
+
+## Como Levantar
+- **Dependencias:** instalar con \`npm install\` o \`pip install -r requirements.txt\`
+- **Servicios necesarios:** BD, redis, etc.
+- **Variables de entorno:** cuales y para que
+- **Comando para iniciar:** \`npm run dev\` o equivalente
+
+## Comandos Disponibles
+
+| Comando | Que hace |
+|---------|----------|
+| ... | ... |
+
+=== modules/[nombre]/[modulo].md ===
+# [nombre-del-modulo]
+
+## Funcion
+Que hace este modulo y que parte del servicio cubre.
+
+## Archivo Principal
+- **Ruta:** path relativo al proyecto
+- **Funciones/Clases principales:** listar las mas importantes
+
+## 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
+
+## 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.
 
 REGLAS:
-- Devuelve UNICAMENTE el contenido markdown del archivo
-- NO incluyas texto de explicacion fuera del markdown
-- NO incluyas bloques de codigo
-- Documenta TODO el proyecto (todos los subdirectorios al nivel de DIRECTORIO_TRABAJO, excluyendo .agent)`;
+- 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
+- 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);
-        // The LLM returns the CONTENT of architecture.md as plain text.
-        // We need to write it to the file ourselves.
-        const cleanText = text
-            .replace(/^```markdown\s*/i, '')
-            .replace(/^```\s*$/gm, '')
-            .replace(/```/g, '')
-            .trim();
-        if (cleanText) {
-            await writeFile(archPath, cleanText);
-            log.ok(`architecture.md written (${cleanText.length} chars)`);
+        // Parse the response: split by === FILENAME.md === markers
+        const sections = text.split(/===\s+(.+?\.md)\s*===/).slice(1);
+        let filesWritten = 0;
+        for (let i = 0; i < sections.length; i += 2) {
+            const fileName = sections[i].trim();
+            let content = sections[i + 1] ? sections[i + 1].trim() : '';
+            if (!content)
+                continue;
+            // 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++;
+                }
+                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++;
+                    }
+                }
+            }
+            catch (err) {
+                log.warn(`Failed to write ${fileName}: ${err.message}`);
+            }
+        }
+        if (filesWritten > 0) {
+            log.ok(`${filesWritten} documentation file(s) written`);
         }
         // Overwrite the single last-run report (no timestamp accumulation)
         try {

package/package.json

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