agent-mp 0.5.19 → 0.5.20

package/dist/core/engine.js

@@ -1513,73 +1513,6 @@ QUE NO HACER
 - NO documentar componentes triviales (scripts, docs, configs sueltas) con su propia carpeta — mencionalos en NIVEL 0 y listo
 - NO inventar endpoints, env vars, puertos o schemas que no leiste
 
-================================================================
-DIRECTORIO .agent/docs/ — FLUJOS POR FUNCIONALIDAD (orientado a desarrolladores)
-================================================================
-Ademas de los archivos de context/, generar docs de flujos. Objetivo: un dev que llega al proyecto puede buscar "como funciona el login" o "donde esta el endpoint de clientes" y encontrar exactamente que archivos tocar, en que orden, y por que.
-
-Generar UN archivo por cada flujo funcional principal que puedas identificar de los CONTROLLER/ROUTER leidos.
-Si no hay controllers, inferir los flujos desde el MANIFEST y el ENTRY POINT.
-
-INDICE OBLIGATORIO:
-=== .agent/docs/README.md ===
-# Flujos del proyecto — Indice
-
-| Flujo | Descripcion | Componente(s) |
-|-------|-------------|---------------|
-| [nombre-flujo](nombre-flujo.md) | 1 linea que explica que hace | componente-a, componente-b |
-...
-
-POR CADA FLUJO:
-=== .agent/docs/[nombre-flujo].md ===
-Nombre del archivo: kebab-case del nombre del flujo (auth.md, crear-cliente.md, consulta-ventas.md)
-
-Estructura de cada archivo de flujo:
-
-# Flujo: [Nombre legible]
-
-## Qué hace
-1 linea en lenguaje de negocio: "Permite al usuario X hacer Y"
-
-## Componentes involucrados
-- [componente-a]: rol en este flujo
-- [componente-b]: rol en este flujo
-
-## Traza técnica paso a paso
-Numberar cada paso. Incluir archivo y funcion/clase cuando fue leido.
-1. Cliente/Frontend → METODO /ruta/endpoint (archivo: ruta/al/Controller)
-2. Middleware/Guard/Filter valida/transforma (archivo: ruta/al/Filter o Config)
-3. Service/UseCase ejecuta la logica (archivo: ruta/al/Service)
-4. Repository/DAO consulta o escribe en DB (archivo: ruta/al/Repository → tabla o coleccion)
-5. Respuesta: codigo HTTP + shape de respuesta
-
-## Archivos involucrados y por qué
-Esta tabla es lo mas importante para un dev nuevo: tiene que saber QUE archivo y POR QUE esta en el flujo.
-| Archivo (ruta relativa al componente) | Por que esta en este flujo |
-|---------------------------------------|---------------------------|
-| ruta/Controller | Recibe el request y delega |
-| ruta/Service | Contiene la logica de negocio |
-| ruta/Repository | Lee o escribe en la base de datos |
-| ruta/Entity o Schema | Define la forma del dato |
-| ruta/Config o Filter | Aplica seguridad / transformacion |
-
-## Variables / configuracion relevante
-Solo las que afectan directamente este flujo (env vars, properties, feature flags).
-
-## Como probar este flujo
-- Endpoint: METODO /ruta
-- Body o params de ejemplo
-- Respuesta exitosa: codigo + campos
-- Errores comunes: codigo + cuando ocurre
-
-================================================================
-CALIBRACION DE DETALLE — docs/
-================================================================
-- README.md: una fila por flujo, no mas
-- Por flujo: 30-80 lineas. Concreto. Si un paso no fue leido, omitirlo.
-- NO inventar nombres de archivos. Si no se leyo un Service para este flujo, no lo pongas.
-- Generar entre 2 y 8 flujos segun la cantidad de controllers/features encontrados.
-
 ================================================================
 FORMATO DE SALIDA — OBLIGATORIO
 ================================================================
@@ -1591,9 +1524,8 @@ 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/docs/README.md ===
-  === .agent/docs/auth.md ===
-  === .agent/docs/consulta-ventas.md ===
+  === .agent/context/nexus-core-api/architecture.md ===
+  === .agent/context/nexus-core-api/modules/clients.md ===
 
 === .agent/context/architecture.md ===
 [contenido NIVEL 0]
@@ -1604,19 +1536,12 @@ Ejemplos de marcadores validos:
 === .agent/context/nombre-componente/modules/auth.md ===
 [contenido NIVEL 2]
 
-=== .agent/docs/README.md ===
-[indice de flujos]
-
-=== .agent/docs/auth.md ===
-[flujo de autenticacion]
-
 REGLAS DE PATHS:
 - 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 ===
-- Indice de flujos: === .agent/docs/README.md ===
-- Por flujo: === .agent/docs/[nombre-flujo].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);
@@ -1646,36 +1571,24 @@ REGLAS DE PATHS:
             content = content.replace(/^```markdown\s*/i, '').replace(/^```\s*$/gm, '').trim();
             if (!content)
                 continue;
-            // Detect routing: .agent/docs/ → docsDir, .agent/context/ → contextDir
-            const isDocsFile = /^\.agent[\/\\]docs[\/\\]/i.test(fileName);
+            // All explorer output goes under .agent/context/ — docs/ is manual-only
+            const relPath = fileName.replace(/^\.agent\/context\//i, '').replace(/^\/+/, '');
             let targetPath = null;
-            if (isDocsFile) {
-                // .agent/docs/README.md → docsDir/README.md
-                // .agent/docs/auth.md  → docsDir/auth.md
-                const docsRel = fileName.replace(/^\.agent[\/\\]docs[\/\\]/i, '').replace(/^\/+/, '');
-                if (docsRel && docsRel.endsWith('.md')) {
-                    targetPath = path.join(docsDir, ...docsRel.split(/[\/\\]/).filter(Boolean));
-                }
+            if (relPath === 'architecture.md' || relPath === 'ARCHITECTURE.md') {
+                targetPath = mainArchPath;
             }
             else {
-                // .agent/context/ files (existing behaviour)
-                const relPath = fileName.replace(/^\.agent\/context\//i, '').replace(/^\/+/, '');
-                if (relPath === 'architecture.md' || relPath === 'ARCHITECTURE.md') {
-                    targetPath = mainArchPath;
+                const pathParts = relPath.split(/[\/\\]/).filter(Boolean);
+                if (pathParts.length >= 3 && pathParts[pathParts.length - 2] === 'modules') {
+                    targetPath = path.join(contextDir, pathParts[pathParts.length - 3], 'modules', pathParts[pathParts.length - 1]);
                 }
-                else {
-                    const pathParts = relPath.split(/[\/\\]/).filter(Boolean);
-                    if (pathParts.length >= 3 && pathParts[pathParts.length - 2] === 'modules') {
-                        targetPath = path.join(contextDir, pathParts[pathParts.length - 3], 'modules', pathParts[pathParts.length - 1]);
-                    }
-                    else if (pathParts.length >= 2) {
-                        targetPath = path.join(contextDir, pathParts[pathParts.length - 2], pathParts[pathParts.length - 1]);
-                    }
+                else if (pathParts.length >= 2) {
+                    targetPath = path.join(contextDir, pathParts[pathParts.length - 2], pathParts[pathParts.length - 1]);
                 }
             }
             if (!targetPath)
                 continue;
-            pendingWrites.push({ targetPath, content, label: fileName.trim() });
+            pendingWrites.push({ targetPath, content, label: relPath });
         }
         if (pendingWrites.length === 0) {
             log.error('Explorer devolvio texto pero ningun bloque === *.md === fue parseable.');

package/package.json

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