agent-enderun 1.10.1 → 1.10.4

package/src/shared/constants.ts

@@ -0,0 +1,212 @@
+/**
+ * Agent Enderun — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+
+// ─── Framework identity ───────────────────────────────────────────────────────
+
+export const FRAMEWORK = {
+    NAME: "Agent Enderun",
+    CORE_DIR: ".enderun",
+    UNIFIED_HUB_DIR: ".agents",
+    CONSTITUTION_FILE: "ENDERUN.md",
+    DEFAULT_TRACE_ID: "T-000",
+    DEFAULT_PHASE: "PHASE_0",
+    DEFAULT_MANAGER_STATE: "ACTIVE",
+} as const;
+
+export const PROJECT_PHASES = [
+    "PHASE_0",
+    "PHASE_1",
+    "PHASE_2",
+    "PHASE_3",
+    "PHASE_4",
+] as const;
+
+// ─── Adapter platform directories (native / legacy) ───────────────────────────
+
+export const ADAPTER_DIRS = {
+    GEMINI: ".gemini",
+    CLAUDE: ".claude",
+    GROK: ".grok",
+    CURSOR: ".cursor",
+    CODEX: ".agents",
+    ANTIGRAVITY: ".antigravity",
+    LEGACY_AGENT: ".agent",
+} as const;
+
+/** Priority order for framework directory resolution (CLI + MCP). */
+export const FRAMEWORK_DIR_CANDIDATES = [
+    FRAMEWORK.CORE_DIR,
+    ADAPTER_DIRS.CODEX,
+    ADAPTER_DIRS.CLAUDE,
+    ADAPTER_DIRS.GEMINI,
+    ADAPTER_DIRS.GROK,
+    ADAPTER_DIRS.CURSOR,
+    ADAPTER_DIRS.ANTIGRAVITY,
+] as const;
+
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export const UNIFIED_ADAPTER_SLUG = {
+    gemini: "gemini",
+    claude: "claude",
+    grok: "grok",
+    cursor: "cursor",
+    codex: "codex",
+    "antigravity-cli": "antigravity",
+} as const;
+
+export type UnifiedAdapterSlug = keyof typeof UNIFIED_ADAPTER_SLUG;
+
+// ─── Native agent instruction paths (legacy tool compatibility) ───────────────
+
+export const NATIVE_AGENT_PATHS = {
+    gemini: pathJoin(ADAPTER_DIRS.GEMINI, "agents"),
+    claude: pathJoin(ADAPTER_DIRS.CLAUDE, "agents"),
+    grok: pathJoin(ADAPTER_DIRS.GROK, "agents"),
+    cursor: pathJoin(ADAPTER_DIRS.CURSOR, "rules"),
+    codex: pathJoin(ADAPTER_DIRS.CODEX, "instructions"),
+    "antigravity-cli": pathJoin(ADAPTER_DIRS.ANTIGRAVITY, "agents"),
+} as const;
+
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export const LEGACY_AGENT_LAYOUT_BASES = [
+    NATIVE_AGENT_PATHS.gemini,
+    NATIVE_AGENT_PATHS.claude,
+    NATIVE_AGENT_PATHS.cursor,
+    NATIVE_AGENT_PATHS.grok,
+    NATIVE_AGENT_PATHS.codex,
+    NATIVE_AGENT_PATHS["antigravity-cli"],
+] as const;
+
+// ─── Framework internal subdirectories (under `.enderun/`) ──────────────────
+
+export const FRAMEWORK_SUBDIRS = {
+    AGENTS: "agents",
+    SKILLS: "skills",
+    KNOWLEDGE: "knowledge",
+    PROMPTS: "prompts",
+    MEMORY: "memory",
+    ROUTER: "router",
+    REGISTRY: "registry",
+    OBSERVABILITY: "observability",
+    RULES: "rules",
+    MESSAGES: "messages",
+    LOGS: "logs",
+    MEMORY_GRAPH: "memory-graph",
+} as const;
+
+export const CORE_SCAFFOLD_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.KNOWLEDGE,
+    FRAMEWORK_SUBDIRS.PROMPTS,
+    FRAMEWORK_SUBDIRS.MEMORY,
+    FRAMEWORK_SUBDIRS.ROUTER,
+    FRAMEWORK_SUBDIRS.REGISTRY,
+    FRAMEWORK_SUBDIRS.OBSERVABILITY,
+    FRAMEWORK_SUBDIRS.RULES,
+] as const;
+
+export const RUNTIME_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.MESSAGES,
+    FRAMEWORK_SUBDIRS.LOGS,
+    FRAMEWORK_SUBDIRS.MEMORY_GRAPH,
+] as const;
+
+export const MEMORY_SUBDIRS = {
+    TASKS: "tasks",
+    HISTORY: "history",
+} as const;
+
+export const MEMORY_FILES = {
+    STATE: "state.json",
+    STATUS: "status.json",
+    PROJECT_MEMORY: "PROJECT_MEMORY.md",
+    SHARED_FACTS: "shared-facts.json",
+} as const;
+
+// ─── Monorepo default paths ───────────────────────────────────────────────────
+
+export const DEFAULT_MONOREPO_PATHS = {
+    backend: "apps/backend",
+    frontend: "apps/web",
+    mobile: "apps/mobile",
+    docs: "docs",
+    tests: "tests",
+} as const;
+
+/** Cursor rule globs per agent role (monorepo layout). */
+export const CURSOR_AGENT_GLOBS: Record<string, string> = {
+    backend: `${DEFAULT_MONOREPO_PATHS.backend}/**/*`,
+    frontend: `${DEFAULT_MONOREPO_PATHS.frontend}/**/*`,
+    database: `${DEFAULT_MONOREPO_PATHS.backend}/src/database/**/*`,
+    mobile: `${DEFAULT_MONOREPO_PATHS.mobile}/**/*`,
+    native: "apps/native/**/*",
+    quality: "*",
+    security: "*",
+    devops: "*",
+    explorer: "*",
+    git: "*",
+    analyst: "*",
+    manager: "*",
+};
+
+// ─── MCP & environment ──────────────────────────────────────────────────────
+
+export const MCP = {
+    SERVER_NAME: "agent-enderun",
+    ROOT_CONFIG_FILE: "mcp.json",
+    PROJECT_ROOT_ENV: "ENDERUN_PROJECT_ROOT",
+    TEST_DIR_ENV: "ENDERUN_TEST_DIR",
+} as const;
+
+export const ROOT_CONFIG_FILES = {
+    MCP: MCP.ROOT_CONFIG_FILE,
+    DOT_MCP: ".mcp.json",
+    ENV_EXAMPLE: ".env.example",
+    VSCODE_MCP: ".vscode/mcp.json",
+} as const;
+
+// ─── Shim template placeholders ───────────────────────────────────────────────
+
+export const TEMPLATE_PLACEHOLDERS = {
+    FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}",
+    ADAPTER: "{{ADAPTER}}",
+    BACKEND_DIR: "{{BACKEND_DIR}}",
+    FRONTEND_DIR: "{{FRONTEND_DIR}}",
+    DOCS_DIR: "{{DOCS_DIR}}",
+    TESTS_DIR: "{{TESTS_DIR}}",
+} as const;
+
+// ─── File extensions ─────────────────────────────────────────────────────────
+
+export const AGENT_FILE_EXT = {
+    MARKDOWN: ".md",
+    CURSOR_RULE: ".mdc",
+} as const;
+
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+
+export function pathJoin(...segments: string[]): string {
+    return segments.filter(Boolean).join("/");
+}
+
+export function corePath(...segments: string[]): string {
+    return pathJoin(FRAMEWORK.CORE_DIR, ...segments);
+}
+
+export function unifiedHubPath(...segments: string[]): string {
+    return pathJoin(FRAMEWORK.UNIFIED_HUB_DIR, ...segments);
+}
+
+export function unifiedAdapterPath(slug: string, ...segments: string[]): string {
+    return unifiedHubPath(slug, ...segments);
+}
+
+export function knowledgePath(filename: string): string {
+    return corePath(FRAMEWORK_SUBDIRS.KNOWLEDGE, filename);
+}
+
+/** Backward-compatible aliases */
+export const CORE_FRAMEWORK_DIR = FRAMEWORK.CORE_DIR;
+export const UNIFIED_HUB_DIR = FRAMEWORK.UNIFIED_HUB_DIR;
+export const SKILLS_HUB_PATH = pathJoin(UNIFIED_HUB_DIR, FRAMEWORK_SUBDIRS.SKILLS);

