atabey 0.0.11 → 0.0.13

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

@@ -0,0 +1,188 @@
+import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+import { asAgentID, asTraceID } from "../../shared/types.js";
+import { CoreMemory } from "../memory/core.js";
+import { QualityGate } from "./quality-gate.js";
+import { RoutingEngine } from "./routing-engine.js";
+/**
+ * [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 {
+    /**
+     * 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
+        const routingResult = RoutingEngine.resolveWithDetails(taskDescription);
+        const agent = routingResult.agent;
+        const subTasks = routingResult.subTasks;
+        logger.info(`[EXECUTOR] Routing: ${taskDescription.substring(0, 80)}... → ${agent} (confidence: ${routingResult.confidence})`);
+        // 2. Execute with retry logic (max 3 attempts)
+        let lastOutput = "";
+        let lastError = "";
+        for (let attempt = 1; attempt <= 3; attempt++) {
+            try {
+                logger.info(`[EXECUTOR] Attempt ${attempt}/3: ${agent} executing...`);
+                // Execute the agent task via Hermes messaging
+                const output = await AgentExecutor.runAgentTask(agent, taskDescription, subTasks, traceId);
+                lastOutput = output;
+                // 3. Quality check
+                const qualityResult = await QualityGate.check(agent, output, taskDescription);
+                if (qualityResult.passed) {
+                    logger.info(`[EXECUTOR] ${agent} task PASSED quality check (attempt ${attempt})`);
+                    // 4. Save to memory
+                    await AgentExecutor.saveToMemory(agent, taskDescription, output, traceId);
+                    // Update agent status
+                    AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "COMPLETED", taskDescription);
+                    return {
+                        success: true,
+                        agent,
+                        output,
+                        attempts: attempt,
+                    };
+                }
+                lastError = qualityResult.reason;
+                logger.warn(`[EXECUTOR] Quality check FAILED: ${qualityResult.reason}`, { agent, attempt });
+            }
+            catch (err) {
+                lastError = err.message;
+                logger.error(`[EXECUTOR] Agent execution error: ${lastError}`, { agent, attempt });
+            }
+        }
+        // All attempts failed
+        logger.error(`[EXECUTOR] ${agent} FAILED after 3 attempts. Last error: ${lastError}`);
+        AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "BLOCKED", `Failed: ${taskDescription.substring(0, 60)}`);
+        return {
+            success: false,
+            agent,
+            output: lastOutput,
+            attempts: 3,
+        };
+    }
+    /**
+     * Runs the agent via the Hermes messaging system.
+     *
+     * 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
+     *
+     * 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) {
+        const agentName = agent.replace("@", "");
+        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
+        AtabeyStorage.getDB().prepare(`
+            INSERT INTO logs (agent, action, trace_id, status, summary)
+            VALUES (?, ?, ?, ?, ?)
+        `).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;
+    }
+    /**
+     * Polls for agent response from the Hermes message queue.
+     *
+     * Polling strategy:
+     * - Check every 500ms
+     * - Max 30 seconds wait (60 attempts)
+     * - Return response if found, timeout if not
+     */
+    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;
+    }
+    /**
+     * Saves the task result to memory.
+     */
+    static async saveToMemory(agent, taskDescription, output, traceId) {
+        // Save to Vector Memory
+        await CoreMemory.remember({
+            content: `${agent}: ${taskDescription}\nResult: ${output}`,
+            category: "TASK_HISTORY",
+            traceId: asTraceID(traceId),
+            tags: [agent.replace("@", ""), "task-execution"],
+        });
+        // Save to SQLite logs
+        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 = AtabeyStorage.getTasks(asTraceID(traceId));
+        const pendingTask = tasks.find(t => t.status === "IN_PROGRESS");
+        if (pendingTask) {
+            AtabeyStorage.saveTask({
+                ...pendingTask,
+                status: "COMPLETED",
+            });
+        }
+    }
+}
+//# sourceMappingURL=agent-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.js","sourceRoot":"","sources":["../../../../src/modules/engines/agent-executor.ts"],"names":[],"mappings":"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"}

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

