atabey 0.0.12 → 0.0.13

package/dist/src/modules/engines/agent-executor.js

@@ -1,21 +1,26 @@
 import { logger } from "../../shared/logger.js";
-import { Storage } from "../../shared/storage.js";
-import { asTraceID } from "../../shared/types.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+import { asAgentID, asTraceID } from "../../shared/types.js";
 import { CoreMemory } from "../memory/core.js";
-import { RoutingEngine } from "./routing-engine.js";
 import { QualityGate } from "./quality-gate.js";
+import { RoutingEngine } from "./routing-engine.js";
 /**
- * [ENGINE] Agent Executor
- * Gerçek ajan çağrılarını yönetir. Görevleri agent'lara dağıtır,
- * sonuçları toplar, quality gate'den geçirir ve memory'ye kaydeder.
+ * [ENGINE] Agent Executor — Production Implementation
+ *
+ * Manages real agent calls through the Hermes messaging system.
+ * Distributes tasks to agents, collects results, passes through quality gate,
+ * and saves to memory.
+ *
+ * Uses real Hermes message queue (not simulated).
  */
 export class AgentExecutor {
     /**
-     * Bir görevi ilgili ajana dağıtır ve çalıştırır.
-     * 1. Routing Engine ile uygun ajanı seç
-     * 2. Ajanı çalıştır (task-specific output üret)
-     * 3. Quality check'ten geçir
-     * 4. Sonucu memory'ye kaydet
+     * Distributes a task to the relevant agent and executes it.
+     * 1. Select the best agent via Routing Engine
+     * 2. Send Hermes message
+     * 3. Wait for agent response (polling)
+     * 4. Pass through quality check
+     * 5. Save result to memory
      */
     static async execute(taskDescription, traceId) {
         // 1. Route the task to the best agent
@@ -29,7 +34,7 @@ export class AgentExecutor {
         for (let attempt = 1; attempt <= 3; attempt++) {
             try {
                 logger.info(`[EXECUTOR] Attempt ${attempt}/3: ${agent} executing...`);
-                // Execute the agent task
+                // Execute the agent task via Hermes messaging
                 const output = await AgentExecutor.runAgentTask(agent, taskDescription, subTasks, traceId);
                 lastOutput = output;
                 // 3. Quality check
@@ -39,7 +44,7 @@ export class AgentExecutor {
                     // 4. Save to memory
                     await AgentExecutor.saveToMemory(agent, taskDescription, output, traceId);
                     // Update agent status
-                    Storage.updateAgentStatus(agent.replace("@", ""), "COMPLETED", taskDescription);
+                    AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "COMPLETED", taskDescription);
                     return {
                         success: true,
                         agent,
@@ -57,7 +62,7 @@ export class AgentExecutor {
         }
         // All attempts failed
         logger.error(`[EXECUTOR] ${agent} FAILED after 3 attempts. Last error: ${lastError}`);
-        Storage.updateAgentStatus(agent.replace("@", ""), "BLOCKED", `Failed: ${taskDescription.substring(0, 60)}`);
+        AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "BLOCKED", `Failed: ${taskDescription.substring(0, 60)}`);
         return {
             success: false,
             agent,
@@ -66,72 +71,95 @@ export class AgentExecutor {
         };
     }
     /**
-     * Ajanı çalıştırır ve task-specific output üretir.
-     *
-     * Her ajan tipi için farklı bir "görev tamamlama" mantığı:
-     * - @backend: API endpoint'i oluşturur
-     * - @frontend: UI component'i oluşturur
-     * - @database: Migration script'i oluşturur
-     * - @security: Security audit raporu oluşturur
-     * - Diğer: Genel task çıktısı
+     * Runs the agent via the Hermes messaging system.
      *
-     * IMPLEMENTATION PLAN (v0.1.0):
-     * 1. Agent'e Hermes mesajı gönder: sendMessage({ from: "@manager", to: agent, ... })
-     * 2. Agent'in yanıtını bekle (polling veya event-driven)
-     * 3. Yanıtı işle ve çıktı olarak döndür
+     * Flow:
+     * 1. Write DELEGATION message to agent's message queue
+     * 2. Wait for agent response (polling, max 30 seconds)
+     * 3. Parse response and return as output
      *
-     * BLOCKER: Henüz gerçek agent'lar MCP üzerinden çalışmıyor.
-     * Mevcut durum: generateAgentOutput() simülasyon string döndürüyor.
-     * Priority: HIGH — v0.1.0 için implemente edilmeli.
+     * NOTE: In real MCP environment, agents read and process their own
+     * message queues. Here the queue is managed via SQLite.
      */
-    static async runAgentTask(agent, taskDescription, subTasks, _traceId) {
+    static async runAgentTask(agent, taskDescription, subTasks, traceId) {
         const agentName = agent.replace("@", "");
-        // TODO(v0.1.0): Replace with real Hermes agent delegation
-        // const { sendMessage } = await import("../../cli/commands/orchestrate.js");
-        // await sendMessage({
-        //     from: "@manager",
-        //     to: agent,
-        //     category: "DELEGATION",
-        //     content: taskDescription,
-        //     traceId: _traceId,
-        // });
-        // Update status
-        Storage.updateAgentStatus(agentName, "EXECUTING", taskDescription);
+        const from = "@manager";
+        // ─── 1. Send Hermes Message ──────────────────────────────────────
+        const messagePayload = JSON.stringify({
+            type: "DELEGATION",
+            task: taskDescription,
+            subTasks,
+            traceId,
+            from,
+        });
+        AtabeyStorage.saveMessage({
+            from: asAgentID(from),
+            to: asAgentID(agent),
+            category: "DELEGATION",
+            content: messagePayload,
+            traceId: asTraceID(traceId),
+            timestamp: new Date().toISOString(),
+            status: "PENDING",
+            priority: "HIGH",
+            requiresApproval: false,
+        });
+        // Update agent status
+        AtabeyStorage.updateAgentStatus(agentName, "EXECUTING", taskDescription);
         // Log action
-        Storage.getDB().prepare(`
+        AtabeyStorage.getDB().prepare(`
             INSERT INTO logs (agent, action, trace_id, status, summary)
             VALUES (?, ?, ?, ?, ?)
-        `).run(agentName, "EXECUTING", _traceId, "IN_PROGRESS", taskDescription.substring(0, 200));
-        // Agent-specific task execution (SIMULATED — replace with real agent call in v0.1.0)
-        const output = AgentExecutor.generateAgentOutput(agent, taskDescription, subTasks);
+        `).run(agentName, "DELEGATION_SENT", traceId, "IN_PROGRESS", taskDescription.substring(0, 200));
+        logger.info(`[HERMES] Delegation sent to ${agent} (trace: ${traceId})`);
+        // ─── 2. Wait for Agent Response (Polling) ────────────────────────
+        const output = await AgentExecutor.pollForAgentResponse(agentName, traceId);
         return output;
     }
     /**
-     * Agent tipine göre mantıklı bir çıktı üretir.
+     * Polls for agent response from the Hermes message queue.
      *
-     * NOTE: This is a SIMULATED implementation.
-     * Replace with real agent output from Hermes message responses in v0.1.0.
+     * Polling strategy:
+     * - Check every 500ms
+     * - Max 30 seconds wait (60 attempts)
+     * - Return response if found, timeout if not
      */
-    static generateAgentOutput(agent, task, subTasks) {
-        const taskShort = task.length > 100 ? task.substring(0, 100) + "..." : task;
-        const outputs = {
-            "@manager": `[MANAGER] Orchestration completed for: ${taskShort}\nSubtasks planned: ${subTasks.length}`,
-            "@backend": `[BACKEND] Service implementation completed for: ${taskShort}\nEndpoints and business logic implemented according to API contracts.`,
-            "@frontend": `[FRONTEND] UI component built for: ${taskShort}\nResponsive design applied with atomic component structure.`,
-            "@quality": `[QUALITY] Audit completed for: ${taskShort}\nCompliance, lint, and test coverage verified.`,
-            "@database": `[DATABASE] Migration and optimization completed for: ${taskShort}\nSchema updated and queries optimized.`,
-            "@security": `[SECURITY] Security audit completed for: ${taskShort}\nVulnerability scan and access control verified.`,
-            "@devops": `[DEVOPS] Infrastructure configuration completed for: ${taskShort}\nCI/CD pipeline and deployment config prepared.`,
-            "@architect": `[ARCHITECT] Architecture design completed for: ${taskShort}\nContracts and system design documented.`,
-            "@analyst": `[ANALYST] Analysis completed for: ${taskShort}\nRequirements mapped and validated against contracts.`,
-            "@mobile": `[MOBILE] Mobile implementation completed for: ${taskShort}\nReact Native components with offline-first support.`,
-            "@explorer": `[EXPLORER] Codebase exploration completed for: ${taskShort}\nDependency graph and project map generated.`,
-            "@git": `[GIT] Version control operations completed for: ${taskShort}\nCommit prepared with Trace ID.`,
-        };
-        return outputs[agent] || `[${agent.toUpperCase()}] Task completed: ${taskShort}`;
+    static async pollForAgentResponse(agentName, traceId) {
+        const maxAttempts = 60; // 30 seconds (500ms * 60)
+        const pollInterval = 500; // 500ms
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            // Check RESPONSE messages sent by the agent
+            const messages = AtabeyStorage.getPendingMessages();
+            const response = messages.find(m => m.from.replace("@", "") === agentName
+                && m.category === "RESPONSE"
+                && m.traceId === traceId
+                && m.status === "PENDING");
+            if (response) {
+                // Mark message as processed
+                if (response.id !== undefined) {
+                    AtabeyStorage.updateMessageStatus(response.id, "PROCESSED");
+                }
+                // Log response
+                AtabeyStorage.getDB().prepare(`
+                    INSERT INTO logs (agent, action, trace_id, status, summary)
+                    VALUES (?, ?, ?, ?, ?)
+                `).run(agentName, "RESPONSE_RECEIVED", traceId, "SUCCESS", response.content.substring(0, 200));
+                logger.info(`[HERMES] Response received from @${agentName} (trace: ${traceId})`);
+                return response.content;
+            }
+            // Short delay before next poll
+            await new Promise(resolve => setTimeout(resolve, pollInterval));
+        }
+        // Timeout — agent did not respond
+        const timeoutMsg = `[TIMEOUT] @${agentName} did not respond within ${(maxAttempts * pollInterval) / 1000}s`;
+        logger.warn(`[HERMES] ${timeoutMsg} (trace: ${traceId})`);
+        AtabeyStorage.getDB().prepare(`
+            INSERT INTO logs (agent, action, trace_id, status, summary)
+            VALUES (?, ?, ?, ?, ?)
+        `).run(agentName, "RESPONSE_TIMEOUT", traceId, "FAILED", timeoutMsg);
+        return timeoutMsg;
     }
     /**
-     * Task sonucunu memory'ye kaydeder.
+     * Saves the task result to memory.
      */
     static async saveToMemory(agent, taskDescription, output, traceId) {
         // Save to Vector Memory
@@ -142,15 +170,15 @@ export class AgentExecutor {
             tags: [agent.replace("@", ""), "task-execution"],
         });
         // Save to SQLite logs
-        Storage.getDB().prepare(`
+        AtabeyStorage.getDB().prepare(`
             INSERT INTO logs (agent, action, trace_id, status, summary)
             VALUES (?, ?, ?, ?, ?)
         `).run(agent.replace("@", ""), "COMPLETED", traceId, "SUCCESS", output.substring(0, 200));
         // Update task status
-        const tasks = Storage.getTasks(asTraceID(traceId));
+        const tasks = AtabeyStorage.getTasks(asTraceID(traceId));
         const pendingTask = tasks.find(t => t.status === "IN_PROGRESS");
         if (pendingTask) {
-            Storage.saveTask({
+            AtabeyStorage.saveTask({
                 ...pendingTask,
                 status: "COMPLETED",
             });

package/dist/src/modules/engines/agent-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor.js","sourceRoot":"","sources":["../../../../src/modules/engines/agent-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-executor.js","sourceRoot":"","sources":["../../../../src/modules/engines/agent-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAiB,MAAM,qBAAqB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IACtB;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,eAAuB,EAAE,OAAe;QAMhE,sCAAsC;QACtC,MAAM,aAAa,GAAkB,aAAa,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;QAClC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;QAExC,MAAM,CAAC,IAAI,CAAC,uBAAuB,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,iBAAiB,aAAa,CAAC,UAAU,GAAG,CAAC,CAAC;QAE/H,+CAA+C;QAC/C,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,OAAO,KAAK,eAAe,CAAC,CAAC;gBAEtE,8CAA8C;gBAC9C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC3F,UAAU,GAAG,MAAM,CAAC;gBAEpB,mBAAmB;gBACnB,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;gBAE9E,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;oBACvB,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,uCAAuC,OAAO,GAAG,CAAC,CAAC;oBAElF,oBAAoB;oBACpB,MAAM,aAAa,CAAC,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAE1E,sBAAsB;oBACtB,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;oBAEtF,OAAO;wBACH,OAAO,EAAE,IAAI;wBACb,KAAK;wBACL,MAAM;wBACN,QAAQ,EAAE,OAAO;qBACpB,CAAC;gBACN,CAAC;gBAED,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,oCAAoC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAChG,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,SAAS,GAAI,GAAa,CAAC,OAAO,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,qCAAqC,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACvF,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,yCAAyC,SAAS,EAAE,CAAC,CAAC;QAEtF,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAElH,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,CAAC;SACd,CAAC;IACN,CAAC;IAED;;;;;;;;;;OAUG;IACK,MAAM,CAAC,KAAK,CAAC,YAAY,CAC7B,KAAa,EACb,eAAuB,EACvB,QAAkB,EAClB,OAAe;QAEf,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC;QAExB,oEAAoE;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;YAClC,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,eAAe;YACrB,QAAQ;YACR,OAAO;YACP,IAAI;SACP,CAAC,CAAC;QAEH,aAAa,CAAC,WAAW,CAAC;YACtB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;YACrB,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC;YACpB,QAAQ,EAAE,YAAqB;YAC/B,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,SAAkB;YAC1B,QAAQ,EAAE,MAAe;YACzB,gBAAgB,EAAE,KAAK;SAC1B,CAAC,CAAC;QAEH,sBAAsB;QACtB,aAAa,CAAC,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QAEzE,aAAa;QACb,aAAa,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;SAG7B,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAEhG,MAAM,CAAC,IAAI,CAAC,+BAA+B,KAAK,YAAY,OAAO,GAAG,CAAC,CAAC;QAExE,oEAAoE;QACpE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5E,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAAiB,EAAE,OAAe;QACxE,MAAM,WAAW,GAAG,EAAE,CAAC,CAAC,0BAA0B;QAClD,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,QAAQ;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACrD,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,SAAS;mBAClC,CAAC,CAAC,QAAQ,KAAK,UAAU;mBACzB,CAAC,CAAC,OAAO,KAAK,OAAO;mBACrB,CAAC,CAAC,MAAM,KAAK,SAAS,CACjC,CAAC;YAEF,IAAI,QAAQ,EAAE,CAAC;gBACX,4BAA4B;gBAC5B,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;oBAC5B,aAAa,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAY,EAAE,WAAW,CAAC,CAAC;gBAC1E,CAAC;gBAED,eAAe;gBACf,aAAa,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;iBAG7B,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAE/F,MAAM,CAAC,IAAI,CAAC,oCAAoC,SAAS,YAAY,OAAO,GAAG,CAAC,CAAC;gBACjF,OAAO,QAAQ,CAAC,OAAO,CAAC;YAC5B,CAAC;YAED,+BAA+B;YAC/B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,kCAAkC;QAClC,MAAM,UAAU,GAAG,cAAc,SAAS,2BAA2B,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,CAAC;QAC5G,MAAM,CAAC,IAAI,CAAC,YAAY,UAAU,YAAY,OAAO,GAAG,CAAC,CAAC;QAE1D,aAAa,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;SAG7B,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAErE,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,YAAY,CAC7B,KAAa,EACb,eAAuB,EACvB,MAAc,EACd,OAAe;QAEf,wBAAwB;QACxB,MAAM,UAAU,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,GAAG,KAAK,KAAK,eAAe,aAAa,MAAM,EAAE;YAC1D,QAAQ,EAAE,cAAc;YACxB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,gBAAgB,CAAC;SACnD,CAAC,CAAC;QAEH,sBAAsB;QACtB,aAAa,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;;;SAG7B,CAAC,CAAC,GAAG,CACF,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EACtB,WAAW,EACX,OAAO,EACP,SAAS,EACT,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAC3B,CAAC;QAEF,qBAAqB;QACrB,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;QAChE,IAAI,WAAW,EAAE,CAAC;YACd,aAAa,CAAC,QAAQ,CAAC;gBACnB,GAAG,WAAW;gBACd,MAAM,EAAE,WAAW;aACtB,CAAC,CAAC;QACP,CAAC;IACL,CAAC;CACJ"}

package/dist/src/modules/engines/quality-gate.d.ts

@@ -5,19 +5,19 @@ export interface QualityResult {
 }
 /**
  * [ENGINE] Quality Gate
- * Atabey Order v2 — Deterministik Kalite Denetim Merkezi.
- * Ajan çıktılarını ve kod tabanını anayasal kurallara göre denetler.
+ * Atabey Order v2 — Deterministic Quality Inspection Center.
+ * Inspects agent outputs and codebase against constitutional rules.
  */
 export declare class QualityGate {
     /**
-     * Bir ajanın çalışmasını kalite testinden geçirir.
-     * 1. Compliance (Anayasal uyumluluk)
-     * 2. Lint (Kod standartları)
-     * 3. Tests (Birim ve entegrasyon testleri)
+     * Puts an agent's work through quality testing.
+     * 1. Compliance (Constitutional compliance)
+     * 2. Lint (Code standards)
+     * 3. Tests (Unit and integration tests)
      */
     static check(agent: string, output: string, task: string): Promise<QualityResult>;
     /**
-     * Ajan çıktısının temel mantıksal kontrolü
+     * Basic logical validation of agent output
      */
     private static validateOutputContent;
 }

package/dist/src/modules/engines/quality-gate.js

@@ -3,15 +3,15 @@ import { scanProjectCompliance } from "../../cli/utils/compliance.js";
 import { logger } from "../../shared/logger.js";
 /**
  * [ENGINE] Quality Gate
- * Atabey Order v2 — Deterministik Kalite Denetim Merkezi.
- * Ajan çıktılarını ve kod tabanını anayasal kurallara göre denetler.
+ * Atabey Order v2 — Deterministic Quality Inspection Center.
+ * Inspects agent outputs and codebase against constitutional rules.
  */
 export class QualityGate {
     /**
-     * Bir ajanın çalışmasını kalite testinden geçirir.
-     * 1. Compliance (Anayasal uyumluluk)
-     * 2. Lint (Kod standartları)
-     * 3. Tests (Birim ve entegrasyon testleri)
+     * Puts an agent's work through quality testing.
+     * 1. Compliance (Constitutional compliance)
+     * 2. Lint (Code standards)
+     * 3. Tests (Unit and integration tests)
      */
     static async check(agent, output, task) {
         logger.info(`[QUALITY_GATE] Starting audit for ${agent}...`);
@@ -67,7 +67,7 @@ export class QualityGate {
         return { passed: true, reason: "All quality gates passed." };
     }
     /**
-     * Ajan çıktısının temel mantıksal kontrolü
+     * Basic logical validation of agent output
      */
     static validateOutputContent(output, _task) {
         if (!output || output.trim().length < 10) {

package/dist/src/modules/engines/routing-engine.d.ts

@@ -15,64 +15,55 @@ export interface RoutingResult {
 }
 export declare class RoutingEngine {
     /**
-     * Gelişmiş Routing Engine — görev tanımını analiz eder,
-     * en uygun ajanı seçer ve alt görevleri belirler.
+     * Advanced Routing Engine — analyzes task descriptions,
+     * selects the most suitable agent, and determines subtasks.
      *
-     * TF-IDF benzeri kelime ağırlıklandırma ile çalışır.
+     * Uses TF-IDF-like keyword weighting.
      */
     static resolveAgent(taskDescription: string): string;
     /**
-     * Detaylı routing sonucu döndürür — score, confidence, reasoning, subTasks
+     * Returns detailed routing result — score, confidence, reasoning, subTasks
      */
     static resolveWithDetails(taskDescription: string): RoutingResult;
     /**
-     * Görevi otomatik alt görevlere böler
+     * Automatically splits the task into subtasks
      */
     static planTask(taskDescription: string): string[];
     private static tokenize;
     /**
-     * Basit term frequency hesaplama
+     * Simple term frequency calculation
      */
     private static calculateTf;
     private static fallbackRouting;
     private static generateSubTasks;
     /**
-     * Kalite geri besleme loop'u — @quality reddederse tekrar dener
-     * Gerçek MCP çağrıları kullanılır, simülasyon değil.
+     * Quality feedback loop — retries if @quality rejects
+     * Uses real MCP calls, not simulations.
      */
     static qualityLoop(agent: string, taskDescription: string, maxRetries?: number): Promise<{
         success: boolean;
         attempts: number;
     }>;
     /**
-     * Ajanı MCP üzerinden çalıştırır.
+     * Runs the agent through the Hermes messaging system.
      *
-     * IMPLEMENTATION PLAN (v0.1.0):
-     * 1. Send message via Hermes: sendMessage({ from: "@manager", to: agent, category: "DELEGATION", content: task, traceId })
-     * 2. Poll for response in .atabey/messages/ via Storage.getPendingMessages()
-     * 3. Parse and return the agent's output
-     *
-     * BLOCKER: AgentExecutor.execute() uses simulated output (generateAgentOutput).
-     * This method is only called from qualityLoop which is NOT yet used by orchestrate.ts.
-     * Priority: MEDIUM — implement after AgentExecutor is production-ready.
+     * Flow:
+     * 1. Write DELEGATION message to agent's queue (Storage.saveMessage)
+     * 2. Wait for agent response (polling, max 30 seconds)
+     * 3. Parse response and return as output
      */
     private static runAgent;
     /**
-     * Kalite kontrolünü MCP üzerinden çalıştırır.
-     *
-     * IMPLEMENTATION PLAN (v0.1.0):
-     * 1. Call scanProjectCompliance() from compliance.ts
-     * 2. Call lintCommand() from lint.ts
-     * 3. Run vitest via runTests()
-     * 4. Aggregate results into { passed, reason }
+     * Runs quality control through the real QualityGate.
      *
-     * BLOCKER: scanProjectCompliance is in framework-mcp which has circular dependency risk.
-     * Priority: MEDIUM — implement after compliance module is consolidated.
+     * Flow:
+     * 1. QualityGate.check() for compliance + lint + test + content validation
+     * 2. Aggregate results
      */
     private static runQualityCheck;
     private static getCandidates;
     /**
-     * Specialties alanı olmayan agent'lar için varsayılan değerler
+     * Default values for agents without a specialties field
      */
     private static defaultSpecialties;
 }

package/dist/src/modules/engines/routing-engine.js

@@ -2,19 +2,21 @@ import fs from "fs";
 import path from "path";
 import { getFrameworkDir } from "../../cli/utils/memory.js";
 import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+import { asAgentID, asTraceID } from "../../shared/types.js";
 import { ALL_AGENTS } from "../agents/definitions.js";
 export class RoutingEngine {
     /**
-     * Gelişmiş Routing Engine — görev tanımını analiz eder,
-     * en uygun ajanı seçer ve alt görevleri belirler.
+     * Advanced Routing Engine — analyzes task descriptions,
+     * selects the most suitable agent, and determines subtasks.
      *
-     * TF-IDF benzeri kelime ağırlıklandırma ile çalışır.
+     * Uses TF-IDF-like keyword weighting.
      */
     static resolveAgent(taskDescription) {
         return this.resolveWithDetails(taskDescription).agent;
     }
     /**
-     * Detaylı routing sonucu döndürür — score, confidence, reasoning, subTasks
+     * Returns detailed routing result — score, confidence, reasoning, subTasks
      */
     static resolveWithDetails(taskDescription) {
         const textLower = taskDescription.toLowerCase();
@@ -59,7 +61,7 @@ export class RoutingEngine {
                 bestScore = score;
                 bestAgent = candidate.agent;
                 bestReasoning = matches.length > 0
-                    ? `Eşleşen alanlar: ${[...new Set(matches)].join(", ")}`
+                    ? `Matching fields: ${[...new Set(matches)].join(", ")}`
                     : "Selected based on general capability";
                 bestSubTasks = this.generateSubTasks(candidate.agent, taskDescription);
             }
@@ -83,7 +85,7 @@ export class RoutingEngine {
         };
     }
     /**
-     * Görevi otomatik alt görevlere böler
+     * Automatically splits the task into subtasks
      */
     static planTask(taskDescription) {
         const result = this.resolveWithDetails(taskDescription);
@@ -110,11 +112,11 @@ export class RoutingEngine {
             .filter(t => t.length > 1);
     }
     /**
-     * Basit term frequency hesaplama
+     * Simple term frequency calculation
      */
     static calculateTf(term, tokens) {
         const count = tokens.filter(t => t === term).length;
-        return 1 + (count * 0.5); // Base 1, her tekrar +0.5
+        return 1 + (count * 0.5); // Base 1, each repetition +0.5
     }
     static fallbackRouting(tokens) {
         const text = tokens.join(" ");
@@ -237,8 +239,8 @@ export class RoutingEngine {
         return [...specific, ...base];
     }
     /**
-     * Kalite geri besleme loop'u — @quality reddederse tekrar dener
-     * Gerçek MCP çağrıları kullanılır, simülasyon değil.
+     * Quality feedback loop — retries if @quality rejects
+     * Uses real MCP calls, not simulations.
      */
     static async qualityLoop(agent, taskDescription, maxRetries = 3) {
         for (let attempt = 1; attempt <= maxRetries; attempt++) {
@@ -271,46 +273,70 @@ export class RoutingEngine {
         return { success: false, attempts: maxRetries };
     }
     /**
-     * Ajanı MCP üzerinden çalıştırır.
+     * Runs the agent through the Hermes messaging system.
      *
-     * IMPLEMENTATION PLAN (v0.1.0):
-     * 1. Send message via Hermes: sendMessage({ from: "@manager", to: agent, category: "DELEGATION", content: task, traceId })
-     * 2. Poll for response in .atabey/messages/ via Storage.getPendingMessages()
-     * 3. Parse and return the agent's output
-     *
-     * BLOCKER: AgentExecutor.execute() uses simulated output (generateAgentOutput).
-     * This method is only called from qualityLoop which is NOT yet used by orchestrate.ts.
-     * Priority: MEDIUM — implement after AgentExecutor is production-ready.
+     * Flow:
+     * 1. Write DELEGATION message to agent's queue (Storage.saveMessage)
+     * 2. Wait for agent response (polling, max 30 seconds)
+     * 3. Parse response and return as output
      */
     static async runAgent(agent, task) {
-        // TODO(v0.1.0): Replace with real MCP/Hermes call chain
-        // const { sendMessage } = await import("../../cli/commands/orchestrate.js");
-        // await sendMessage({ from: "@manager", to: agent, category: "DELEGATION", content: task, traceId: "T-000" });
-        // const response = await pollForAgentResponse(agent, task);
-        // return response;
-        logger.debug(`[MCP] runAgent: ${agent} executing task (SIMULATED)`, { agent, task: task.substring(0, 100) });
-        return `${agent} completed task: ${task}`;
+        const agentName = agent.replace("@", "");
+        const traceId = `T-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+        const messagePayload = JSON.stringify({
+            type: "DELEGATION",
+            task,
+            traceId,
+            from: "@manager",
+        });
+        AtabeyStorage.saveMessage({
+            from: asAgentID("@manager"),
+            to: asAgentID(agent),
+            category: "DELEGATION",
+            content: messagePayload,
+            traceId: asTraceID(traceId),
+            timestamp: new Date().toISOString(),
+            status: "PENDING",
+            priority: "HIGH",
+            requiresApproval: false,
+        });
+        logger.info(`[HERMES] Delegation sent to ${agent} (trace: ${traceId})`);
+        // Poll for response (max 30 seconds)
+        const maxAttempts = 60;
+        const pollInterval = 500;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const messages = AtabeyStorage.getPendingMessages();
+            const response = messages.find(m => m.from.replace("@", "") === agentName
+                && m.category === "RESPONSE"
+                && m.traceId === traceId
+                && m.status === "PENDING");
+            if (response) {
+                if (response.id !== undefined) {
+                    AtabeyStorage.updateMessageStatus(response.id, "PROCESSED");
+                }
+                logger.info(`[HERMES] Response received from ${agent} (trace: ${traceId})`);
+                return response.content;
+            }
+            await new Promise(resolve => setTimeout(resolve, pollInterval));
+        }
+        const timeoutMsg = `[TIMEOUT] ${agent} did not respond within 30s`;
+        logger.warn(`[HERMES] ${timeoutMsg} (trace: ${traceId})`);
+        return timeoutMsg;
     }
     /**
-     * Kalite kontrolünü MCP üzerinden çalıştırır.
-     *
-     * IMPLEMENTATION PLAN (v0.1.0):
-     * 1. Call scanProjectCompliance() from compliance.ts
-     * 2. Call lintCommand() from lint.ts
-     * 3. Run vitest via runTests()
-     * 4. Aggregate results into { passed, reason }
+     * Runs quality control through the real QualityGate.
      *
-     * BLOCKER: scanProjectCompliance is in framework-mcp which has circular dependency risk.
-     * Priority: MEDIUM — implement after compliance module is consolidated.
+     * Flow:
+     * 1. QualityGate.check() for compliance + lint + test + content validation
+     * 2. Aggregate results
      */
     static async runQualityCheck(result) {
-        // TODO(v0.1.0): Replace with real compliance + lint + test pipeline
-        // const { scanProjectCompliance } = await import("../../cli/utils/compliance.js");
-        // const issues = scanProjectCompliance("src");
-        // const passed = issues.length === 0;
-        // return { passed, reason: passed ? "All checks passed" : `${issues.length} compliance issues found` };
-        logger.debug("[MCP] runQualityCheck: evaluating result (SIMULATED)", { resultLength: result.length });
-        return { passed: true, reason: "All checks passed (simulated)" };
+        const { QualityGate } = await import("./quality-gate.js");
+        const qualityResult = await QualityGate.check("@quality", result, "Quality check via routing engine");
+        return {
+            passed: qualityResult.passed,
+            reason: qualityResult.reason,
+        };
     }
     static getCandidates() {
         const frameworkDir = getFrameworkDir();
@@ -342,7 +368,7 @@ export class RoutingEngine {
         if (candidates.length === 0) {
             candidates = ALL_AGENTS.map(ag => ({
                 agent: ag.name.startsWith("@") ? ag.name : `@${ag.name}`,
-                specialties: ag.specialties || this.defaultSpecialties(ag.name),
+                specialties: ag.specialties ?? this.defaultSpecialties(ag.name),
                 displayName: ag.displayName,
                 role: ag.role,
                 capability: ag.capability,
@@ -352,7 +378,7 @@ export class RoutingEngine {
         return candidates;
     }
     /**
-     * Specialties alanı olmayan agent'lar için varsayılan değerler
+     * Default values for agents without a specialties field
      */
     static defaultSpecialties(name) {
         const defaults = {