agent-mp 0.5.18 → 0.5.20

package/dist/core/engine.js

@@ -238,11 +238,11 @@ async function walkForKeyFiles(root) {
         'server.ts', 'server.js', 'server.py',
         'application.ts', 'application.js', 'application.py',
     ]);
-    const ENTRY_REGEX = /Application\.(java|kt)$/;
+    const ENTRY_REGEX = /Application\.[a-z]+$/i; // *Application.java, *Application.kt, etc.
     const CTRL_REGEX = /(controller|router|routes|handler|endpoint|resource)/i;
     const SCHEMA_REGEX = /(schema|\.entity|\.model|\.dto|models?\.|entities?\.)/i;
-    // Java packages that contain domain/entity classes even when filename alone doesn't signal it
-    const JAVA_DOMAIN_DIR_REGEX = /[\/\\](domain|entity|entities|model|models)[\/\\]/i;
+    // Directories that conventionally hold data/domain classes (language-agnostic)
+    const DOMAIN_DIR_REGEX = /[\/\\](domain|entity|entities|model|models|dto|dtos|schema|schemas)[\/\\]/i;
     async function walk(dir, depth) {
         if (depth > 6)
             return;
@@ -278,7 +278,7 @@ async function walkForKeyFiles(root) {
             if (CTRL_REGEX.test(e.name) && result.controllers.length < 5) {
                 result.controllers.push(p);
             }
-            const isSchema = SCHEMA_REGEX.test(e.name) || JAVA_DOMAIN_DIR_REGEX.test(p);
+            const isSchema = SCHEMA_REGEX.test(e.name) || DOMAIN_DIR_REGEX.test(p);
             if (isSchema && result.schemas.length < 5) {
                 result.schemas.push(p);
             }
@@ -1193,7 +1193,9 @@ INSTRUCCIONES:
         // Ensure .agent/ structure exists
         const agentDir = path.join(this.projectDir, '.agent');
         const contextDir = path.join(agentDir, 'context');
+        const docsDir = path.join(agentDir, 'docs');
         await fs.mkdir(contextDir, { recursive: true });
+        await fs.mkdir(docsDir, { recursive: true });
         await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
         // NOTE: cleanup of stray files moved to AFTER successful parse, to avoid
         // wiping previous docs when the explorer fails (e.g. tool-call hallucination).
@@ -1283,19 +1285,20 @@ El engine YA leyo por vos los archivos clave de cada componente y te los pasa ar
 
 REGLA CRITICA PARA MODULOS (NIVEL 2):
 - Los modulos SON LAS FEATURES DEL NEGOCIO, NO las capas tecnicas.
-- MAL: modulos llamados "web-api", "security", "data-access" — eso es hablar de capas, no de negocio
-- BIEN: modulos llamados "clients", "sales", "products", "auth", "orders" — eso es hablar de features
-- Para identificar los modulos reales, MIRÁ los CONTROLLER/ROUTER pre-leidos:
-  * Si el controller se llama ClientController.java → el modulo se llama "clients"
-  * Si se llama SaleController.java → modulo "sales"
-  * Si se llama AuthController.ts → modulo "auth"
-  * El nombre del modulo = lo que maneja ese controller, no su capa
-- "Archivos clave" en cada modulo DEBE listar los archivos FUENTE REALES que leiste (los .java, .ts, .py, etc.),
-  NO solo el manifest (pom.xml / package.json). Ejemplo correcto:
-  | Archivo | Rol |
-  | src/main/java/.../ClientController.java | Endpoints REST /clients |
-  | src/main/java/.../Client.java | Entidad JPA (tabla CLIENTS) |
-  | src/main/java/.../ClientRepository.java | Acceso a SQL Server |
+- MAL: modulos llamados "web-api", "security", "data-access" — eso es hablar de capas, no de features
+- BIEN: modulos llamados "clients", "sales", "products", "auth", "orders" — eso es hablar de features reales
+- Para identificar los modulos, MIRA los CONTROLLER/ROUTER pre-leidos: el nombre del modulo = lo que maneja ese controller
+  * ClientController o clients.controller → modulo "clients"
+  * SaleController o sale.routes → modulo "sales"
+  * AuthController o auth.handler → modulo "auth"
+- "Archivos clave" en cada modulo DEBE listar los archivos FUENTE REALES que leiste, NO solo el manifest.
+  Ejemplo correcto:
+  | Archivo (ruta relativa al componente) | Rol |
+  | controller/ClientController.java | Endpoints REST /clients |
+  | domain/Client.java | Entidad mapeada a tabla CLIENTS |
+  | repository/ClientRepository.java | Acceso a base de datos |
+  | src/clients/clients.controller.ts | Endpoints /clients |
+  | src/clients/client.schema.ts | Modelo de datos Client |
 
 NO inventes datos. Si un componente no tiene una de esas piezas en los archivos leidos, simplemente omiti esa seccion en su documentacion.
 
@@ -1516,35 +1519,29 @@ FORMATO DE SALIDA — OBLIGATORIO
 Devolve UNICAMENTE bloques de archivos separados por marcadores ===. Nada de explicaciones extra fuera de los bloques.
 
 IMPORTANTE: TODAS las rutas son RELATIVAS al directorio del proyecto.
-Los archivos se escriben SIEMPRE dentro de .agent/context/
 
-Ejemplos de marcadores:
+Ejemplos de marcadores validos:
   === .agent/context/architecture.md ===
   === .agent/context/datamart-data-access-api/architecture.md ===
   === .agent/context/datamart-data-access-api/modules/auth.md ===
   === .agent/context/nexus-core-api/architecture.md ===
-  === .agent/context/nexus-core-api/modules/users.md ===
+  === .agent/context/nexus-core-api/modules/clients.md ===
 
 === .agent/context/architecture.md ===
-[contenido completo del NIVEL 0]
+[contenido NIVEL 0]
 
-=== .agent/context/nombre-componente-1/architecture.md ===
-[contenido completo del NIVEL 1 del componente 1]
+=== .agent/context/nombre-componente/architecture.md ===
+[contenido NIVEL 1]
 
-=== .agent/context/nombre-componente-1/modules/auth.md ===
-[contenido completo del NIVEL 2 del modulo auth]
-
-=== .agent/context/nombre-componente-1/modules/leads.md ===
-[contenido completo del NIVEL 2 del modulo leads]
-
-=== .agent/context/nombre-componente-2/architecture.md ===
-...
+=== .agent/context/nombre-componente/modules/auth.md ===
+[contenido NIVEL 2]
 
 REGLAS DE PATHS:
-- El archivo principal SIEMPRE es: === .agent/context/architecture.md ===
+- Arquitectura global: === .agent/context/architecture.md ===
 - Por componente: === .agent/context/[nombre-componente]/architecture.md ===
 - Por modulo interno: === .agent/context/[nombre-componente]/modules/[nombre-modulo].md ===
 - Documenta TODOS los componentes no triviales del DIRECTORIO_TRABAJO
+- NO escribir nada bajo .agent/docs/ — esa carpeta es de uso manual
 - Si existe documentacion previa, ACTUALIZALA preservando lo que sigue siendo valido y agregando lo nuevo`;
         const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
         const text = extractCliText(res);
@@ -1574,8 +1571,8 @@ REGLAS DE PATHS:
             content = content.replace(/^```markdown\s*/i, '').replace(/^```\s*$/gm, '').trim();
             if (!content)
                 continue;
-            // Normalize: strip any .agent/context/ prefix from the marker
-            let relPath = fileName.replace(/^\.agent\/context\//i, '').replace(/^\/+/, '');
+            // All explorer output goes under .agent/context/ — docs/ is manual-only
+            const relPath = fileName.replace(/^\.agent\/context\//i, '').replace(/^\/+/, '');
             let targetPath = null;
             if (relPath === 'architecture.md' || relPath === 'ARCHITECTURE.md') {
                 targetPath = mainArchPath;

package/package.json

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