package/bin/validate-agent-army.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-
-/**
- * AL-compatible agent folder names across all adapters (after init).
- */
-const AGENT_FOLDER_NAMES = ["agents", "skills", "plugins"];
-const FRAMEWORK_CANDIDATES = [
-    ".enderun",
-    ".cursor",
-    ".claude",
-    ".github",
-    ".grok",
-    ".windsurf",
-    ".antigravity",
-    ".agent",
-    ".gemini/antigravity-cli",
-    ".gemini",
-    ".agents",
-    "antigravity-cli"
-];
-
-function detectFrameworkDir() {
-    const projectRoot = process.cwd();
-    for (const dir of FRAMEWORK_CANDIDATES) {
-        const dirPath = path.resolve(projectRoot, dir);
-        if (!fs.existsSync(dirPath)) continue;
-
-        for (const folderName of AGENT_FOLDER_NAMES) {
-            const agentsPath = path.join(dirPath, folderName);
-            if (fs.existsSync(agentsPath)) {
-                return { frameworkDir: dir, agentsDir: agentsPath };
-            }
-        }
-    }
-    return null;
-}
-
-/**
- * Helper to parse YAML-like Frontmatter from Markdown.
- */
-function parseFrontmatter(content) {
-    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-    const fm = {};
-    if (match) {
-        match[1].split("\n").forEach(line => {
-            const [key, ...val] = line.split(":");
-            if (key && val.length) {
-                let value = val.join(":").trim();
-                if (value.startsWith("[") && value.endsWith("]")) {
-                    value = value.slice(1, -1).split(",").map(s => s.trim().replace(/"/g, ""));
-                } else if (value.startsWith("\"") && value.endsWith("\"")) {
-                    value = value.slice(1, -1);
-                }
-                fm[key.trim()] = value;
-            }
-        });
-    }
-
-    // Also parse from HTML comments in the body as fallback to bypass strict frontmatter checks
-    const commentMatches = content.matchAll(/<!--\s*(\w+)\s*:\s*(.*?)\s*-->/g);
-    for (const m of commentMatches) {
-        let value = m[2].trim();
-        if (value.startsWith("[") && value.endsWith("]")) {
-            value = value.slice(1, -1).split(",").map(s => s.trim().replace(/"/g, "").replace(/'/g, ""));
-        } else if (value.startsWith("\"") && value.endsWith("\"")) {
-            value = value.slice(1, -1);
-        }
-        fm[m[1]] = value;
-    }
-
-    return Object.keys(fm).length > 0 ? fm : null;
-}
-
-
-const detected = detectFrameworkDir();
-if (!detected) {
-    process.stderr.write("ℹ️  No framework agents/ dir found for AL validation. Skipping.");
-    process.exit(0);
-}
-
-const { agentsDir } = detected;
-
-try {
-    const files = [];
-    const walk = (dir) => {
-        if (!fs.existsSync(dir)) return;
-        const list = fs.readdirSync(dir);
-        for (const item of list) {
-            const fullPath = path.join(dir, item);
-            if (fs.statSync(fullPath).isDirectory()) {
-                walk(fullPath);
-            } else if (item.endsWith(".json") || item.endsWith(".md")) {
-                files.push({ name: item, path: fullPath });
-            }
-        }
-    };
-    walk(agentsDir);
-
-    let totalFailed = 0;
-
-    process.stderr.write(`🛡️  STARTING AGENT ARMY AL VALIDATION (${detected.frameworkDir})...`);
-    process.stderr.write("--------------------------------------------------");
-    process.stderr.write("| Agent ID  | Format | Status    | Category       |");
-    process.stderr.write("--------------------------------------------------");
-
-    for (const file of files) {
-        const fileName = file.name;
-        const filePath = file.path;
-        if (fileName === "agent_army_schema.json" || fileName === "schema") continue;
-        
-        const content = fs.readFileSync(filePath, "utf8");
-        const isMd = fileName.endsWith(".md");
-
-        let agent;
-        try {
-            agent = isMd ? parseFrontmatter(content) : JSON.parse(content);
-            if (!agent && isMd) throw new Error("Missing Frontmatter");
-        } catch (e) {
-            process.stderr.write(`| ${fileName.padEnd(9)} | ${isMd ? "MD  " : "JSON"} | ❌ INVALID | ${String(e.message).slice(0, 14)} |`);
-            totalFailed++;
-            continue;
-        }
-
-        // Validate AL compliance fields
-        const missing = [];
-        if (!agent.name) missing.push("name");
-        if (agent.capability === undefined) missing.push("capability");
-        if (!agent.tags) missing.push("tags");
-
-        if (missing.length > 0) {
-            process.stderr.write(`| ${fileName.padEnd(9)} | ${isMd ? "MD  " : "JSON"} | ❌ FAILED  | ${missing.join(",").slice(0, 14)} |`);
-            totalFailed++;
-        } else {
-            const cat = Array.isArray(agent.tags) ? agent.tags[0] : "core";
-            process.stderr.write(`| ${agent.name.padEnd(9)} | ${isMd ? "MD  " : "JSON"} | ✅ PASSED  | ${cat.padEnd(14)} |`);
-        }
-    }
-
-    process.stderr.write("--------------------------------------------------");
-    if (totalFailed > 0) {
-        process.stderr.write(`❌ Validation failed! Detected ${totalFailed} invalid agent configurations.\n`);
-        process.exit(1);
-    } else {
-        process.stderr.write("🎉 SUCCESS: All core agents are AL-Compliant!");
-    }
-} catch (e) {
-    process.stderr.write(`❌ Critical error during validation: ${e}\n`);
-    process.exit(1);
-}