agent-mp 0.5.2 → 0.5.4

package/dist/commands/repl.js

@@ -994,6 +994,16 @@ export async function runRepl(resumeSession) {
                 const dir = await resolveProjectDir(process.cwd());
                 const config = await loadProjectConfig(dir);
                 if (args[0] === 'orch' || args[0] === 'orchestrator') {
+                    // Ensure documentation exists before orchestrator runs
+                    const contextDir = path.join(dir, '.agent', 'context');
+                    const archPath = path.join(contextDir, 'architecture.md');
+                    if (!(await fileExists(archPath))) {
+                        fi.println(chalk.yellow('\n  ── Generando documentación del proyecto ──'));
+                        fi.println(chalk.dim('  El orquestador necesita conocer la estructura del proyecto primero.\n'));
+                        const prepEngine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                        await prepEngine.runExplorer('Document the complete project structure, services, dependencies, and entry points. Create/update .agent/context/architecture.md');
+                        fi.println(chalk.green('  ✓ Documentación del proyecto generada.\n'));
+                    }
                     const task = args.slice(1).join(' ');
                     const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
                     const result = await engine.runOrchestrator(task);
@@ -1106,6 +1116,16 @@ export async function runRepl(resumeSession) {
                     fi.println(chalk.red('  No roles configured. Run /config-multi first.'));
                 }
                 else {
+                    // Before running the orchestrator, ensure project documentation exists
+                    const contextDir = path.join(dir, '.agent', 'context');
+                    const archPath = path.join(contextDir, 'architecture.md');
+                    if (!(await fileExists(archPath))) {
+                        fi.println(chalk.yellow('\n  ── Generando documentación del proyecto ──'));
+                        fi.println(chalk.dim('  El orquestador necesita conocer la estructura del proyecto primero.\n'));
+                        const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                        await engine.runExplorer('Document the complete project structure, services, dependencies, and entry points. Create/update .agent/context/architecture.md');
+                        fi.println(chalk.green('  ✓ Documentación del proyecto generada.\n'));
+                    }
                     const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
                     await engine.runFullCycle(trimmed);
                     session.messages.push({ role: 'agent', content: `[task cycle completed for: ${trimmed}]`, ts: new Date().toISOString() });

package/dist/core/engine.js

@@ -988,31 +988,44 @@ INSTRUCCIONES:
             existingArch = await readFile(archPath);
         }
         catch { /* new project */ }
+        // Build a quick filesystem snapshot to give the explorer context
+        let fsSnapshot = '';
+        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 });
+        }
+        catch { /* ignore */ }
         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):
+${fsSnapshot}
+
 ${existingArch ? `DOCUMENTACION EXISTENTE (actualizar si hay cambios):\n${existingArch.slice(0, 3000)}\n` : 'DOCUMENTACION EXISTENTE: ninguna — crear desde cero.\n'}
 INSTRUCCIONES:
-1. Lista el directorio raiz para identificar todos los servicios/aplicaciones.
-2. Para cada servicio/app: lee su package.json / requirements.txt / pyproject.toml para obtener nombre, stack y dependencias clave.
-3. Explora src/ o app/ de cada servicio: identifica entry point, modulos principales, rutas/endpoints expuestos, puerto configurado.
-4. Identifica dependencias ENTRE servicios (llamadas HTTP, variables de entorno compartidas, bases de datos comunes).
-5. Crea o actualiza el archivo ${archPath} con:
-   - Tabla resumen: | Servicio | Stack | Puerto | Proposito | Entry Point |
-   - Por cada servicio: modulos principales, rutas API clave, dependencias externas
-   - Mapa de dependencias entre servicios
-6. Crea o actualiza archivos individuales en ${contextDir}/<servicio>/architecture.md para cada servicio.
-7. Al terminar lista todos los archivos creados/actualizados.
+Analiza el listado de archivos de arriba y genera documentación completa del proyecto. Escribe el archivo de architecture.md usando el formato de write_file tool.
+
+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)
+
+FORMATO DEL ARCHIVO A CREAR (${archPath}):
+Escribe el contenido completo del archivo architecture.md usando la herramienta write_file.
 
 REGLAS:
-- Escribe UNICAMENTE los archivos indicados: ${archPath} y ${contextDir}/<servicio>/architecture.md
-- NO crees archivos adicionales ni con otros nombres
+- Crea UNICAMENTE: ${archPath}
+- NO crees subdirectorios ni archivos adicionales
 - NO modifiques archivos de aplicacion
-- NO ejecutes comandos que cambien estado (npm install, migraciones, etc.)
-- Si un directorio esta en node_modules, dist, .git: ignoralo`;
+- NO ejecutes comandos
+- Documenta TODO el proyecto (todos los subdirectorios al nivel de DIRECTORIO_TRABAJO, excluyendo .agent)`;
         const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
         const text = extractCliText(res);
         // Overwrite the single last-run report (no timestamp accumulation)

package/package.json

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