agent-enderun 1.11.3 → 1.11.5

package/src/shared/constants.ts

@@ -32,6 +32,7 @@ export const ADAPTER_DIRS = {
     CURSOR: ".cursor",
     CODEX: ".agents",
     ANTIGRAVITY: ".antigravity",
+    LOCAL: ".enderun",
     LEGACY_AGENT: ".agent",
 } as const;
 
@@ -44,6 +45,7 @@ export const FRAMEWORK_DIR_CANDIDATES = [
     ADAPTER_DIRS.GROK,
     ADAPTER_DIRS.CURSOR,
     ADAPTER_DIRS.ANTIGRAVITY,
+    ADAPTER_DIRS.LOCAL,
 ] as const;
 
 /** Slug under `.agents/{slug}/` for each adapter in unified mode. */
@@ -53,6 +55,7 @@ export const UNIFIED_ADAPTER_SLUG = {
     grok: "grok",
     cursor: "cursor",
     codex: "codex",
+    local: "local",
     "antigravity-cli": "antigravity",
 } as const;
 
@@ -66,6 +69,7 @@ export const NATIVE_AGENT_PATHS = {
     grok: pathJoin(ADAPTER_DIRS.GROK, "agents"),
     cursor: pathJoin(ADAPTER_DIRS.CURSOR, "rules"),
     codex: pathJoin(ADAPTER_DIRS.CODEX, "instructions"),
+    local: pathJoin(ADAPTER_DIRS.LOCAL, "agents"),
     "antigravity-cli": pathJoin(ADAPTER_DIRS.ANTIGRAVITY, "agents"),
 } as const;
 
@@ -76,6 +80,7 @@ export const LEGACY_AGENT_LAYOUT_BASES = [
     NATIVE_AGENT_PATHS.cursor,
     NATIVE_AGENT_PATHS.grok,
     NATIVE_AGENT_PATHS.codex,
+    NATIVE_AGENT_PATHS.local,
     NATIVE_AGENT_PATHS["antigravity-cli"],
 ] as const;
 

package/src/shared/fs.ts

@@ -1,10 +1,11 @@
 import fs from "fs";
 import path from "path";
