agent-rev 0.2.8 → 0.3.0

package/dist/commands/repl.js

@@ -716,10 +716,12 @@ function cmdHelp(fi) {
         { key: '/setup explorer', value: 'Reconfigure explorer only' },
         { key: '/config-multi', value: 'Reconfigure all agents at once' },
         { key: '/status', value: 'Show current configuration and tasks' },
+        { key: '/explorer <task>', value: 'Run explorer agent on a task/question' },
         { key: '/run <task>', value: 'Full cycle: orchestrator → implementor → reviewer' },
         { key: '/run orch <task>', value: 'Run only orchestrator' },
         { key: '/run impl <id>', value: 'Run only implementor' },
         { key: '/run rev <id>', value: 'Run only reviewer' },
+        { key: '/run explorer <task>', value: 'Run only explorer' },
         { key: '/models', value: 'List models for all installed CLIs' },
         { key: '/models <cli>', value: 'List models for a specific CLI' },
         { key: '/login', value: 'Login (Qwen OAuth or CLI auth)' },
@@ -1035,6 +1037,12 @@ export async function runRepl(resumeSession) {
                     const progress = await readJson(path.join(taskDir, 'progress.json'));
                     await engine.runReviewer(taskId, plan, progress);
                 }
+                else if (args[0] === 'explorer' || args[0] === 'exp') {
+                    const task = args.slice(1).join(' ') || undefined;
+                    const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                    const result = await engine.runExplorer(task);
+                    fi.println(result);
+                }
                 else {
                     const task = args.join(' ');
                     const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
@@ -1042,6 +1050,20 @@ export async function runRepl(resumeSession) {
                 }
                 break;
             }
+            case 'explorer': {
+                const task = args.join(' ') || undefined;
+                try {
+                    const dir = process.cwd();
+                    const config = await loadProjectConfig(dir);
+                    const engine = new AgentEngine(config, dir, gCoordinatorCmd, rl, fi, handleCmd);
+                    const result = await engine.runExplorer(task);
+                    fi.println(result);
+                }
+                catch (err) {
+                    fi.println(chalk.red(`  Explorer error: ${err.message}`));
+                }
+                break;
+            }
             case 'models':
             case 'model':
                 await withRl((rl) => cmdModels(args[0], fi, rl));
@@ -1203,6 +1225,12 @@ export async function runRole(role, arg, model) {
                 await engine.runReviewer(arg, plan, progress);
                 break;
             }
+            case 'explorer':
+            case 'exp': {
+                const result = await engine.runExplorer(arg || undefined);
+                console.log(result);
+                break;
+            }
             case 'coordinator':
             case 'coord': {
                 console.log(chalk.yellow('  Coordinator mode requires interactive REPL.'));
@@ -1210,7 +1238,7 @@ export async function runRole(role, arg, model) {
                 process.exit(1);
             }
             default:
-                console.log(chalk.red(`  Unknown role: ${role}. Use: orchestrator, implementor, reviewer`));
+                console.log(chalk.red(`  Unknown role: ${role}. Use: orchestrator, implementor, reviewer, explorer`));
                 process.exit(1);
         }
     }

package/dist/core/engine.d.ts

@@ -38,5 +38,6 @@ export declare class AgentEngine {
     runReviewer(taskId: string, plan: TaskPlan, progress: TaskProgress): Promise<{
         verdict: string;
     }>;
+    runExplorer(task?: string): Promise<string>;
     runFullCycle(task: string): Promise<void>;
 }

package/dist/core/engine.js

@@ -346,6 +346,7 @@ INSTRUCCIONES:
             orchestrator: 'orchestrator',
             implementor: 'implementor',
             reviewer: 'reviewer',
+            explorer: 'explorer',
         };
         const key = roleMap[roleName];
         const role = this.config.roles[key];
@@ -446,15 +447,23 @@ INSTRUCCIONES:
                 }
             }
         };
+        // Role binaries (agent-orch, agent-impl, etc.) are wrappers, not AI CLIs.
+        // Calling them with a full prompt causes recursion or ENAMETOOLONG errors.
+        const ROLE_BINARIES = new Set(['agent-orch', 'agent-impl', 'agent-rev', 'agent-explorer']);
         // Try primary
         log.info(`Launching ${roleName}: ${role.cli} (${role.model})`);
