agent-mp 0.3.9 → 0.4.1

package/dist/core/engine.d.ts

@@ -40,6 +40,14 @@ export declare class AgentEngine {
     runReviewer(taskId: string, plan: TaskPlan, progress: TaskProgress): Promise<{
         verdict: string;
     }>;
+    /**
+     * Scan contextDir for stray files (outside the allowed structure) and clean them up:
+     * - Old timestamped explorer-*.md reports → delete (content already in architecture.md)
+     * - Other stray .md files at root level → append content to architecture.md, then delete
+     * Allowed root-level files: architecture.md, explorer-last.md
+     * Allowed subdirectory files: <service>/architecture.md  (not touched here)
+     */
+    private _cleanContextDir;
     runExplorer(task?: string): Promise<string>;
     /** Called when the current binary IS the configured explorer CLI (prevents recursion).
      *  Builds the full exploration prompt and calls Qwen API using own credentials. */

package/dist/core/engine.js

@@ -799,6 +799,66 @@ INSTRUCCIONES:
         log.verdict(verdict);
         return { verdict };
     }
+    /**
+     * Scan contextDir for stray files (outside the allowed structure) and clean them up:
+     * - Old timestamped explorer-*.md reports → delete (content already in architecture.md)
+     * - Other stray .md files at root level → append content to architecture.md, then delete
+     * Allowed root-level files: architecture.md, explorer-last.md
+     * Allowed subdirectory files: <service>/architecture.md  (not touched here)
+     */
+    async _cleanContextDir(contextDir) {
+        let entries;
+        try {
+            entries = await fs.readdir(contextDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        } // dir doesn't exist yet
+        const archPath = path.join(contextDir, 'architecture.md');
+        const stray = [];
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            if (!e.name.endsWith('.md'))
+                continue;
+            if (e.name === 'architecture.md' || e.name === 'explorer-last.md')
+                continue;
+            stray.push(e.name);
+        }
+        if (stray.length === 0)
+            return;
+        log.info(`Limpiando ${stray.length} archivo(s) fuera de estructura en .agent/context/`);
+        for (const name of stray) {
+            const filePath = path.join(contextDir, name);
+            // Old timestamped explorer reports — just delete (content is redundant)
+            if (/^explorer-\d{4}-\d{2}-/.test(name)) {
+                await fs.unlink(filePath);
+                log.ok(`  Eliminado: ${name}`);
+                continue;
+            }
+            // Other stray files — migrate content to architecture.md, then delete
+            try {
+                const content = (await readFile(filePath)).trim();
+                if (content) {
+                    let arch = '';
+                    try {
+                        arch = await readFile(archPath);
+                    }
+                    catch { /* no arch yet */ }
+                    const label = name.replace(/\.md$/, '');
+                    await writeFile(archPath, `${arch}\n\n---\n## ${label}\n\n${content}\n`);
+                    log.ok(`  Migrado: ${name} → architecture.md`);
+                }
+                else {
+                    log.ok(`  Eliminado (vacío): ${name}`);
+                }
+                await fs.unlink(filePath);
+            }
+            catch (err) {
+                log.warn(`  No se pudo limpiar ${name}: ${err.message}`);
+            }
+        }
+    }
     async runExplorer(task) {
         if (!this.config.roles.explorer) {
             if (!this.config.fallback_global) {
@@ -813,6 +873,8 @@ INSTRUCCIONES:
         const contextDir = path.join(agentDir, 'context');
         await fs.mkdir(contextDir, { recursive: true });
         await fs.mkdir(path.join(agentDir, 'rules'), { recursive: true });
+        // Clean up stray files before running
+        await this._cleanContextDir(contextDir);
         // Read existing architecture doc if any
         const archPath = path.join(contextDir, 'architecture.md');
         let existingArch = '';
@@ -840,16 +902,16 @@ INSTRUCCIONES:
 7. Al terminar lista todos los archivos creados/actualizados.
 
 REGLAS:
-- NO modifiques archivos de aplicacion (solo .agent/context/)
+- Escribe UNICAMENTE los archivos indicados: ${archPath} y ${contextDir}/<servicio>/architecture.md
+- NO crees archivos adicionales ni con otros nombres
+- 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`;
         const res = await this.runWithFallback('explorer', prompt, 'Exploracion');
         const text = extractCliText(res);
-        // Always save a timestamped explorer report
+        // Overwrite the single last-run report (no timestamp accumulation)
         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`);
+            await writeFile(path.join(contextDir, 'explorer-last.md'), `# Explorer Report\n\nTask: ${effectiveTask}\nDate: ${new Date().toISOString()}\n\n${text}\n`);
         }
         catch { /* don't fail if save fails */ }
         return text;
@@ -863,6 +925,8 @@ REGLAS:
         const agentDir = path.join(this.projectDir, '.agent');
         const contextDir = path.join(agentDir, 'context');
         await fs.mkdir(contextDir, { recursive: true });
+        // Clean up stray files before running
+        await this._cleanContextDir(contextDir);
         const archPath = path.join(contextDir, 'architecture.md');
         let existingArch = '';
         try {
@@ -883,7 +947,11 @@ INSTRUCCIONES:
 2. Para cada uno: lee package.json/requirements.txt, explora src/, identifica entry point, rutas/endpoints, puerto.
 3. Identifica dependencias entre servicios.
 4. Crea/actualiza ${archPath} con tabla resumen y detalle por servicio.
-5. Crea/actualiza ${contextDir}/<servicio>/architecture.md para cada servicio.`);
+5. Crea/actualiza ${contextDir}/<servicio>/architecture.md para cada servicio.
+
+REGLAS:
+- Escribe UNICAMENTE los archivos indicados: ${archPath} y ${contextDir}/<servicio>/architecture.md
+- NO crees archivos adicionales ni con otros nombres en ningun directorio`);
         let result;
         const stopSpin = this._startSpinner(`agent-explorer  ${role.model}`);
         try {
@@ -900,9 +968,7 @@ INSTRUCCIONES:
             throw err;
         }
         try {
-            const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-            await writeFile(path.join(contextDir, `explorer-${ts}.md`), `# Explorer Report\n\nTask: ${effectiveTask}\n\n${result}\n`);
-            log.ok(`Saved to .agent/context/explorer-${ts}.md`);
+            await writeFile(path.join(contextDir, 'explorer-last.md'), `# Explorer Report\n\nTask: ${effectiveTask}\nDate: ${new Date().toISOString()}\n\n${result}\n`);
         }
         catch { /* ignore */ }
         return result;

package/package.json

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