agent-mp 0.5.5 → 0.5.6

package/dist/core/engine.js

@@ -981,60 +981,174 @@ 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.
+
+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/modulos al nivel del proyecto:
+| Directorio/Modulo | Stack | Proposito | Entry Point | Estado |
+
+## Como se relacionan los componentes
+
+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
+
+## Prerequisitos Generales
+- Que se necesita instalado globalmente (node, python, java, docker, etc.)
+- Versiones requeridas
+- Servicios externos necesarios (BD, cache, etc.)
+
+## Directorios
 
-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)
+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)
+
+## 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]
+
+## Descripcion
+Que es este modulo y que problema resuelve.
+
+## Estructura
+\`\`\`
+src/
+  ├── main.py      # entry point
+  ├── models/      # modelos de datos
+  └── routes/      # endpoints API
+\`\`\`
+
+## 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
+
+## Comandos para ejecutar
+
+| 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.
+
+## Dependencias
+- Internas: que modulos del proyecto usa
+- Externas: librerias de terceros
+
+## Configuracion
+Variables de entorno, archivos de config relevantes.
 
 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 === NOMBRE.md ===
+- NO incluyas explicaciones fuera de los archivos
+- 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);
-        // 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
+        // and write each section to its corresponding file
+        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.startsWith('modules/')) {
+                    const modPath = path.join(contextDir, fileName);
+                    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.6",
   "description": "Deterministic multi-agent CLI orchestrator — plan, code, review",
   "type": "module",
   "main": "./dist/index.js",