-        const primaryResult = await tryWithAutoRepair(role.cli, role.model, role.cmd);
-        if (primaryResult !== null) {
-            trackTokens(primaryResult, role.cli, role.model);
-            return primaryResult;
+        if (ROLE_BINARIES.has(role.cli)) {
+            log.warn(`${role.cli} is a role binary — skipping to fallback to avoid recursion`);
+        }
+        else {
+            const primaryResult = await tryWithAutoRepair(role.cli, role.model, role.cmd);
+            if (primaryResult !== null) {
+                trackTokens(primaryResult, role.cli, role.model);
+                return primaryResult;
+            }
         }
         // Try individual fallback
-        if (role.fallback) {
+        if (role.fallback && !ROLE_BINARIES.has(role.fallback.cli)) {
             log.warn(`Trying individual fallback for ${roleName}: ${role.fallback.cli} (${role.fallback.model})`);
             const fallbackResult = await tryWithAutoRepair(role.fallback.cli, role.fallback.model, role.fallback.cmd);
             if (fallbackResult !== null) {
@@ -489,6 +498,10 @@ REGLA: Al terminar, responde SOLO con el JSON de progreso indicado.`,
 REGLA: Usa tus herramientas (read_file, grep_search, etc.) para leer los archivos y verificar criterios.
 REGLA: NO modifiques archivos. NO implementes correcciones.
 REGLA: Al terminar, responde SOLO con el JSON de resultado indicado.`,
+            explorer: `ROL: EXPLORER — solo explora y reporta, nunca modifica archivos.
+REGLA: Usa tus herramientas (read_file, grep_search, list_directory, etc.) para explorar el proyecto.
+REGLA: NO modifiques archivos. NO ejecutes comandos que cambien estado.
+REGLA: Al terminar, reporta todo lo que encontraste de forma clara y estructurada.`,
         };
         const preamble = preambles[roleName] || '';
         return preamble ? `${preamble}\n\n${taskPrompt}` : taskPrompt;
@@ -726,6 +739,61 @@ INSTRUCCIONES:
         log.verdict(verdict);
         return { verdict };
     }
+    async runExplorer(task) {
+        if (!this.config.roles.explorer) {
+            if (!this.config.fallback_global) {
+                throw new Error('Explorer not configured and no fallback available. Run /setup explorer first.');
+            }
+            log.warn(`Explorer role not configured — using fallback: ${this.config.fallback_global.cli} (${this.config.fallback_global.model})`);
+            this.config.roles.explorer = { ...this.config.fallback_global };
+        }
+        log.phase(0, 'Exploracion', this.config.roles.explorer.cli, this.config.roles.explorer.model);
+        // Ensure .agent/ structure exists
+        const agentDir = path.join(this.projectDir, '.agent');
+        const contextDir = path.join(agentDir, 'context');
+        await fs.mkdir(contextDir, { recursive: true });
+        await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
+        // Read existing architecture doc if any
+        const archPath = path.join(contextDir, 'architecture.md');
+        let existingArch = '';
+        try {
+            existingArch = await readFile(archPath);
+        }
+        catch { /* new project */ }
+        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}
+
+${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.
+
+REGLAS:
+- NO modifiques archivos de aplicacion (solo .agent/context/)
+- NO ejecutes comandos que cambien estado (npm install, migraciones, etc.)
+- Si un directorio esta en node_modules, dist, .git: ignoralo`;
+        const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
+        const text = extractCliText(res);
+        // Always save a timestamped explorer report
+        try {
+            const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+            await writeFile(path.join(contextDir, `explorer-${ts}.md`), `# Explorer Report\n\nTask: ${effectiveTask}\nDate: ${new Date().toISOString()}\n\n${text}\n`);
+            log.ok(`Saved to .agent/context/explorer-${ts}.md`);
+        }
+        catch { /* don't fail if save fails */ }
+        return text;
+    }
     async runFullCycle(task) {
         // Header is now shown by the REPL before the first user message
         // ══════════════════════════════════════════════════

package/dist/index.js

@@ -85,6 +85,20 @@ const ROLE_BINS = {
 const nativeRole = ROLE_BINS[PKG_NAME];
 if (nativeRole) {
     const args = process.argv.slice(2);
+    // --version / -V
+    if (args.includes('--version') || args.includes('-V')) {
+        console.log(readVersion());
+        process.exit(0);
+    }
+    // --help / -h
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(chalk.bold.cyan(`\n  ${PKG_NAME} v${readVersion()} — ${nativeRole} agent\n`));
+        console.log(chalk.dim(`  Usage:   ${PKG_NAME} [--model <model>] "<task>"`));
+        console.log(chalk.dim(`  Login:   ${PKG_NAME} --login`));
+        console.log(chalk.dim(`  Status:  ${PKG_NAME} --status`));
+        console.log(chalk.dim(`  Version: ${PKG_NAME} --version\n`));
+        process.exit(0);
+    }
     // --login: OAuth login for this role's account
     if (args.includes('--login') || args.includes('login')) {
         const { qwenLogin, fetchQwenModels } = await import('./utils/qwen-auth.js');

package/package.json

@@ -1 +1,23 @@
-{"name":"agent-rev","version":"0.2.8","description":"agent-rev agent","type":"module","main":"./dist/index.js","files":["dist/"],"bin":{"agent-rev":"dist/index.js"},"scripts":{"build":"tsc && echo '#!/usr/bin/env node' | cat - dist/index.js > dist/index.tmp && mv dist/index.tmp dist/index.js && chmod +x dist/index.js","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"keywords":["ai","agent","cli"],"license":"MIT","dependencies":{"@anthropic-ai/sdk":"^0.39.0","@google/generative-ai":"^0.24.0","chalk":"^5.4.1","commander":"^13.1.0","open":"^11.0.0","openai":"^4.91.0"},"devDependencies":{"@types/node":"^22.13.0","@types/open":"^6.1.0","tsx":"^4.19.3","typescript":"^5.7.3"},"engines":{"node":">=18.0.0"}}
+{
+  "name": "agent-rev",
+  "version": "0.3.0",
+  "description": "agent-rev agent",
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": ["dist/"],
+  "bin": { "agent-rev": "dist/index.js" },
+  "scripts": {
+    "build": "tsc && echo '#!/usr/bin/env node' | cat - dist/index.js > dist/index.tmp && mv dist/index.tmp dist/index.js && chmod +x dist/index.js"
+  },
+  "keywords": ["ai", "agent", "cli"],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@google/generative-ai": "^0.24.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "open": "^11.0.0",
+    "openai": "^4.91.0"
+  },
+  "engines": { "node": ">=18.0.0" }
+}