@@ -2,6 +2,7 @@ import { EvaluationResult, ProjectHealth } from "./types.js";
 /**
  * [DATA] Evaluation & Health Engine
  * Rates agent performance and tracks overall project stability.
+ * Now uses real metrics from SQLite, compliance scans, and agent states.
  */
 export declare class HealthEngine {
     /**
@@ -9,7 +10,12 @@ export declare class HealthEngine {
      */
     static recordEvaluation(result: EvaluationResult): Promise<void>;
     /**
-     * Aggregates all data to calculate the overall Project Health.
+     * Aggregates real data to calculate the overall Project Health.
+     * Uses actual metrics from:
+     * - Agent success rates from SQLite logs
+     * - Compliance violations from AST scanning
+     * - Agent state distribution (blocked/ready ratio)
+     * - Test results from recent evaluations
      */
     static updateProjectHealth(): Promise<ProjectHealth>;
     static getHealth(): ProjectHealth | null;

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

@@ -1,10 +1,13 @@
 import fs from "fs";
 import path from "path";
+import { scanProjectCompliance } from "../../cli/utils/compliance.js";
 import { getFrameworkDir } from "../../cli/utils/memory.js";
 import { ensureDir, writeJsonFile } from "../../shared/fs.js";
+import { Storage } from "../../shared/storage.js";
 /**
  * [DATA] Evaluation & Health Engine
  * Rates agent performance and tracks overall project stability.
+ * Now uses real metrics from SQLite, compliance scans, and agent states.
  */
 export class HealthEngine {
     /**
@@ -19,19 +22,93 @@ export class HealthEngine {
         await this.updateProjectHealth();
     }
     /**
-     * Aggregates all data to calculate the overall Project Health.
+     * Aggregates real data to calculate the overall Project Health.
+     * Uses actual metrics from:
+     * - Agent success rates from SQLite logs
+     * - Compliance violations from AST scanning
+     * - Agent state distribution (blocked/ready ratio)
+     * - Test results from recent evaluations
      */
     static async updateProjectHealth() {
-        // This would normally read compliance reports, test results, and recent evaluations
-        // Prototyping with semi-static values for now
+        const frameworkDir = getFrameworkDir();
+        const agents = Storage.getAllAgents();
+        const logs = Storage.getLogs();
+        const evaluationsDir = path.join(frameworkDir, "memory", "evaluations");
+        // 1. Agent Health Score (based on success rate & state distribution)
+        let agentScore = 100;
+        const totalLogs = logs.length;
+        if (totalLogs > 0) {
+            const successCount = logs.filter((l) => l.status === "SUCCESS").length;
+            const successRate = (successCount / totalLogs) * 100;
+            agentScore = Math.round(successRate);
+        }
+        // Penalize blocked/timeout agents
+        const blockedAgents = agents.filter((a) => a.state === "BLOCKED" || a.state === "TIMEOUT").length;
+        if (blockedAgents > 0) {
+            agentScore -= blockedAgents * 10;
+        }
+        // 2. Code Quality Score (based on compliance violations)
+        let qualityScore = 100;
+        try {
+            const violations = scanProjectCompliance("src");
+            if (violations.length > 0) {
+                qualityScore -= Math.min(violations.length * 5, 50);
+            }
+        }
+        catch {
+            qualityScore = 70; // Fallback if scan fails
+        }
+        // 3. Security Score (based on evaluation findings)
+        let securityScore = 100;
+        if (fs.existsSync(evaluationsDir)) {
+            const evalFiles = fs.readdirSync(evaluationsDir).filter((f) => f.endsWith(".json"));
+            let securityIssues = 0;
+            let totalEvalMetrics = 0;
+            for (const file of evalFiles.slice(-20)) { // Last 20 evaluations
+                try {
+                    const evalData = JSON.parse(fs.readFileSync(path.join(evaluationsDir, file), "utf8"));
+                    if (evalData.metrics) {
+                        totalEvalMetrics++;
+                        if (!evalData.metrics.compilation)
+                            securityIssues += 2;
+                        if (!evalData.metrics.lint)
+                            securityIssues += 1;
+                        if (!evalData.metrics.tests)
+                            securityIssues += 3;
+                    }
+                }
+                catch {
+                    // Skip corrupted files
+                }
+            }
+            if (totalEvalMetrics > 0) {
+                securityScore -= Math.min((securityIssues / totalEvalMetrics) * 20, 40);
+            }
+        }
+        // 4. Architecture Score (based on metadata stability)
+        const phaseOrder = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+        const currentPhase = Storage.getMetadata("phase") || "PHASE_0";
+        const phaseIndex = phaseOrder.indexOf(currentPhase);
+        const architectureScore = Math.min(60 + phaseIndex * 10, 100);
+        // Calculate weighted final score
+        const score = Math.max(0, Math.min(100, Math.round(agentScore * 0.30 + // Agent performance: 30%
+            qualityScore * 0.25 + // Code quality: 25%
+            securityScore * 0.25 + // Security: 25%
+            architectureScore * 0.20 // Architecture: 20%
+        )));
         const health = {
-            score: 85,
-            codeQuality: 90,
-            security: 80,
-            architecture: 85,
+            score,
+            codeQuality: Math.max(0, qualityScore),
+            security: Math.max(0, securityScore),
+            architecture: architectureScore,
+            agentHealth: Math.max(0, agentScore),
+            totalAgents: agents.length,
+            activeAgents: agents.filter((a) => a.state === "EXECUTING" || a.state === "ACTIVE").length,
+            blockedAgents,
+            totalLogs,
             lastUpdated: new Date().toISOString()
         };
-        const healthFile = path.join(getFrameworkDir(), "memory", "HEALTH.json");
+        const healthFile = path.join(frameworkDir, "memory", "HEALTH.json");
         writeJsonFile(healthFile, health);
         return health;
     }

package/dist/src/modules/engines/health-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"health-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/health-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;GAGG;AACH,MAAM,OAAO,YAAY;IACrB;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAwB;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACtE,SAAS,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC;QAC9E,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,wBAAwB;QACxB,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,mBAAmB;QACnC,oFAAoF;QACpF,8CAA8C;QAC9C,MAAM,MAAM,GAAkB;YAC1B,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACxC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACzE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAElC,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,SAAS;QACnB,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"health-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/health-engine.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { Plan } from "./types.js";
 /**
- * 🗺️ Planning Engine (The Strategist)
+ * [MAP] Planning Engine (The Strategist)
  * Responsible for decomposing complex requests into a DAG of atomic tasks.
  */
 export declare class PlanningEngine {

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

@@ -1,7 +1,8 @@
+import { asPlanID, asTaskID } from "../../shared/types.js";
 import { generateULID } from "../../cli/utils/time.js";
 import { RoutingEngine } from "./routing-engine.js";
 /**
- * 🗺️ Planning Engine (The Strategist)
+ * [MAP] Planning Engine (The Strategist)
  * Responsible for decomposing complex requests into a DAG of atomic tasks.
  */
 export class PlanningEngine {
@@ -11,14 +12,14 @@ export class PlanningEngine {
      * For now, it provides the structural backbone.
      */
     static createPlan(rawTasks) {
-        const planId = generateULID();
+        const planId = asPlanID(generateULID());
         const tasks = rawTasks.map((t, index) => {
             const id = t.id || `TASK_${String(index + 1).padStart(2, "0")}`;
             return {
-                id,
+                id: asTaskID(id),
                 agent: t.agent || RoutingEngine.resolveAgent(t.task),
                 task: t.task,
-                dependencies: t.dependencies || []
+                dependencies: (t.dependencies || []).map(d => asTaskID(d))
             };
         });
         return {

package/dist/src/modules/engines/planning-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"planning-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/planning-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"planning-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/planning-engine.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+export interface QualityResult {
+    passed: boolean;
+    reason: string;
+    findings?: unknown;
+}
+/**
+ * [ENGINE] Quality Gate
+ * Atabey Order v2 — Deterministic Quality Inspection Center.
+ * Inspects agent outputs and codebase against constitutional rules.
+ */
+export declare class QualityGate {
+    /**
+     * 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>;
+    /**
+     * Basic logical validation of agent output
+     */
+    private static validateOutputContent;
+}

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

@@ -0,0 +1,85 @@
+import { execSync } from "child_process";
+import { scanProjectCompliance } from "../../cli/utils/compliance.js";
+import { logger } from "../../shared/logger.js";
+/**
+ * [ENGINE] Quality Gate
+ * Atabey Order v2 — Deterministic Quality Inspection Center.
+ * Inspects agent outputs and codebase against constitutional rules.
+ */
+export class QualityGate {
+    /**
+     * 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}...`);
+        // Skip deep ecosystem commands during framework unit testing to prevent infinite recursion
+        const isTestEnv = process.env.VITEST === "true" || !!process.env.ATABEY_TEST_DIR;
+        if (!isTestEnv) {
+            // 1. Compliance Check (AST Analysis)
+            const complianceIssues = scanProjectCompliance("src");
+            if (complianceIssues.length > 0) {
+                const summary = complianceIssues.map(i => `${i.file}:${i.line} (${i.rule})`).join(", ");
+                return {
+                    passed: false,
+                    reason: `Compliance issues found: ${summary}`,
+                    findings: complianceIssues
+                };
+            }
+            // 2. Lint Check
+            try {
+                logger.debug("[QUALITY_GATE] Running ESLint...");
+                execSync("npm run lint", { stdio: "pipe" });
+            }
+            catch (err) {
+                const error = err;
+                return {
+                    passed: false,
+                    reason: "Lint check failed. Zero errors required.",
+                    findings: error.stderr?.toString() || error.message
+                };
+            }
+            // 3. Test Check (Optional but recommended for Phase 2+)
+            try {
+                logger.debug("[QUALITY_GATE] Running Tests...");
+                execSync("npm test", { stdio: "pipe" });
+            }
+            catch (err) {
+                const error = err;
+                return {
+                    passed: false,
+                    reason: "Automated tests failed. Regressions detected.",
+                    findings: error.stderr?.toString() || error.message
+                };
+            }
+        }
+        else {
+            logger.debug("[QUALITY_GATE] Framework unit test environment detected. Skipping low-level process recursion.");
+        }
+        // 4. Content Validation (Basic output check)
+        const contentCheck = this.validateOutputContent(output, task);
+        if (!contentCheck.passed) {
+            return contentCheck;
+        }
+        logger.info(`[QUALITY_GATE] Audit PASSED for ${agent}`);
+        return { passed: true, reason: "All quality gates passed." };
+    }
+    /**
+     * Basic logical validation of agent output
+     */
+    static validateOutputContent(output, _task) {
+        if (!output || output.trim().length < 10) {
+            return { passed: false, reason: "Output is too short or empty." };
+        }
+        const errorIndicators = ["ERROR", "FAILED", "CRASHED", "TIMEOUT"];
+        for (const indicator of errorIndicators) {
+            if (output.toUpperCase().includes(indicator)) {
+                return { passed: false, reason: `Output contains error indicator: ${indicator}` };
+            }
+        }
+        return { passed: true, reason: "Content validation passed." };
+    }
+}
+//# sourceMappingURL=quality-gate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.js","sourceRoot":"","sources":["../../../../src/modules/engines/quality-gate.ts"],"names":[],"mappings":"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"}

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

@@ -13,12 +13,12 @@ export class RiskEngine {
         { word: "force", weight: 20 },
     ];
     static SENSITIVE_PATHS = [
-        { pattern: /\.env/, weight: 50 },
-        { pattern: /config/, weight: 20 },
-        { pattern: /database\//, weight: 30 },
-        { pattern: /auth\//, weight: 30 },
-        { pattern: /security/, weight: 30 },
-        { pattern: /atabey/, weight: 40 }, // Framework protection
+        { pattern: /\.env/i, weight: 50 },
+        { pattern: /config/i, weight: 20 },
+        { pattern: /database/i, weight: 30 },
+        { pattern: /auth/i, weight: 30 },
+        { pattern: /security/i, weight: 30 },
+        { pattern: /atabey/i, weight: 40 }, // Framework protection
     ];
     /**
      * Assesses the risk of a natural language task or command string.

package/dist/src/modules/engines/risk-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"risk-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/risk-engine.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACX,MAAM,CAAC,kBAAkB,GAAG;QAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;KAChC,CAAC;IAEM,MAAM,CAAC,eAAe,GAAG;QAC7B,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QAChC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QACrC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;QACnC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,uBAAuB;KAC7D,CAAC;IAEF;;OAEG;IACI,MAAM,CAAC,cAAc,CAAC,IAAY;QACrC,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,sBAAsB;QACtB,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACrD,IAAI,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,YAAY,IAAI,EAAE;oBAC1B,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,+BAA+B,IAAI,wBAAwB;iBAC3E,CAAC,CAAC;gBACH,UAAU,IAAI,MAAM,CAAC;YACzB,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,mBAAmB,OAAO,CAAC,MAAM,EAAE;oBAC3C,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,sDAAsD,OAAO,CAAC,MAAM,EAAE;iBACtF,CAAC,CAAC;gBACH,UAAU,IAAI,MAAM,CAAC;YACzB,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,iBAAiB;gBACzB,KAAK;gBACL,WAAW,EAAE,gFAAgF;aAChG,CAAC,CAAC;YACH,UAAU,IAAI,KAAK,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAgB,EAAE,SAAwC;QACrF,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,sBAAsB;QACtB,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACvD,UAAU,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,cAAc,SAAS,EAAE;YACjC,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC;YAC3B,WAAW,EAAE,MAAM,SAAS,8DAA8D;SAC7F,CAAC,CAAC;QAEH,oBAAoB;QACpB,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC;oBACT,MAAM,EAAE,mBAAmB,QAAQ,EAAE;oBACrC,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,0CAA0C;iBAC1D,CAAC,CAAC;gBACH,UAAU,IAAI,MAAM,CAAC;YACzB,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,UAAkB,EAAE,OAAqB;QACvE,IAAI,QAAQ,GAAiB,KAAK,CAAC;QACnC,IAAI,UAAU,IAAI,EAAE;YAAE,QAAQ,GAAG,UAAU,CAAC;aACvC,IAAI,UAAU,IAAI,EAAE;YAAE,QAAQ,GAAG,MAAM,CAAC;aACxC,IAAI,UAAU,IAAI,EAAE;YAAE,QAAQ,GAAG,QAAQ,CAAC;QAE/C,OAAO;YACH,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC;YACrC,QAAQ;YACR,OAAO;YACP,gBAAgB,EAAE,UAAU,IAAI,EAAE;SACrC,CAAC;IACN,CAAC"}
+{"version":3,"file":"risk-engine.js","sourceRoot":"","sources":["../../../../src/modules/engines/risk-engine.ts"],"names":[],"mappings":"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"}

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

@@ -1,11 +1,69 @@
 export interface RoutingCandidate {
     agent: string;
     specialties: Record<string, number>;
+    displayName: string;
+    role: string;
+    capability: number;
+    tier: string;
+}
+export interface RoutingResult {
+    agent: string;
+    score: number;
+    confidence: "high" | "medium" | "low";
+    reasoning: string;
+    subTasks: string[];
 }
 export declare class RoutingEngine {
     /**
-     * Finds the best agent for a given task description based on capability scores and specialties.
+     * Advanced Routing Engine — analyzes task descriptions,
+     * selects the most suitable agent, and determines subtasks.
+     *
+     * Uses TF-IDF-like keyword weighting.
      */
     static resolveAgent(taskDescription: string): string;
+    /**
+     * Returns detailed routing result — score, confidence, reasoning, subTasks
+     */
+    static resolveWithDetails(taskDescription: string): RoutingResult;
+    /**
+     * Automatically splits the task into subtasks
+     */
+    static planTask(taskDescription: string): string[];
+    private static tokenize;
+    /**
+     * Simple term frequency calculation
+     */
+    private static calculateTf;
+    private static fallbackRouting;
+    private static generateSubTasks;
+    /**
+     * 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;
+    }>;
+    /**
+     * Runs the agent through the Hermes messaging system.
+     *
+     * 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;
+    /**
+     * Runs quality control through the real QualityGate.
+     *
+     * Flow:
+     * 1. QualityGate.check() for compliance + lint + test + content validation
+     * 2. Aggregate results
+     */
+    private static runQualityCheck;
     private static getCandidates;
+    /**
+     * Default values for agents without a specialties field
+     */
+    private static defaultSpecialties;
 }