agent-mp 0.5.6 → 0.5.7

package/dist/core/engine.js

@@ -1022,6 +1022,9 @@ 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.
 
+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 ===
@@ -1031,12 +1034,12 @@ 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 |
+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 modulos/servicios:
+Explica como interactuan entre si los directorios/servicios:
 - Dependencias entre componentes
 - Flujo de datos principal
 - Variables de entorno compartidas
@@ -1047,81 +1050,79 @@ Explica como interactuan entre si los modulos/servicios:
 - Versiones requeridas
 - Servicios externos necesarios (BD, cache, etc.)
 
-## Directorios
-
-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]
+=== modules/[nombre]/index.md ===
+# [nombre] — Estructura Interna
 
-## Descripcion
-Que es este modulo y que problema resuelve.
+Descripcion general de este servicio/API y que problema resuelve.
 
-## Estructura
+## Estructura del Servicio
 \`\`\`
 src/
-  ├── main.py      # entry point
-  ├── models/      # modelos de datos
-  └── routes/      # endpoints API
+  ├── main.py          # entry point
+  ├── models/          # modelos de datos
+  └── routes/          # endpoints
 \`\`\`
 
-## Componentes Principales
-### [componente]
-- **Archivo:** ruta relativa
-- **Funcion:** que hace
-- **Dependencias:** que necesita
+## Modulos Internos
+| Modulo | Archivo | Descripcion |
+|--------|---------|-------------|
+| auth | auth.md | Autenticacion y tokens |
+| users | users.md | Gestion de usuarios |
 
-## 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
+## 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 para ejecutar
+## 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.) |
+| ... | ... |
+
+=== modules/[nombre]/[modulo].md ===
+# [nombre-del-modulo]
+
+## Funcion
+Que hace este modulo y que parte del servicio cubre.
 
-## API / Interfaces
-Endpoints, funciones publicas, interfaces expuestas.
+## 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: que modulos del proyecto usa
-- Externas: librerias de terceros
+- **Internas:** otros modulos del mismo servicio que usa
+- **Externas:** librerias de terceros especificas de este modulo
 
-## Configuracion
-Variables de entorno, archivos de config relevantes.
+## Notas
+Cualquier detalle relevante especifico de este modulo.
 
 REGLAS:
-- Devuelve UNICAMENTE los archivos separados por === NOMBRE.md ===
+- 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 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
         const sections = text.split(/===\s+(.+?\.md)\s*===/).slice(1);
         let filesWritten = 0;
         for (let i = 0; i < sections.length; i += 2) {
@@ -1136,11 +1137,15 @@ REGLAS:
                     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++;
+                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) {

package/package.json

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