+import { logger } from "./logger.js";
 
 export function ensureDir(dirPath: string, dryRun = false): void {
     if (!fs.existsSync(dirPath)) {
         if (dryRun) {
-            console.warn(`[DRY RUN] Would create directory: ${dirPath}`);
+            logger.info(`[DRY RUN] Would create directory: ${dirPath}`);
         } else {
             fs.mkdirSync(dirPath, { recursive: true });
         }
@@ -17,7 +18,7 @@ export function ensureDir(dirPath: string, dryRun = false): void {
  */
 export function writeTextFile(filePath: string, content: string, dryRun = false): void {
     if (dryRun) {
-        console.warn(`[DRY RUN] Would write file: ${filePath}`);
+        logger.info(`[DRY RUN] Would write file: ${filePath}`);
         return;
     }
     const dir = path.dirname(filePath);
@@ -37,7 +38,7 @@ export function writeTextFile(filePath: string, content: string, dryRun = false)
 
 export function appendFile(filePath: string, content: string, dryRun = false): void {
     if (dryRun) {
-        console.warn(`[DRY RUN] Would append to file: ${filePath}`);
+        logger.info(`[DRY RUN] Would append to file: ${filePath}`);
         return;
     }
     ensureDir(path.dirname(filePath));

package/templates/standards/frontend-standards.md

@@ -2,8 +2,13 @@
 
 This document defines the UI/UX standards for projects managed by Agent Enderun. All interfaces must comply with "Mobile-First", "Fluid Responsive", and "Cross-Device Adaptive" principles.
 
-## 1. Design System: Panda CSS & Tailwind Integration
-- **Zero UI Library:** Heavy external UI libraries like Ant Design or MUI are not used. All styles are written with type-safe **Panda CSS** or structured **Tailwind CSS**.
+## 1. Zero UI Library Policy (Supreme Mandate)
+- **NO Third-Party UI Frameworks:** Usage of `@chakra-ui`, `mui`, `@shadcn`, `antd`, or similar pre-built component libraries is **STRICTLY FORBIDDEN**.
+- **Atomic Manual Construction:** Every UI component (Button, Modal, Input, etc.) must be built manually from scratch using atomic CSS principles.
+- **Styling Engine:** All styles must be written with type-safe **Panda CSS** or structured **Tailwind CSS**.
+- **Reasoning:** Pre-built libraries introduce massive bloat, difficult-to-override styles, and dependency lock-in. Agent Enderun enforces pure, lightweight, and 100% customizable UI code.
+
+## 2. Design System: Panda CSS & Tailwind Integration
 - **Token Usage:** Colors, spacing, and font sizes must be managed via the `token()` function or standard CSS variables.
 - **Responsive Syntax:** Object-based responsive syntax is mandatory:
   ```typescript

package/templates/standards/governance-standards.md

@@ -28,7 +28,33 @@ A single TODO, lint error, or unverified contract blocks the phase transition.
 
 ---
 
-## 3. Trace ID Discipline
+## 3. Hermes Self-Healing Protocol
+- If an agent remains in `EXECUTING` state for >30 minutes, the orchestrator triggers **Self-Healing**.
+- The agent is reset to `READY`, and the task is logged for human review or retry.
+- Blocked agents should not be left abandoned; they must be recovered to keep the loop fluid.
+
+---
+
+## 4. Proportional Governance Model (Autonomy Levels)
+Governance controls are mapped to agent autonomy to ensure safety and EU AI Act compliance.
+
+| Level | Mode | Authority | Governance Focus |
+|---|---|---|---|
+| **L1** | Observe | Read-only access | Scoped data access, usage logging |
+| **L2** | Advise | Recommendations only | Accuracy checks, bias mitigation |
+| **L3** | Guided | Action with human "OK" | Meaningful human review (No rubber-stamping) |
+| **L4** | Autonomous| Independent execution | **Circuit breakers**, real-time monitoring |
+
+---
+
+## 5. Circuit Breaker & Kill Switch Protocol
+- **L4 Emergency Stop:** Every autonomous agent **must** support an immediate "Kill Switch" signal.
+- **Recursive Failure Guard:** If an agent chain (Agent A calling Agent B) fails twice at the same node, the entire Trace ID is **Frozen** until human intervention.
+- **Audit Traceability:** Every autonomous action must be attributable to a unique **Agent ID** and **Trace ID** in an immutable log.
+
+---
+
+## 6. Trace ID Discipline
 
 - Every task chain begins with a unique Trace ID (e.g. `TRC-042`).
 - All agent messages, logs, and commits **must** carry the active Trace ID.

package/templates/standards/quality-standards.md

@@ -7,7 +7,8 @@ This document defines the technical discipline rules that all code produced by t
 - **No Explicit Any:** The use of `any` is strictly forbidden. `unknown` should be used for uncertain types and verified with type guards.
 - **Exhaustive Checks:** All cases must be checked (exhaustive) in `switch-case` structures, or safety must be provided with the `never` type.
 
-## 2. ESLint and Static Analysis
+## 2. ESLint and Static Analysis (AST Enforced)
+- **Real-Time AST Audits:** Every file mutation by an agent is scanned via **Abstract Syntax Tree (AST)** analysis. Prohibited patterns (`any`, `console.log`) are blocked at the protocol level.
 - **Zero Warnings:** No ESLint warnings or errors can exist in the codebase.
 - **Naming Conventions:**
   - Variables and functions: `camelCase`

package/bin/enderun-dashboard.js

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import fs from "node:fs";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const cliPath = join(__dirname, "../dist/src/cli/index.js");
-
-if (!fs.existsSync(cliPath)) {
-    process.stderr.write("\n❌ Error: Compiled CLI not found at 'dist/src/cli/index.js'\n");
-    process.stderr.write("💡 Solution Tip: Run 'npm run build' to compile the project first.\n\n");
-    process.exit(1);
-}
-
-const child = spawn("node", [cliPath, "dashboard", ...process.argv.slice(2)], {
-    stdio: "inherit",
-    shell: false 
-});
-
-child.on("exit", (code) => {
-    process.exit(code ?? 0);
-});

package/framework-mcp/src/tools/dashboard/start_dashboard.ts

@@ -1,33 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { exec } from "child_process";
-import { StartDashboardArgs, ToolResult } from "../types.js";
-
-/**
- * Starts the Enderun Web Dashboard server.
- */
-export function handleStartDashboard(projectRoot: string, args: StartDashboardArgs): ToolResult {
-    const port = args.port || 5858;
-    const dashboardScript = path.join(projectRoot, "bin/enderun-dashboard.js");
-
-    if (!fs.existsSync(dashboardScript)) {
-        throw new Error("Dashboard server script not found in bin/enderun-dashboard.js");
-    }
-
-    try {
-        // Start the dashboard as a background process
-        exec(`node "${dashboardScript}"`, {
-            cwd: projectRoot,
-            env: { ...process.env, PORT: String(port) }
-        });
-
-        return {
-            content: [{
-                type: "text",
-                text: `🖥️ **Enderun Web Dashboard started!**\n\nAccess it at: http://localhost:${port}\n\nThis interface will show real-time agent status, system health, and orchestration logs.`
-            }]
-        };
-    } catch (e) {
-        return { isError: true, content: [{ type: "text", text: `Failed to start dashboard: ${String(e)}` }] };
-    }
-}

package/src/cli/commands/dashboard/data-service.ts

