@liriraid/agentflow-ai 1.0.26 → 1.0.28

package/orchestrator.js

@@ -1013,35 +1013,6 @@ function parseCompletedFromFile() {
 }
 
 const loggedUnknownAgents = new Set();
-let queueWatcher = null;
-
-function setupQueueWatcher() {
-  if (!fs.existsSync(QUEUE_FILE)) return;
-  
-  if (queueWatcher) {
-    try { queueWatcher.close(); } catch {}
-    queueWatcher = null;
-  }
-  
-  try {
-    queueWatcher = fs.watch(QUEUE_FILE, { persistent: false }, (eventType, filename) => {
-      if (eventType === 'change' && filename === path.basename(QUEUE_FILE)) {
-        log('DEBUG', `QUEUE.md changed, reloading queue immediately`);
-        reloadQueue();
-        scheduleNext();
-        renderDashboard();
-      }
-    });
-    queueWatcher.on('error', (err) => {
-      log('WARN', `fs.watch failed for QUEUE.md: ${err.message}, falling back to polling`);
-      queueWatcher = null;
-    });
-    log('INFO', 'Realtime QUEUE.md watcher enabled');
-  } catch (err) {
-    log('WARN', `Failed to setup QUEUE.md watcher: ${err.message}, using polling`);
-    queueWatcher = null;
-  }
-}
 
 function reloadQueue() {
   state.queue = parseQueue();
@@ -1183,16 +1154,8 @@ function generateBrief(task) {
     if (taskMatch) taskEntry = taskMatch[0];
   }
 
-  // Global developer standards — read the user's ~/.claude/CLAUDE.md verbatim.
-  // Each developer has their own standards there; we don't parse specific sections.
-  let globalStandards = "";
-  const globalClaude = path.join(GLOBAL_CLAUDE_DIR, "CLAUDE.md");
-  if (fs.existsSync(globalClaude)) {
-    globalStandards = fs.readFileSync(globalClaude, "utf-8").trim();
-  }
-
-  // Project plan — if `<projectName>-plan.md` or `PLAN.md` exists in the workspace,
-  // inject it as shared context so every agent sees the big-picture plan.
+  // Project plan — only inject the first 60 lines as orientation context.
+  // Worker agents don't need the full plan to execute a single task.
   let projectPlan = "";
   const planCandidates = [
     path.join(
@@ -1204,7 +1167,9 @@ function generateBrief(task) {
   ];
   for (const p of planCandidates) {
     if (fs.existsSync(p)) {
-      projectPlan = fs.readFileSync(p, "utf-8");
+      const lines = fs.readFileSync(p, "utf-8").split("\n");
+      projectPlan = lines.slice(0, 60).join("\n");
+      if (lines.length > 60) projectPlan += "\n\n[Plan truncated — full plan in PLAN.md]";
       break;
     }
   }
@@ -1230,10 +1195,8 @@ function generateBrief(task) {
 # Priority: ${task.priority}
 # Workspace: ${WORKSPACE}
 # Progress file: ${progressFile}
-# Global supply chain: ${GLOBAL_CLAUDE_DIR}
 
-${globalStandards ? `## Global Developer Standards\n> Extracted from ${globalClaude} — apply these rules to ALL code in this task.\n\n${globalStandards}\n` : ""}
-${projectPlan ? `## Project Plan (big picture — use as context, don't try to do everything)\n${projectPlan}\n` : ""}
+${projectPlan ? `## Project Plan (orientation only — focus on your task)\n${projectPlan}\n` : ""}
 ${agentInstructions ? `## Agent Instructions\n${agentInstructions}` : ""}
 ${protocolRules ? `## Protocol Rules\n${protocolRules}` : ""}
 
@@ -1444,7 +1407,7 @@ function launchAgent(task) {
                 if (txt) {
                   for (const l of txt.split("\n").slice(-3))
                     appendToAgent(agentName, l.slice(0, 120));
-                  ag.lastLine = txt.split("\n").pop().slice(0, 80);
+                  ag.lastLine = (txt.split("\n").pop() || "").slice(0, 80);
                 }
               }
               if (block.type === "tool_use") {
@@ -1708,6 +1671,7 @@ function failTask(task, agentName, code) {
     task.status = "failed";
     ag.lastLine = L.lastFailed(task.id);
     log("ERROR", L.logPermanentFail(task.id, retries));
+    updateQueueFile(task);
     writeNotifyFile(L.notifyPermanentFail(timestamp(), task.id, agentName));
   } else {
     task.status = "pending";
@@ -1893,6 +1857,7 @@ function getClaudeFallbackAgent(task) {
 
 function getAlternativeSupportAgent(failedAgentName) {
   if (failedAgentName === "OpenCode") return "Codex";
+  if (failedAgentName === "Codex") return "OpenCode";
   return null;
 }
 
@@ -1930,45 +1895,9 @@ function tryFallbackToAlternative(task, failedAgentName, reason) {
     log("WARN", L.logReassignWarn(task.id, targetAgent));
   }
 
-  // Notificar a Claude (sesión principal) cuando hay fallback
-  notifyClaudeOfFallback(task, failedAgentName, targetAgent, reason);
   return true;
 }
 
-// ============================================================================
-// CLAUDE FALLBACK NOTIFIER — avisa a Claude principal cuando hay reasignación
-// ============================================================================
-function notifyClaudeOfFallback(task, fromAgent, toAgent, reason) {
-  const lang = WORKSPACE_LANGUAGE;
-  const prompt = lang === 'es'
-    ? `⚠️ FALLBACK: La tarea "${task.id}: ${task.title}" falló en ${fromAgent} (${reason}) y fue reasignada a ${toAgent}.
-
-Estado actual:
-- QUEUE.md tiene ahora la tarea asignada a ${toAgent}
-- El agente ${toAgent} está procediendo automáticamente
-
- Acción: No necesitas hacer nada — solo toma nota del cambio. El orquestador将继续 automáticamente.
-Si quieres revisar el progreso, lee INBOX.md o STATUS.md.`
-    : `⚠️ FALLBACK: Task "${task.id}: ${task.title}" failed on ${fromAgent} (${reason}) and was reassigned to ${toAgent}.
-
-Current state:
-- QUEUE.md now has the task assigned to ${toAgent}
-- Agent ${toAgent} is proceeding automatically
-
-Action: You don't need to do anything — just take note of the change. The orchestrator will continue automatically.
-If you want to check progress, read INBOX.md or STATUS.md.`;
-
-  const logPath = path.join(LOG_DIR, `fallback-notify-${Date.now()}.log`);
-  try {
-    const logFd = fs.openSync(logPath, 'a');
-    const child = spawn('claude', ['-p', prompt, '--add-dir', WORKSPACE, '--dangerously-skip-permissions'], {
-      cwd: WORKSPACE, stdio: ['ignore', logFd, logFd], shell: true, windowsHide: true, detached: true
-    });
-    fs.closeSync(logFd);
-    child.unref();
-  } catch {}
-}
-
 // ============================================================================
 // KEYBOARD
 // ============================================================================
@@ -2073,7 +2002,6 @@ function setupFallbackQueueWatcher() {
 }
 
 startQueueWatcher();
-setupQueueWatcher();
 
 // Slow fallback (5 min) — only runs if there is actually pending work or busy agents
 // fs.watch handles real-time; this is just a safety net
@@ -2112,7 +2040,7 @@ function runAwayModeCheck() {
   const completedCount = (state.completed || []).length;
   const hasWork = pendingTasks.length > 0 || inProgressTasks.length > 0 || busy;
 
-  if (!hasWork && completedCount > 0) {
+  if (!hasWork) {
     try { fs.unlinkSync(AWAY_MODE_FILE); } catch {}
     deactivateAwayMode();
 

package/package.json

@@ -1,65 +1,64 @@
-{
-  "name": "@liriraid/agentflow-ai",
-  "version": "1.0.26",
-  "description": "Multi-agent workspace orchestrator with TUI. Coordinates AI coding agents over your real frontend and backend projects.",
-  "author": "LiriRaid",
-  "homepage": "https://github.com/LiriRaid/agentflow-ai#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/LiriRaid/agentflow-ai.git"
-  },
-  "bugs": {
-    "url": "https://github.com/LiriRaid/agentflow-ai/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "orchestrator.js",
-  "bin": {
-    "agentflow": "bin/agentflow.mjs"
-  },
-  "files": [
-    "bin",
-    "src",
-    "templates",
-    "orchestrator.js",
-    "LICENSE",
-    "README.md"
-  ],
-  "packageManager": "pnpm@11.6.0",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "start": "node orchestrator.js",
-    "start:paused": "node orchestrator.js --paused",
-    "start:ink": "node src/ink/index.mjs",
-    "start:ink:paused": "node src/ink/index.mjs --paused",
-    "cli:help": "node bin/agentflow.mjs --help"
-  },
-  "keywords": [
-    "ai",
-    "agents",
-    "orchestrator",
-    "agentflow-ai",
-    "claude",
-    "codex",
-    "gemini",
-    "cursor",
-    "opencode",
-    "abacus",
-    "tui",
-    "multi-agent",
-    "coding-assistant",
-    "openspec",
-    "engram",
-    "skills",
-    "agent-config"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "blessed": "^0.1.81",
-    "ink": "^5.2.1",
-    "react": "^18.3.1"
-  }
-}
+{
+  "name": "@liriraid/agentflow-ai",
+  "version": "1.0.28",
+  "description": "Multi-agent workspace orchestrator with TUI. Coordinates AI coding agents over your real frontend and backend projects.",
+  "author": "LiriRaid",
+  "homepage": "https://github.com/LiriRaid/agentflow-ai#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LiriRaid/agentflow-ai.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LiriRaid/agentflow-ai/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "orchestrator.js",
+  "bin": {
+    "agentflow": "bin/agentflow.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "orchestrator.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "orchestrator",
+    "agentflow-ai",
+    "claude",
+    "codex",
+    "gemini",
+    "cursor",
+    "opencode",
+    "abacus",
+    "tui",
+    "multi-agent",
+    "coding-assistant",
+    "openspec",
+    "engram",
+    "skills",
+    "agent-config"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "blessed": "^0.1.81",
+    "ink": "^5.2.1",
+    "react": "^18.3.1"
+  },
+  "scripts": {
+    "start": "node orchestrator.js",
+    "start:paused": "node orchestrator.js --paused",
+    "start:ink": "node src/ink/index.mjs",
+    "start:ink:paused": "node src/ink/index.mjs --paused",
+    "cli:help": "node bin/agentflow.mjs --help"
+  }
+}

package/templates/en/.claude/skills/orchestrator-explore/SKILL.md

@@ -16,7 +16,7 @@ Gather useful context before creating TASKs or OpenSpec artifacts.
 
 ## Critical Rules
 
-- Understand the user's exact scope first.
+- Understand the user's exact scope first — clarify by asking the user directly, **NOT by reading project files yourself**.
 - Prefer exploration before implementation when context is unclear.
 - Use **ONLY OpenCode** as the exploration agent when deep codebase analysis is needed — its role is **EXCLUSIVELY analysis**, **NEVER implementation**.
 - When delegating exploration to OpenCode, include in the brief exactly what it must report: flows, dependencies, architecture findings, inconsistencies, etc.

package/templates/en/ORCHESTRATOR.md

@@ -74,7 +74,7 @@ This directory (`orchestrator-<name>`) exists **only** for work management:
 - `logs/` — agent output
 
 The real project code lives at the paths defined in `orchestrator.config.json → repos`.
-When you need to understand the project in order to plan tasks, **read files from those paths**.
+**Do NOT read real project code files to understand the project.** If codebase analysis is needed to plan tasks, delegate it to OpenCode via a TASK in `QUEUE.md` — that is what OpenCode is for.
 **Never modify real project files directly** — that is exclusively the workers' job.
 
 ## Startup Checklist
@@ -136,14 +136,16 @@ del .away-mode
 
 ## Fallback Policy
 
-The TUI handles fallback automatically following this chain:
+The TUI handles fallback automatically following these chains:
 
+**By failure:**
 ```
-Codex fails → OpenCode → Frontend (frontend repo) or Backend (backend repo)
-```
-Codex fails  →  Frontend (frontend repo) or Backend (backend repo) directly
+OpenCode fails → Codex → Claude-Worker (Frontend/Backend)
+Codex fails    → OpenCode → Claude-Worker (Frontend/Backend)
 ```
 
+**By availability (when assigning new tasks):** Claude-Orchestrator should check `STATUS.md` before writing to `QUEUE.md`. If the primary agent for a task is already busy or rate-limited, assign directly to the next available idle agent in the chain rather than queuing behind a busy one.
+
 As Orchestrator you do **not** need to manually reassign on failure — the TUI does it. Your role is:
 
 1. Check `INBOX.md` or `QUEUE.md` to confirm the fallback ran correctly.

package/templates/es/.claude/skills/orchestrator-explore/SKILL.md

@@ -17,7 +17,7 @@ Guiar la fase de exploración del orquestador para reunir contexto útil antes d
 
 ## Reglas críticas
 
-- Empieza por entender el alcance exacto del pedido del usuario.
+- Empieza por entender el alcance exacto del pedido del usuario — acláralo preguntándole directamente, **NO leyendo archivos del proyecto tú mismo**.
 - Si hace falta lectura amplia, prioriza exploración y análisis antes de planear implementación.
 - Usa **SOLO OpenCode** como agente de exploración cuando necesites análisis profundo del codebase — su rol es **EXCLUSIVAMENTE análisis**, **NUNCA implementación**.
 - Al delegar exploración a OpenCode, incluye en el brief exactamente qué debe reportar: flujos, dependencias, hallazgos de arquitectura, inconsistencias, etc.

package/templates/es/ORCHESTRATOR.md

@@ -38,7 +38,7 @@ Este directorio (`orchestrator-<nombre>`) existe **únicamente** para gestión d
 - `logs/` — salida de los agentes
 
 El código real del proyecto vive en las rutas definidas en `orchestrator.config.json → repos`.
-Cuando necesites entender el proyecto para planificar tareas, **lee archivos desde esas rutas**.
+**NO leas archivos de código del proyecto real para planificar tareas.** Si necesitas análisis del codebase para crear TASKs, delégalo a OpenCode mediante una TASK en `QUEUE.md` — para eso existe OpenCode.
 **Nunca modifiques archivos del proyecto real directamente** — eso es trabajo exclusivo de los agentes workers.
 
 ## Al iniciar la sesión — OBLIGATORIO
@@ -132,14 +132,16 @@ del .away-mode
 
 ### Fallback por cuota o indisponibilidad
 
-La TUI gestiona el fallback automáticamente siguiendo esta cadena:
+La TUI gestiona el fallback automáticamente siguiendo estas cadenas:
 
+**Por fallo:**
 ```
-Codex falla → OpenCode → Frontend (repo FE) o Backend (repo BE)
-```
-Codex falla  →  Frontend (repo FE) o Backend (repo BE) directamente
+OpenCode falla → Codex → Claude-Worker (Frontend/Backend)
+Codex falla    → OpenCode → Claude-Worker (Frontend/Backend)
 ```
 
+**Por disponibilidad (al asignar tareas nuevas):** Claude-Orquestador debe revisar `STATUS.md` antes de escribir en `QUEUE.md`. Si el agente primario para una tarea ya está ocupado o tiene rate limit, asigna directamente al siguiente agente idle en la cadena en lugar de dejar la tarea esperando detrás de uno ocupado.
+
 Como Orquestador, **no necesitas reasignar manualmente** cuando hay un fallo — la TUI lo hace sola. Tu rol en este caso es:
 
 1. Verificar en `INBOX.md` o `QUEUE.md` que el fallback se ejecutó correctamente.
@@ -221,7 +223,7 @@ Revisa `orchestrator.config.json` → `agents`. Cada entrada tiene:
 6. Al terminar la sesión, escribe un `handoffs/HANDOFF-<fecha>.md` resumiendo qué se hizo y qué sigue.
 7. **Por defecto solo usa Claude, Codex y OpenCode**. No uses Gemini, Cursor ni Abacus salvo instrucción explícita del usuario.
 8. Si el usuario activa **Modo Ausencia**, revisa progreso cada 5 minutos y reasigna nuevas TASKs razonables dentro del alcance actual sin esperar confirmación intermedia.
-9. La TUI gestiona el fallback automáticamente: Codex falla → OpenCode → Claude-Worker (Frontend/Backend según repo). Solo intervén manualmente si la tarea queda marcada `failed`.
+9. La TUI gestiona el fallback automáticamente: OpenCode falla → Codex → Claude-Worker; Codex falla → OpenCode → Claude-Worker. Solo intervén manualmente si la tarea queda marcada `failed`.
 10. Usa Engram para guardar decisiones, hallazgos, bugs y resúmenes de sesión; no dependas solo del contexto corto de la conversación.
 11. **VERIFICACIÓN OBLIGATORIA:** Antes de crear TASKs de implementación, confirma una de estas condiciones:
    - Existe un reporte de OpenCode en `INBOX.md` o `progress/PROGRESS-OpenCode.md` que cubre el área, O