agent-enderun 1.1.9 → 1.10.0

package/src/cli/commands/dashboard/server.ts

@@ -0,0 +1,43 @@
+import http from "http";
+import { parseProjectMemory, readManagerLogs, listAgents } from "./data-service.js";
+import { HTML_CONTENT } from "./html-template.js";
+
+export function startDashboardServer(port: number = 5858) {
+    const server = http.createServer((req, res) => {
+        // API: Status
+        if (req.url === "/api/status") {
+            const mem = parseProjectMemory();
+            const logs = readManagerLogs();
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ ...mem, logs }));
+            return;
+        }
+
+        // API: Agents list
+        if (req.url === "/api/agents") {
+            const list = listAgents();
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify(list));
+            return;
+        }
+
+        // Static HTML Serve
+        if (req.url === "/" || req.url === "/index.html") {
+            res.writeHead(200, { "Content-Type": "text/html; charset=UTF-8" });
+            res.end(HTML_CONTENT);
+            return;
+        }
+
+        // Fallback 404
+        res.writeHead(404, { "Content-Type": "text/plain" });
+        res.end("Not Found");
+    });
+
+    server.listen(port, () => {
+        process.stdout.write("================================================================================\n");
+        process.stdout.write(`🖥️  AGENT ENDERUN LIVE MONITOR SERVED AT: http://localhost:${port}\n`);
+        process.stdout.write("================================================================================\n");
+    });
+
+    return server;
+}

package/src/cli/commands/dashboard.ts

@@ -0,0 +1,11 @@
+import { startDashboardServer } from "./dashboard/server.js";
+
+/**
+ * Launch the Agent Enderun Visual Monitor.
+ */
+export async function dashboardCommand(args: string[]) {
+    const portArg = args.find(a => a.startsWith("--port="));
+    const port = portArg ? parseInt(portArg.split("=")[1]) : 5858;
+    
+    startDashboardServer(port);
+}

package/src/cli/commands/explorer.ts

@@ -5,7 +5,7 @@ import { collectFiles } from "../utils/fs.js";
 
 const targetDir = process.cwd();
 