@@ -1,167 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { getFrameworkDir } from "../../utils/memory.js";
-
-export function parseProjectMemory() {
-    const frameworkDir = getFrameworkDir();
-    if (!frameworkDir) return { error: "No framework directory found. Run init." };
-
-    const memPath = path.join(frameworkDir, "memory/PROJECT_MEMORY.md");
-    if (!fs.existsSync(memPath)) return { error: "PROJECT_MEMORY.md not found" };
-
-    try {
-        const content = fs.readFileSync(memPath, "utf8");
-        
-        // Parse Phase & Trace ID
-        const phaseMatch = content.match(/Phase:\s*([^\n\r]+)/i);
-        const traceMatch = content.match(/Trace ID:\s*([^\n\r]+)/i);
-        const managerMatch = content.match(/@manager state:\s*([^\n\r]+)/i);
-
-        // Parse Active Tasks Table
-        const tasks = [];
-        const lines = content.split("\n");
-        let inTaskTable = false;
-        
-        for (const line of lines) {
-            if (line.includes("| Trace ID | Task |")) {
-                inTaskTable = true;
-                continue;
-            }
-            if (inTaskTable && line.trim() === "") {
-                inTaskTable = false;
-                continue;
-            }
-            if (inTaskTable && line.startsWith("|") && !line.includes(":---")) {
-                const cols = line.split("|").map(c => c.trim()).filter(Boolean);
-                if (cols.length >= 5) {
-                    tasks.push({
-                        traceId: cols[0],
-                        task: cols[1],
-                        agent: cols[2],
-                        priority: cols[3],
-                        status: cols[4]
-                    });
-                }
-            }
-        }
-
-        // Parse History Section
-        const history = [];
-        const historyParts = content.split(/##\s+HISTORY/i);
-        if (historyParts[1]) {
-            const histLines = historyParts[1].split("\n");
-            let currentItem: { title: string, body: string[] } | null = null;
-            for (const line of histLines) {
-                if (line.startsWith("###")) {
-                    if (currentItem) history.push(currentItem);
-                    currentItem = { title: line.replace("###", "").trim(), body: [] };
-                } else if (currentItem && line.trim() !== "") {
-                    currentItem.body.push(line.trim());
-                }
-            }
-            if (currentItem) history.push(currentItem);
-        }
-
-        return {
-            phase: phaseMatch ? phaseMatch[1].trim() : "PHASE_0",
-            traceId: traceMatch ? traceMatch[1].trim() : "N/A",
-            managerState: managerMatch ? managerMatch[1].trim() : "ACTIVE",
-            tasks,
-            history: history.slice(0, 15) // Return last 15 entries
-        };
-    } catch (e: unknown) {
-        return { error: e instanceof Error ? e.message : String(e) };
-    }
-}
-
-interface ProjectStructureEntry {
-  name: string;
-  path: string;
-  type: "directory" | "file";
-  children?: ProjectStructureEntry[];
-}
-
-export function getProjectStructure(): ProjectStructureEntry[] {
-    const projectRoot = process.cwd();
-
-    function walk(dir: string, depth = 0): ProjectStructureEntry[] {
-        if (depth > 3) return []; // Limit depth for performance
-
-        const entries: ProjectStructureEntry[] = [];
-        let files: fs.Dirent[];
-
-        try {
-            files = fs.readdirSync(dir, { withFileTypes: true });
-        } catch (_e) {
-            // Silently ignore directories that cannot be read
-            return [];
-        }
-        
-        for (const file of files) {
-            if (file.name.startsWith(".") || file.name === "node_modules" || file.name === "dist") continue;
-            
-            const fullPath = path.join(dir, file.name);
-            const entry: ProjectStructureEntry = {
-                name: file.name,
-                path: path.relative(projectRoot, fullPath),
-                type: file.isDirectory() ? "directory" : "file"
-            };
-
-            if (file.isDirectory()) {
-                entry.children = walk(fullPath, depth + 1);
-            }
-            entries.push(entry);
-        }
-        return entries;
-    }
-
-    try {
-        return walk(projectRoot);
-    } catch {
-        return [];
-    }
-}
-
-export function readManagerLogs() {
-    const frameworkDir = getFrameworkDir();
-    if (!frameworkDir) return [];
-    
-    const logsPath = path.join(frameworkDir, "logs/manager.json");
-    if (!fs.existsSync(logsPath)) return [];
-
-    try {
-        const raw = fs.readFileSync(logsPath, "utf8");
-        // Handle both json array format and jsonl format
-        if (raw.trim().startsWith("[")) {
-            return JSON.parse(raw);
-        } else {
-            return raw.split("\n").filter(Boolean).map(line => JSON.parse(line));
-        }
-    } catch {
-        return [];
-    }
-}
-
-export function listAgents() {
-    const frameworkDir = getFrameworkDir();
-    if (!frameworkDir) return [];
-    const agentsPath = path.join(frameworkDir, "agents");
-    if (!fs.existsSync(agentsPath)) return [];
-
-    try {
-        const files = fs.readdirSync(agentsPath).filter(f => f.endsWith(".json") && f !== "agent_army_schema.json");
-        return files.map(file => {
-            const content = JSON.parse(fs.readFileSync(path.join(agentsPath, file), "utf8"));
-            return {
-                name: content.name,
-                displayName: content.displayName || content.name,
-                description: content.description,
-                role: content.role,
-                capability: content.capability,
-                tags: content.tags || []
-            };
-        });
-    } catch {
-        return [];
-    }
-}