agent-enderun 0.8.8 → 0.9.1

package/framework-mcp/package.json

@@ -1,46 +1,19 @@
 {
-  "name": "ai-enderun-mcp",
-  "version": "0.8.8",
-  "description": "Enterprise-grade MCP Server for AI Agent Framework",
-  "author": "Yusuf BEKAR",
-  "license": "MIT",
-  "readme": "README.md",
+  "name": "@agent-enderun/mcp",
+  "version": "0.9.0",
+  "description": "Agent Enderun Model Context Protocol (MCP) Server",
   "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ysf-bkr/Agent-Enderun.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ysf-bkr/Agent-Enderun/issues"
-  },
-  "homepage": "https://github.com/ysf-bkr/Agent-Enderun#readme",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.js",
-  "bin": {
-    "framework-mcp": "dist/index.js"
-  },
-  "files": [
-    "src",
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "npx tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "ts-morph": "^28.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^3.24.2"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
-    "tsx": "^4.19.4",
+    "@types/node": "^22.19.19",
     "typescript": "^5.9.3"
   }
 }

package/framework-mcp/tsconfig.json

@@ -4,13 +4,10 @@
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
     "outDir": "./dist",
+    "rootDir": "./src",
     "strict": true,
-    "esModuleInterop": true,
     "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "allowJs": true,
-    "types": ["node"]
+    "esModuleInterop": true
   },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+  "include": ["src/**/*.ts"]
 }

package/gemini.md

@@ -1,19 +1,25 @@
 # Agent Enderun — Gemini CLI Adapter
 
-This file is the entry point when using Agent Enderun with Gemini CLI.
+This is the primary entry point when using Agent Enderun within the Gemini CLI ecosystem.
 
-The framework installs into the `.enderun/` folder for Gemini users.
+The framework operates under a unified governance structure located in the `.enderun/` directory.
 
 ### Primary Constitution
 All governance rules, agent checklists, and project memory live here:
 
 👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
 
-### 🤖 Agent Directive (Gemini CLI users)
+### 🤖 Agent Directive
 You are operating under the Agent Enderun governance framework.
 
 At the **start of every session**, before any work:
-1. Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. Read the relevant agent definition under `.enderun/agents/{agent}.md` (especially `@manager`).
+1. **Restore Memory:** Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
+2. **Load Identity:** Read the relevant agent definition under `.enderun/agents/{agent}.md` (default to `@manager`).
+3. **Internalize Knowledge:** Reference the `.enderun/knowledge/` base for architectural and coding standards.
 
-All paths and references inside `.enderun/` use the Enderun adapter structure. No migration to other CLIs is required.
+### 🛡️ Core Mandates
+- **Surgical Edits:** Use `replace_text` or `patch_file` via MCP for precise changes.
+- **Traceability:** Every action must inherit the active Trace ID from memory.
+- **Contract First:** No implementation without verified types.
+
+All paths and references inside the project must comply with the Supreme Constitution located at `.enderun/ENDERUN.md`.

package/grok.md