-export function explorerGraphCommand(targetPath: string) {
+export async function explorerGraphCommand(targetPath: string) {
     console.warn(`🗺️  Generating Dependency Graph for: ${targetPath}...`);
     const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
     const edges: string[] = [];
@@ -27,7 +27,7 @@ export function explorerGraphCommand(targetPath: string) {
     }
 }
 
-export function explorerAuditCommand(targetPath: string) {
+export async function explorerAuditCommand(targetPath: string) {
     console.warn(`🧠 Codebase Intelligence Scan: ${targetPath}...`);
     const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
     const complexity: string[] = [];

package/src/cli/commands/git.ts

@@ -2,7 +2,7 @@ import cp from "child_process";
 import path from "path";
 import { getConfiguredPaths } from "../utils/memory.js";
 
-export function gitCommitCommand(traceId: string) {
+export async function gitCommitCommand(traceId: string) {
     try {
         const diff = cp.execSync("git diff --staged", { encoding: "utf8" });
         if (!diff) {
@@ -28,7 +28,7 @@ export function gitCommitCommand(traceId: string) {
     }
 }
 
-export function gitSyncCommand() {
+export async function gitSyncCommand() {
     console.warn("🔄 Syncing with remote repository...");
     try {
         cp.execSync("git pull origin main --rebase", { stdio: "inherit" });

package/src/cli/commands/init/scaffold-core.ts

@@ -0,0 +1,71 @@
+import fs from "fs";
+import path from "path";
+import { 
+    remapFrameworkContent, 
+    type AdapterConfig, 
+    type AdapterId 
+} from "../../adapters/index.js";
+import { SHIM_TEMPLATES } from "../../shims.js";
+import { writeJsonFile, writeTextFile } from "../../utils/fs.js";
+import { getPackageRoot, getPackageVersion } from "../../utils/pkg.js";
+import { ALL_AGENTS } from "../../../modules/agents/definitions.js";
+
+const FRAMEWORK_NAME = "Agent Enderun";
+
+const COLOR_PALETTES = {
+    "Modern Blue": { primary: "#0ea5e9", secondary: "#64748b", accent: "#f43f5e" },
+    "Enterprise Slate": { primary: "#334155", secondary: "#94a3b8", accent: "#10b981" },
+    "Deep Purple": { primary: "#8b5cf6", secondary: "#d8b4fe", accent: "#f59e0b" }
+};
+
+export function scaffoldConstitution(targetDir: string, frameworkDir: string, adapterId: AdapterId, dryRun: boolean) {
+    if (dryRun) return;
+    let content = `# 🎖️ ${FRAMEWORK_NAME} — Constitution (v${getPackageVersion()})\n\nDiscipline and Order.`;
+    let readSuccess = false;
+    try {
+        const templatePath = path.join(getPackageRoot(), "ENDERUN.md");
+        if (fs.existsSync(templatePath)) {
+            content = fs.readFileSync(templatePath, "utf8");
+            readSuccess = true;
+        }
+    } catch (e) {
+        console.warn(`⚠️  Failed to read global constitution template: ${e}`);
+    }
+    content = remapFrameworkContent(content, frameworkDir, adapterId);
+    const destPath = path.join(targetDir, frameworkDir, "ENDERUN.md");
+    writeTextFile(destPath, content);
+
+    console.warn(`✅ Constitution file created inside: ${frameworkDir}/ENDERUN.md${readSuccess ? "" : " (default template)"}`);
+}
+
+export function scaffoldFrameworkConfigs(targetDir: string, fDir: string, adapter: AdapterConfig, dryRun: boolean, selectedPalette: string) {
+    if (dryRun) return;
+    const frameworkDir = path.join(targetDir, fDir);
+    const palette = COLOR_PALETTES[selectedPalette as keyof typeof COLOR_PALETTES] || COLOR_PALETTES["Modern Blue"];
+
+    const config = {
+        name: FRAMEWORK_NAME,
+        version: getPackageVersion(),
+        theme: {
+            palette: selectedPalette,
+            colors: palette
+        }
+    };
+    writeJsonFile(path.join(frameworkDir, "config.json"), config, dryRun);
+    let statusContent = "# 🎖️ Status\n\n| Agent | State | Active Task | Last Updated | Notes | Extra | Backup |\n|---|---|---|---|---|---|---|\n";
+    for (const ag of ALL_AGENTS) {
+        statusContent += "| @" + ag.name + " | READY | Idle | - | - | - | - |\n";
+    }
+    writeTextFile(path.join(frameworkDir, "STATUS.md"), statusContent);
+}
+
+export function scaffoldShims(projectRoot: string, coreDir: string, adapterId: AdapterId, adapter: AdapterConfig, dryRun: boolean) {
+    for (const [name, content] of Object.entries(SHIM_TEMPLATES)) {
+        if (name.toLowerCase() === adapterId.split("-")[0] || name === adapterId) {
+            const shimContent = remapFrameworkContent(content, coreDir, adapterId);
+            const shimFileName = adapter.shimFile || `${name.toUpperCase()}.md`;
+            if (!dryRun) writeTextFile(path.join(projectRoot, shimFileName), shimContent);
+            console.warn(`✅ Platform shim created: ${shimFileName}`);
+        }
+    }
+}

package/src/cli/commands/init/scaffold-ops.ts

@@ -0,0 +1,86 @@
+import fs from "fs";
+import path from "path";
+import { writeJsonFile, writeTextFile } from "../../utils/fs.js";
+import { getPackageRoot } from "../../utils/pkg.js";
+import { logger } from "../../../shared/logger.js";
+
+export function scaffoldOps(frameworkDir: string, dryRun: boolean) {
+    if (dryRun) return;
+
+    // Scaffold Prompt Recipes
+    const promptsPath = path.join(frameworkDir, "prompts");
+    if (!fs.existsSync(promptsPath)) fs.mkdirSync(promptsPath, { recursive: true });
+
+    const recipes = [
+        { file: "refactoring-recipe.md", template: "templates/prompts/refactoring-recipe.md" },
+        { file: "bug-fix-recipe.md", template: "templates/prompts/bug-fix-recipe.md" },
+        { file: "new-feature-recipe.md", template: "templates/prompts/new-feature-recipe.md" },
+        { file: "security-audit-recipe.md", template: "templates/prompts/security-audit-recipe.md" },
+        { file: "db-management-recipe.md", template: "templates/prompts/db-management-recipe.md" },
+        { file: "performance-optimization-recipe.md", template: "templates/prompts/performance-optimization-recipe.md" },
+        { file: "deployment-recipe.md", template: "templates/prompts/deployment-recipe.md" },
+        { file: "contract-design-recipe.md", template: "templates/prompts/contract-design-recipe.md" }
+    ];
+
+    for (const recipe of recipes) {
+        try {
+            const fullTemplatePath = path.join(getPackageRoot(), recipe.template);
+            if (fs.existsSync(fullTemplatePath)) {
+                const content = fs.readFileSync(fullTemplatePath, "utf8");
+                writeTextFile(path.join(promptsPath, recipe.file), content);
+            }
+        } catch (e) {
+            logger.debug(`Failed to scaffold prompt recipe: ${recipe.file}`, e);
+        }
+    }
+
+    // Scaffold cli-commands.json
+    const cliCommands = {
+        commands: {
+            init: { agent: "manager", description: "Initialize Agent Enderun structure and AI configuration." },
+            check: { agent: "quality", description: "Verify framework files and code quality discipline." },
+            status: { agent: "manager", description: "Show the current status of the active project phase." },
+            "trace:new": { agent: "manager", description: "Generate a new Trace ID to start a task sequence." },
+            orchestrate: { agent: "manager", description: "Execute the Hermes message broker loop." },
+            "verify-contract": { agent: "architect", description: "Validate type contracts between backend and frontend." },
+            "update-contract": { agent: "architect", description: "Update the contract signature hash." }
+        }
+    };
+    writeJsonFile(path.join(frameworkDir, "cli-commands.json"), cliCommands, dryRun);
+
+    // Scaffold BRAIN_DASHBOARD.md
+    writeTextFile(path.join(frameworkDir, "BRAIN_DASHBOARD.md"), "# 🧠 Brain Dashboard\n\nActive Trace: T-000\nActive Phase: PHASE_0 (Genesis)\n\n## Agent Statuses\n- @manager: READY\n- @architect: READY\n- @backend: READY\n- @frontend: READY\n- @quality: READY\n");
+
+    // Scaffold router/routing_rules.md
+    const routerDir = path.join(frameworkDir, "router");
+    if (!fs.existsSync(routerDir)) fs.mkdirSync(routerDir, { recursive: true });
+    writeTextFile(path.join(routerDir, "routing_rules.md"), "# 📡 Agent Enderun — Natural Language & Event Router\n\nRouting engine protocols defined here.");
+
+    // Scaffold registry/agent_registry.md
+    const registryDir = path.join(frameworkDir, "registry");
+    if (!fs.existsSync(registryDir)) fs.mkdirSync(registryDir, { recursive: true });
+    writeTextFile(path.join(registryDir, "agent_registry.md"), "# 🎖️ Agent Enderun — Army Registry\n\nList of active agents.");
+
+    // Scaffold observability files
+    const obsDir = path.join(frameworkDir, "observability");
+    if (!fs.existsSync(obsDir)) fs.mkdirSync(obsDir, { recursive: true });
+    writeTextFile(path.join(obsDir, "audit_log.md"), "# 🎖️ Agent Enderun — Audit Log\n\n| Timestamp | Agent | Action | Trace ID | Status |\n|---|---|---|---|---|\n");
+    writeJsonFile(path.join(obsDir, "metrics.json"), []);
+
+    // Scaffold .env.example
+    const envExamplePath = path.join(process.cwd(), ".env.example");
+    if (!fs.existsSync(envExamplePath)) {
+        writeTextFile(envExamplePath, "# Agent Enderun - Environment Variables\n\n# Core Settings\nPORT=5858\nNODE_ENV=development\n\n# AI Platform Keys (Fill these in your local .env)\nGEMINI_API_KEY=\nCLAUDE_API_KEY=\nGROK_API_KEY=\n");
+    }
+
+    // Scaffold rules
+    const rulesDir = path.join(frameworkDir, "rules");
+    if (!fs.existsSync(rulesDir)) fs.mkdirSync(rulesDir, { recursive: true });
+    writeTextFile(path.join(rulesDir, "global_rules.mdc"), `---
+description: Global Rules for Agent Enderun Army
+globs: **/*
+---
+
+# 🎖️ Agent Enderun — Global Army Rules
+`);
+}

package/src/cli/commands/init/scaffold-standards.ts

@@ -0,0 +1,59 @@
+import fs from "fs";
+import path from "path";
+import { ensureDir, writeTextFile } from "../../utils/fs.js";
+import { getPackageRoot } from "../../utils/pkg.js";
+import { CORE_SKILLS } from "../../../modules/skills/definitions.js";
+
+const FRAMEWORK_NAME = "Agent Enderun";
+
+export function scaffoldSkills(skillsBaseDir: string, dryRun: boolean) {
+    if (dryRun) return;
+    ensureDir(skillsBaseDir, dryRun);
+    for (const [key, skill] of Object.entries(CORE_SKILLS)) {
+        const mdContent = `# 🛠️ ${FRAMEWORK_NAME} Skill — ${skill.name}\n\n${skill.description}\n\n## 🔌 Associated Tools\n${skill.tools.map(t => `- \`${t}\``).join("\n")}\n\n## 🛡️ Core Mandates\n${skill.mandates.join("\n")}\n`;
+        writeTextFile(path.join(skillsBaseDir, `${key.toLowerCase()}.md`), mdContent);
+    }
+}
+
+export function scaffoldStandards(frameworkDir: string, dryRun: boolean) {
+    if (dryRun) return;
+    const knowledgePath = path.join(frameworkDir, "knowledge");
+    if (!fs.existsSync(knowledgePath)) fs.mkdirSync(knowledgePath, { recursive: true });
+
+    const eslintStandardsContent = `# 🎖️ Agent Enderun — ESLint Standards
+
+This document outlines the strict ESLint coding standards for Agent Enderun projects.
+
+## 📏 Core Rules
+- **Indentation:** 4 spaces (strict).
+- **Quotes:** Double quotes (\`"\`) for strings.
+- **Semicolons:** Always terminate statements with a semicolon (\`;\`).
+- **No Explicit Any:** Avoid using \`any\`. Use strongly typed interfaces, generics, or \`unknown\` with type assertions.
+- **Unused Variables:** Warning on unused variables unless prefixed with an underscore (\`_\`).
+`;
+    writeTextFile(path.join(knowledgePath, "eslint-standards.md"), eslintStandardsContent);
+
+    const standards = [
+        { file: "crud-governance.md", template: "templates/standards/crud-governance.md", default: "# 🏛️ Corporate CRUD and Governance Standards" },
+        { file: "architecture-standards.md", template: "templates/standards/architecture-standards.md", default: "# 📐 Corporate Architecture Standards" },
+        { file: "frontend-standards.md", template: "templates/standards/frontend-standards.md", default: "# 🎨 Corporate Frontend Standards" },
+        { file: "tailwind-standards.md", template: "templates/standards/tailwind-standards.md", default: "# 🌊 Corporate Tailwind Standards" },
+        { file: "mobile-standards.md", template: "templates/standards/mobile-standards.md", default: "# 📱 Corporate Mobile Standards" },
+        { file: "security-standards.md", template: "templates/standards/security-standards.md", default: "# 🛡️ Corporate Security Standards" },
+        { file: "quality-standards.md", template: "templates/standards/quality-standards.md", default: "# ⚖️ Corporate Code Quality Standards" },
+        { file: "logging-and-secrets.md", template: "templates/standards/logging-and-secrets.md", default: "# 🪵 Corporate Logging Standards" },
+        { file: "testing-standards.md", template: "templates/standards/testing-standards.md", default: "# 🧪 Corporate Testing Standards" },
+        { file: "i18n-standards.md", template: "templates/standards/i18n-standards.md", default: "# 🌐 Corporate i18n Standards" }
+    ];
+
+    for (const std of standards) {
+        let content = std.default;
+        try {
+            const fullTemplatePath = path.join(getPackageRoot(), std.template);
+            if (fs.existsSync(fullTemplatePath)) {
+                content = fs.readFileSync(fullTemplatePath, "utf8");
+            }
+        } catch { /* fallback to default */ }
+        writeTextFile(path.join(knowledgePath, std.file), content);
+    }
+}