agent-mp 0.5.17 → 0.5.18

package/dist/core/engine.js

@@ -241,6 +241,8 @@ async function walkForKeyFiles(root) {
     const ENTRY_REGEX = /Application\.(java|kt)$/;
     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;
     async function walk(dir, depth) {
         if (depth > 6)
             return;
@@ -276,7 +278,8 @@ async function walkForKeyFiles(root) {
             if (CTRL_REGEX.test(e.name) && result.controllers.length < 5) {
                 result.controllers.push(p);
             }
-            if (SCHEMA_REGEX.test(e.name) && result.schemas.length < 5) {
+            const isSchema = SCHEMA_REGEX.test(e.name) || JAVA_DOMAIN_DIR_REGEX.test(p);
+            if (isSchema && result.schemas.length < 5) {
                 result.schemas.push(p);
             }
         }
@@ -1155,7 +1158,7 @@ INSTRUCCIONES:
                     compSection.push(`### ENTRY POINT: ${rel}\n\`\`\`\n${content}\n\`\`\``);
                 }
             }
-            const ctrls = found.controllers.slice(0, 3);
+            const ctrls = found.controllers.slice(0, 5);
             for (const ctrl of ctrls) {
                 const content = await readFileSafe(ctrl, MAX_CTRL);
                 if (content) {
@@ -1163,7 +1166,7 @@ INSTRUCCIONES:
                     compSection.push(`### CONTROLLER/ROUTER: ${rel}\n\`\`\`\n${content}\n\`\`\``);
                 }
             }
-            const schemas = found.schemas.slice(0, 3);
+            const schemas = found.schemas.slice(0, 4);
             for (const sch of schemas) {
                 const content = await readFileSafe(sch, MAX_SCHEMA);
                 if (content) {
@@ -1273,11 +1276,27 @@ El engine YA leyo por vos los archivos clave de cada componente y te los pasa ar
    - Del MANIFEST: nombre, version, framework, dependencias clave con sus versiones, scripts, entry point
    - Del ENTRY POINT: puerto real, middlewares, modulos cargados
    - De los CONFIG/ENV: variables reales y su proposito
-   - De los CONTROLLER/ROUTER: endpoints REALES (metodo, ruta, parametros)
-   - De los SCHEMA/MODEL: shape real de los datos
+   - De los CONTROLLER/ROUTER: endpoints REALES (metodo, ruta, parametros, anotaciones como @GetMapping/@PostMapping/router.get)
+   - De los SCHEMA/MODEL/DOMAIN: shape real de los datos (campos, tipos, anotaciones @Column/@Entity)
 3. Identificar relaciones REALES entre componentes (URLs/hosts de otros servicios en .env, imports cross-component, conexiones a BBDD).
 4. Generar la documentacion en los 3 niveles, en formato markdown, dentro de los bloques === ... ===.
 
+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 |
+
 NO inventes datos. Si un componente no tiene una de esas piezas en los archivos leidos, simplemente omiti esa seccion en su documentacion.
 
 ================================================================
@@ -1368,15 +1387,24 @@ Secciones obligatorias:
 - **Health check:** GET /health (si existe)
 
 ## Estructura interna (arbol real)
+Listar DIRECTORIOS clave + los archivos que leiste (los CONTROLLER/ROUTER y SCHEMA/MODEL del prefetch).
 \`\`\`
 src/
-├── main.ts            # entry point, configura CORS y swagger
-├── auth/              # autenticacion JWT
-├── leads/             # gestion de leads
+├── main.ts                      # entry point, configura CORS y swagger
+├── auth/
+│   ├── auth.controller.ts       # endpoints /auth/login, /auth/refresh
+│   └── auth.service.ts          # logica de validacion JWT
+├── leads/
+│   ├── leads.controller.ts      # endpoints /leads
+│   └── lead.schema.ts           # modelo Lead { name, email, status }
 └── ...
 \`\`\`
+Para Java, usar el arbol de packages: src/main/java/.../controller/, .../domain/, .../service/, etc.
+Si no se leyo el codigo fuente, mencionar solo los directorios visibles en la estructura de archivos.
 
 ## Modulos internos
+IMPORTANTE: nombrar cada modulo por su FEATURE (clients, sales, products), no por su capa (web, data, service).
+Los modulos surgen de los controllers que se leyeron: un controller → un modulo.
 | Modulo | Proposito (negocio) | Doc tecnica |
 |--------|---------------------|-------------|
 | auth | Login y validacion de tokens | modules/auth.md |
@@ -1387,7 +1415,7 @@ src/
 |--------|------|--------|----------------------------|
 | GET | /leads | leads | Lista negocios filtrables |
 | GET | /leads/:id | leads | Detalle de un negocio |
-(SOLO endpoints reales extraidos de los controllers)
+(SOLO endpoints reales extraidos de los controllers — metodo HTTP, ruta, y descripcion en 1 linea)
 
 ## Variables de entorno
 | Variable | Default | Proposito |
@@ -1448,10 +1476,15 @@ Escenarios paso a paso. Ejemplo:
 - Excepciones: ...
 
 ## Archivos clave
-| Archivo | Rol |
-|---------|-----|
-| src/leads/leads.controller.ts | Endpoints /leads |
-| src/leads/leads.service.ts | Logica de negocio |
+OBLIGATORIO: listar los archivos FUENTE reales que encontraste en los pre-fetched data.
+NO poner solo el manifest. Si no hay fuentes leidas para este modulo, omitir la seccion.
+| Archivo (ruta relativa al componente) | Rol |
+|---------------------------------------|-----|
+| src/main/java/.../ClientController.java | Expone endpoints REST /clients |
+| src/main/java/.../Client.java | Entidad JPA mapeada a tabla CLIENTS |
+| src/main/java/.../ClientRepository.java | Acceso a datos via JPA |
+| src/clients/clients.controller.ts | Endpoints /clients (Node.js) |
+| src/clients/clients.service.ts | Logica de negocio (Node.js) |
 
 ## Dependencias
 - **Internas (mismo componente):** auth, common
@@ -1464,7 +1497,7 @@ CALIBRACION DE DETALLE
 - NIVEL 0: 50-150 lineas (no menos, no mas)
 - NIVEL 1: 80-200 lineas por componente
 - NIVEL 2: 40-120 lineas por modulo
-- Si te queda corto → leiste pocos archivos, lee mas
+- Si te queda corto → leiste pocos archivos, no agregues relleno — simplemente genera con lo que hay
 - Si te queda largo → estas repitiendo o agregando relleno, recorta
 
 ================================================================

package/package.json

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