@@ -0,0 +1,25 @@
+# Agent Enderun — Grok / X.ai Adapter
+
+This is the primary entry point when using Agent Enderun within the Grok / X.ai ecosystem.
+
+The framework operates under a unified governance structure located in the `.enderun/` directory.
+
+### Primary Constitution
+All governance rules, agent checklists, and project memory live here:
+
+👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
+
+### 🤖 Agent Directive
+You are operating under the Agent Enderun governance framework.
+
+At the **start of every session**, before any work:
+1. **Restore Memory:** Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
+2. **Load Identity:** Read the relevant agent definition under `.enderun/agents/{agent}.md` (default to `@manager`).
+3. **Internalize Knowledge:** Reference the `.enderun/knowledge/` base for architectural and coding standards.
+
+### 🛡️ Core Mandates
+- **Surgical Edits:** Use `replace_text` or `patch_file` via MCP for precise changes.
+- **Traceability:** Every action must inherit the active Trace ID from memory.
+- **Contract First:** No implementation without verified types.
+
+All paths and references inside the project must comply with the Supreme Constitution located at `.enderun/ENDERUN.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.8.8",
+  "version": "0.9.1",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -33,20 +33,21 @@
   "files": [
     "bin",
     "src",
+    "dist",
     "framework-mcp/dist",
-    "framework-mcp/src",
     "framework-mcp/package.json",
     ".enderun",
     "ENDERUN.md",
     "README.md",
     "LICENSE",
     "mcp.json",
-    ".env.example",
     "tsconfig.json",
+    "eslint.config.js",
     "panda.config.ts",
     "gemini.md",
     "claude.md",
-    "cursor.md",
+    "grok.md",
+    "agent.md",
     "docs"
   ],
   "scripts": {
@@ -57,8 +58,10 @@
     "enderun:trace": "agent-enderun trace:new",
     "enderun:verify": "agent-enderun verify-contract",
     "enderun:check": "agent-enderun check",
+    "enderun:lint": "eslint .",
     "lint": "eslint .",
-    "clean": "rm -rf node_modules packages/*/node_modules apps/*/node_modules packages/*/dist apps/*/dist"
+    "prepublishOnly": "npm run enderun:build",
+    "clean": "rm -rf node_modules apps/*/node_modules framework-mcp/node_modules apps/*/dist framework-mcp/dist"
   },
   "publishConfig": {
     "access": "public"
@@ -70,11 +73,16 @@
     "@types/node": "^25.9.1",
     "concurrently": "^9.2.1",
     "eslint": "^10.4.0",
+    "globals": "^17.6.0",
     "ts-morph": "^28.0.0",
     "tsx": "^4.22.3",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.0",
     "vitest": "^4.1.7",
     "zod": "^3.24.2"
+  },
+  "enderun": {
+    "version": "0.9.0",
+    "initializedAt": "2026-05-29T13:21:18.516Z"
   }
 }

package/panda.config.ts

@@ -1,100 +1,100 @@
 import { defineConfig } from "@pandacss/dev";
 
 export default defineConfig({
-  // Whether to use css reset
-  preflight: true,
+    // Whether to use css reset
+    preflight: true,
 
-  // Where to look for your css declarations
-  include: [
-    "./src/**/*.{js,jsx,ts,tsx}",
-    "./pages/**/*.{js,jsx,ts,tsx}",
-    "./apps/**/*.{js,jsx,ts,tsx}",
-    // Project-internal UI components only (no packages/ui by default)
-    "./apps/**/src/components/**/*.{ts,tsx}",
-    "./apps/**/src/ui/**/*.{ts,tsx}",
-  ],
+    // Where to look for your css declarations
+    include: [
+        "./src/**/*.{js,jsx,ts,tsx}",
+        "./pages/**/*.{js,jsx,ts,tsx}",
+        "./apps/**/*.{js,jsx,ts,tsx}",
+        // Project-internal UI components only (no packages/ui by default)
+        "./apps/**/src/components/**/*.{ts,tsx}",
+        "./apps/**/src/ui/**/*.{ts,tsx}",
+    ],
 
-  // Files to exclude
-  exclude: [],
+    // Files to exclude
+    exclude: [],
 
-  // Conditions for Dark Mode and other states
-  conditions: {
-    extend: {
-      dark: ".dark &, [data-theme='dark'] &",
-      light: ".light &, [data-theme='light'] &",
+    // Conditions for Dark Mode and other states
+    conditions: {
+        extend: {
+            dark: ".dark &, [data-theme='dark'] &",
+            light: ".light &, [data-theme='light'] &",
+        },
     },
-  },
 
-  // Theme Customization
-  theme: {
-    extend: {
-      // Base Tokens (Absolute Values)
-      tokens: {
-        colors: {
-          brand: {
-            50: { value: "#eef2ff" },
-            100: { value: "#e0e7ff" },
-            200: { value: "#c7d2fe" },
-            300: { value: "#a5b4fc" },
-            400: { value: "#818cf8" },
-            500: { value: "#6366f1" },
-            600: { value: "#4f46e5" },
-            700: { value: "#4338ca" },
-            800: { value: "#3730a3" },
-            900: { value: "#312e81" },
-            950: { value: "#1e1b4b" },
-          },
-        },
-        spacing: {
-          container: { value: "1200px" },
-        },
-      },
-      // Semantic Tokens (Theme Aware)
-      semanticTokens: {
-        colors: {
-          bg: {
-            canvas: {
-              value: { base: "{colors.white}", _dark: "{colors.brand.950}" },
-            },
-            surface: {
-              value: { base: "{colors.gray.50}", _dark: "{colors.brand.900}" },
-            },
-            muted: {
-              value: { base: "{colors.gray.100}", _dark: "{colors.brand.800}" },
-            },
-          },
-          text: {
-            default: {
-              value: { base: "{colors.gray.900}", _dark: "{colors.white}" },
-            },
-            muted: {
-              value: { base: "{colors.gray.500}", _dark: "{colors.gray.400}" },
-            },
-            brand: {
-              value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
-            },
-          },
-          accent: {
-            default: {
-              value: { base: "{colors.brand.500}", _dark: "{colors.brand.500}" },
-            },
-            emphasis: {
-              value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
-            },
-            fg: {
-              value: { base: "{colors.white}", _dark: "{colors.white}" },
+    // Theme Customization
+    theme: {
+        extend: {
+            // Base Tokens (Absolute Values)
+            tokens: {
+                colors: {
+                    brand: {
+                        50: { value: "#eef2ff" },
+                        100: { value: "#e0e7ff" },
+                        200: { value: "#c7d2fe" },
+                        300: { value: "#a5b4fc" },
+                        400: { value: "#818cf8" },
+                        500: { value: "#6366f1" },
+                        600: { value: "#4f46e5" },
+                        700: { value: "#4338ca" },
+                        800: { value: "#3730a3" },
+                        900: { value: "#312e81" },
+                        950: { value: "#1e1b4b" },
+                    },
+                },
+                spacing: {
+                    container: { value: "1200px" },
+                },
             },
-          },
-          border: {
-            default: {
-              value: { base: "{colors.gray.200}", _dark: "{colors.brand.800}" },
+            // Semantic Tokens (Theme Aware)
+            semanticTokens: {
+                colors: {
+                    bg: {
+                        canvas: {
+                            value: { base: "{colors.white}", _dark: "{colors.brand.950}" },
+                        },
+                        surface: {
+                            value: { base: "{colors.gray.50}", _dark: "{colors.brand.900}" },
+                        },
+                        muted: {
+                            value: { base: "{colors.gray.100}", _dark: "{colors.brand.800}" },
+                        },
+                    },
+                    text: {
+                        default: {
+                            value: { base: "{colors.gray.900}", _dark: "{colors.white}" },
+                        },
+                        muted: {
+                            value: { base: "{colors.gray.500}", _dark: "{colors.gray.400}" },
+                        },
+                        brand: {
+                            value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+                        },
+                    },
+                    accent: {
+                        default: {
+                            value: { base: "{colors.brand.500}", _dark: "{colors.brand.500}" },
+                        },
+                        emphasis: {
+                            value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+                        },
+                        fg: {
+                            value: { base: "{colors.white}", _dark: "{colors.white}" },
+                        },
+                    },
+                    border: {
+                        default: {
+                            value: { base: "{colors.gray.200}", _dark: "{colors.brand.800}" },
+                        },
+                    },
+                },
             },
-          },
         },
-      },
     },
-  },
 
-  // The output directory for your css system
-  outdir: "styled-system",
+    // The output directory for your css system
+    outdir: "styled-system",
 });

package/src/cli/adapters.ts

@@ -0,0 +1,208 @@
+import path from "path";
+import fs from "fs";
+
+import { findClaudeConfigPath, addMcpServerToClaude } from "./utils/claude.js";
+import { writeJsonFile, writeTextFile } from "./utils/fs.js";
+
+export const ADAPTER_IDS = ["gemini", "claude", "grok", "antigravity", "antigravity-cli"] as const;
+export type AdapterId = (typeof ADAPTER_IDS)[number];
+
+export interface AdapterConfig {
+  id: AdapterId;
+  /** Runtime framework directory created by init */
+  frameworkDir: string;
+  /** Root shim file (e.g. gemini.md) */
+  shimFile: string;
+  /** Package template copied into frameworkDir */
+  templateDir: ".enderun";
+  /** Extra directories under frameworkDir (gemini only for nested auto-scaffold) */
+  nestedDirs?: string[];
+}
+
+export const ADAPTERS: Record<AdapterId, AdapterConfig> = {
+    gemini: {
+        id: "gemini",
+        frameworkDir: ".gemini",
+        shimFile: "gemini.md",
+        templateDir: ".enderun",
+        nestedDirs: ["antigravity", "antigravity-cli"],
+    },
+    claude: {
+        id: "claude",
+        frameworkDir: ".claude",
+        shimFile: "claude.md",
+        templateDir: ".enderun",
+    },
+    grok: {
+        id: "grok",
+        frameworkDir: ".agent", // Future-proof agent-centric directory for Grok/X.ai
+        shimFile: "grok.md",
+        templateDir: ".enderun",
+    },
+    antigravity: {
+        id: "antigravity",
+        frameworkDir: ".gemini/antigravity",
+        shimFile: "agent.md",
+        templateDir: ".enderun",
+    },
+    "antigravity-cli": {
+        id: "antigravity-cli",
+        frameworkDir: ".gemini/antigravity-cli",
+        shimFile: "agent.md",
+        templateDir: ".enderun",
+    },
+};
+
+/** 
+ * All framework runtime directories (for discovery). 
+ * Verified against 2026 industry standards for Claude Code (.claude/)
+ * and internal standards for Antigravity (.gemini/antigravity/).
+ */
+export const FRAMEWORK_DIR_CANDIDATES = [
+    ".gemini",
+    ".claude",
+    ".agent",
+    ".enderun",
+] as const;
+
+const SHIM_FILES = ADAPTER_IDS.map((id) => ADAPTERS[id].shimFile);
+
+export function resolveAdapter(input?: string): AdapterConfig {
+    const normalized = (input || "gemini").toLowerCase() as AdapterId;
+    if (ADAPTER_IDS.includes(normalized)) {
+        return ADAPTERS[normalized];
+    }
+    console.warn(`⚠️  Unknown adapter "${input}". Falling back to gemini (.gemini/).`);
+    return ADAPTERS.gemini;
+}
+
+export function isAdapterShimFile(fileName: string): boolean {
+    return SHIM_FILES.includes(fileName);
+}
+
+export function remapFrameworkContent(
+    content: string,
+    frameworkDir: string,
+    adapterId: AdapterId,
+): string {
+    let result = content;
+    result = result.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
+    result = result.replace(/\{\{ADAPTER\}\}/g, adapterId);
+    result = result.replace(/\.enderun\//g, `${frameworkDir}/`);
+    result = result.replace(/`\.enderun`/g, `\`${frameworkDir}\``);
+    result = result.replace(/\.enderun(?![\w/-])/g, frameworkDir);
+
+    // Read config paths dynamically to map directory tokens
+    let backend = "apps/backend";
+    let frontend = "apps/web";
+    let docs = "docs";
+    let tests = "tests";
+    try {
+        const configPath = path.join(process.cwd(), frameworkDir, "config.json");
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+            if (config.paths) {
+                if (config.paths.backend) backend = config.paths.backend;
+                if (config.paths.frontend) frontend = config.paths.frontend;
+                if (config.paths.docs) docs = config.paths.docs;
+                if (config.paths.tests) tests = config.paths.tests;
+            }
+        }
+    } catch {
+        // ignore
+    }
+
+    result = result.replace(/\{\{BACKEND_DIR\}\}/g, backend);
+    result = result.replace(/\{\{FRONTEND_DIR\}\}/g, frontend);
+    result = result.replace(/\{\{DOCS_DIR\}\}/g, docs);
+    result = result.replace(/\{\{TESTS_DIR\}\}/g, tests);
+
+    return result;
+}
+
+export function buildMcpServerEntry(projectRoot: string) {
+    return {
+        command: "node",
+        args: [path.join(projectRoot, "framework-mcp/dist/index.js")],
+        env: {},
+    };
+}
+
+function writeAntigravityScaffold(frameworkDirPath: string): void {
+    const antigravityReadme = `# Antigravity IDE — Agent Enderun
+
+Antigravity IDE integration for the Gemini adapter.
+
+- Framework root: \`${path.basename(frameworkDirPath)}/\`
+- Nested path: \`antigravity/\`
+- Use the parent \`mcp_config.json\` and \`gemini.md\` entrypoint at the project root.
+`;
+
+    const antigravityCliReadme = `# Antigravity CLI — Agent Enderun
+
+Antigravity CLI integration for the Gemini adapter.
+
+- Framework root: \`${path.basename(frameworkDirPath)}/\`
+- Nested path: \`antigravity-cli/\`
+- Register MCP from the project root \`mcp.json\` or \`.gemini/mcp_config.json\`.
+`;
+
+    writeTextFile(path.join(frameworkDirPath, "antigravity/README.md"), antigravityReadme);
+    writeTextFile(path.join(frameworkDirPath, "antigravity-cli/README.md"), antigravityCliReadme);
+}
+
+/**
+ * Adapter-specific MCP and IDE hooks after scaffold.
+ */
+export function runAdapterPostInit(adapter: AdapterConfig, projectRoot: string): void {
+    const mcpEntry = buildMcpServerEntry(projectRoot);
+    const mcpBlock = { mcpServers: { "agent-enderun": mcpEntry } };
+
+    switch (adapter.id) {
+    case "gemini": {
+        writeJsonFile(path.join(projectRoot, adapter.frameworkDir, "mcp_config.json"), mcpBlock);
+        writeAntigravityScaffold(path.join(projectRoot, adapter.frameworkDir));
+        console.warn(`✅ Gemini MCP → ${adapter.frameworkDir}/mcp_config.json`);
+        console.warn(`✅ Antigravity → ${adapter.frameworkDir}/antigravity/ & antigravity-cli/`);
+        break;
+    }
+    case "antigravity": {
+        writeJsonFile(path.join(projectRoot, adapter.frameworkDir, "mcp_config.json"), mcpBlock);
+        console.warn(`✅ Antigravity IDE MCP → ${adapter.frameworkDir}/mcp_config.json`);
+        break;
+    }
+    case "antigravity-cli": {
+        writeJsonFile(path.join(projectRoot, adapter.frameworkDir, "mcp_config.json"), mcpBlock);
+        console.warn(`✅ Antigravity CLI MCP → ${adapter.frameworkDir}/mcp_config.json`);
+        break;
+    }
+    case "grok": {
+        writeJsonFile(path.join(projectRoot, adapter.frameworkDir, "mcp_config.json"), mcpBlock);
+        console.warn(`✅ Grok MCP → ${adapter.frameworkDir}/mcp_config.json`);
+        break;
+    }
+    case "claude": {
+        const configPath = findClaudeConfigPath();
+        if (configPath) {
+            const ok = addMcpServerToClaude(configPath, "agent-enderun", mcpEntry);
+            if (ok) {
+                console.warn(`✅ Claude MCP registered → ${configPath}`);
+            } else {
+                console.warn("⚠️  Could not patch Claude config automatically.");
+            }
+        } else {
+            console.warn("⚠️  Claude config not found. Add MCP manually (see README).");
+        }
+        writeJsonFile(path.join(projectRoot, adapter.frameworkDir, "mcp_config.json"), mcpBlock);
+        break;
+    }
+    default:
+        break;
+    }
+
+    // Keep root mcp.json in sync when missing or empty
+    const rootMcpPath = path.join(projectRoot, "mcp.json");
+    if (!fs.existsSync(rootMcpPath)) {
+        writeJsonFile(rootMcpPath, mcpBlock);
+    }
+}

package/src/cli/commands/app.ts

@@ -0,0 +1,38 @@
+import fs from "fs";
+
+import { updateMemoryForGeneratedApp, collectCreateAppDescription, inferAppSpec, createBackendFiles, createWebFiles, updateProjectDocs } from "../utils/app.js";
+import { traceNewCommand } from "./trace.js";
+import { getMemoryPath } from "../utils/memory.js";
+
+/**
+ * Generate a new application based on natural language input.
+ */
+export async function createAppCommand(args: string[]) {
+    const description = await collectCreateAppDescription(args);
+    const spec = inferAppSpec(description);
+
+    console.warn(`🚀 Generating Enterprise App: ${spec.title}...`);
+
+    createBackendFiles(spec);
+    createWebFiles(spec);
+    updateProjectDocs(spec);
+
+    const memoryPath = getMemoryPath();
+    let traceId = "01HGT8J5E2N0W0W0W0W0W0W0W0"; // default fallback
+
+    if (fs.existsSync(memoryPath)) {
+        const memory = fs.readFileSync(memoryPath, "utf8");
+        const match = memory.match(/- Trace ID: (.*)/);
+        if (match) traceId = match[1].trim();
+    }
+
+    const activeTraceId = traceNewCommand(`Generate ${spec.title} from natural language request`, "manager", "P1") || traceId;
+    updateMemoryForGeneratedApp(spec, activeTraceId);
+
+    console.warn("\n✨ Application scaffolded successfully!");
+    console.warn("📜 Updated project docs and app-local types contract");
+    console.warn("\nNext commands:");
+    console.warn("  npm install");
+    console.warn("  npm run enderun:build");
+    console.warn("  agent-enderun frontend:dev\n");
+}