agent-enderun 0.8.7 → 0.9.0

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/mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "agent-enderun": {
-      "command": "npx",
-      "args": ["agent-enderun", "mcp"],
+      "command": "node",
+      "args": ["framework-mcp/dist/index.js"],
       "env": {}
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.8.7",
+  "version": "0.9.0",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -32,21 +32,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 +57,9 @@
     "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"
+    "clean": "rm -rf node_modules apps/*/node_modules framework-mcp/node_modules apps/*/dist framework-mcp/dist"
   },
   "publishConfig": {
     "access": "public"
@@ -70,11 +71,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/tsconfig.json

@@ -12,5 +12,14 @@
     "forceConsistentCasingInFileNames": true,
     "outDir": "dist"
   },
+  "include": [
+    "src/**/*.ts",
+    "tests/**/*.ts",
+    "apps/**/*.ts",
+    "apps/**/*.tsx",
+    "framework-mcp/src/**/*.ts",
+    "vitest.config.ts",
+    "eslint.config.js"
+  ],
   "exclude": ["node_modules", "dist"]
 }

package/.enderun/claude.md

@@ -1,19 +0,0 @@
-# Agent Enderun — Claude Code CLI Adapter
-
-This file is the entry point when using Agent Enderun with Claude Code CLI.
-
-The framework installs into the `.claude/` folder for Claude users.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.claude/ENDERUN.md](.claude/ENDERUN.md)**
-
-### 🤖 Agent Directive (Claude Code CLI users)
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. Read `.claude/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. Read the relevant agent definition under `.claude/agents/{agent}.md` (especially `@manager`).
-
-All paths and references inside `.claude/` use the Claude adapter structure. No migration to other CLIs is required.

package/.enderun/cursor.md

@@ -1,19 +0,0 @@
-# Agent Enderun — Cursor / Codex Adapter
-
-This file is the entry point when using Agent Enderun with Cursor Composer / Codex CLI.
-
-The framework installs into the `.cursor/` folder for Cursor users.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.cursor/ENDERUN.md](.cursor/ENDERUN.md)**
-
-### 🤖 Agent Directive (Cursor users)
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. Read `.cursor/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. Read the relevant agent definition under `.cursor/agents/{agent}.md` (especially `@manager`).
-
-All paths and references inside `.cursor/` use the Cursor adapter structure. No migration to other CLIs is required.

package/.enderun/gemini.md

@@ -1,19 +0,0 @@
-# Agent Enderun — Gemini CLI Adapter
-
-This file is the entry point when using Agent Enderun with Gemini CLI.
-
-The framework installs into the `.enderun/` folder for Gemini users.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
-
-### 🤖 Agent Directive (Gemini CLI users)
-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`).
-
-All paths and references inside `.enderun/` use the Enderun adapter structure. No migration to other CLIs is required.

package/.enderun/logs/analyst.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/backend.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/devops.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/explorer.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/frontend.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/git.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/manager.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/mobile.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/native.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/orchestrator.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/qa.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.enderun/logs/security.json

@@ -1 +0,0 @@
-{"runs":[]}

package/.env.example

@@ -1,10 +0,0 @@
-# Agent Enderun Configuration
-AGENT_ENDERUN_PACKAGE_MANAGER=npm
-
-# AI API Keys
-GEMINI_API_KEY=
-ANTHROPIC_API_KEY=
-OPENAI_API_KEY=
-
-# MCP Configuration
-MCP_SERVER_PORT=3000

package/cursor.md

@@ -1,19 +0,0 @@
-# Agent Enderun — Cursor / Codex Adapter
-
-This file is the entry point when using Agent Enderun with Cursor Composer / Codex CLI.
-
-The framework installs into the `.cursor/` folder for Cursor users.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.cursor/ENDERUN.md](.cursor/ENDERUN.md)**
-
-### 🤖 Agent Directive (Cursor users)
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. Read `.cursor/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. Read the relevant agent definition under `.cursor/agents/{agent}.md` (especially `@manager`).
-
-All paths and references inside `.cursor/` use the Cursor adapter structure. No migration to other CLIs is required.

package/framework-mcp/README.md

@@ -1,55 +0,0 @@
-# AI-Enderun MCP Server (v0.8.3)
-
-English | [Türkçe](#türkçe)
-
-The `ai-enderun-mcp` package is the core intelligence engine of the Agent Enderun framework, implementing the Model Context Protocol (MCP).
-
-## English
-
-### 🛠️ Categorized Tools
-
-#### 🛡️ Security & Compliance
-- `security_audit_scan`: Scans for secrets, raw SQL, and unsafe patterns using AST.
-- `analyze_constitution_compliance`: Verifies adherence to `ENDERUN.md` rules.
-
-#### 🧠 Framework & Memory
-- `get_framework_status`: Retrieves active phase and status.
-- `update_project_memory`: Atomic updates to project brain sections.
-- `bootstrap_legacy_memory`: Auto-generates memory for existing projects.
-- `read_project_memory`: Safe read access to the project brain.
-
-#### 🔍 Codebase Intelligence
-- `search_codebase`: Regex-powered semantic search.
-- `analyze_dependencies`: Deep import tracking and dependency mapping.
-- `analyze_codebase_intelligence`: Detects complexity spikes and dead code.
-- `generate_dependency_graph`: Creates Mermaid architecture maps.
-
-#### 📜 Contract Management
-- `verify_api_contract`: Checks shared-types integrity via hashing.
-- `update_contract_hash`: Synchronizes the contract versioning.
-- `verify_contract_integrity`: Ensures API docs and types are in sync.
-
-#### 🎓 Academy & Orchestration
-- `log_agent_action`: Records traceable agent activities.
-- `send_agent_message`: Facilitates inter-agent collaboration.
-- `read_agent_messages`: Inbox management for specialized agents.
-
-#### 📦 Repository & Git
-- `generate_semantic_commit_message`: Automated commit messages based on diffs.
-
----
-
-## Türkçe
-
-### 🛠️ Kategorize Edilmiş Araçlar
-
-- **Güvenlik:** `security_audit_scan`, `analyze_constitution_compliance`.
-- **Hafıza:** `get_framework_status`, `update_project_memory`, `bootstrap_legacy_memory`.
-- **Zeka:** `search_codebase`, `analyze_dependencies`, `generate_dependency_graph`.
-- **Kontrat:** `verify_api_contract`, `update_contract_hash`, `verify_contract_integrity`.
-- **Orkestrasyon:** `send_agent_message`, `log_agent_action`.
-- **Repo:** `generate_semantic_commit_message`.
-
-## License
-
-MIT

package/framework-mcp/dist/schemas.js

@@ -1,118 +0,0 @@
-import { z } from "zod";
-export const SECURITY_AUDIT_ARGS_SCHEMA = z.object({
-    path: z.string().default("."),
-});
-export const SEARCH_CODEBASE_ARGS_SCHEMA = z.object({
-    query: z.string().min(1).max(300),
-    extension: z
-        .string()
-        .default("ts")
-        .refine((s) => /^[a-z0-9]+$/i.test(s), { message: "extension must be alphanumeric" }),
-});
-export const UPDATE_MEMORY_ARGS_SCHEMA = z.object({
-    section: z.enum(["CURRENT STATUS", "HISTORY", "ACTIVE TASKS"]),
-    content: z.string().min(1),
-});
-export const ANALYZE_DEPENDENCIES_ARGS_SCHEMA = z.object({
-    path: z.string().min(1),
-});
-export const LOG_AGENT_ACTION_ARGS_SCHEMA = z.object({
-    agent: z.string().min(1),
-    action: z.string().min(1),
-    requestId: z.string().min(1),
-    files: z.array(z.string()).default([]),
-    status: z.enum(["SUCCESS", "FAILURE"]),
-    summary: z.string().min(1),
-    details: z.record(z.string(), z.any()).default({}),
-});
-export const SEND_AGENT_MESSAGE_ARGS_SCHEMA = z.object({
-    from: z.string().min(1),
-    to: z.string().min(1),
-    message: z.string().min(1),
-    traceId: z.string().min(1),
-    category: z.enum(["ACTION", "DELEGATION", "INFO", "ALERT"]).default("INFO"),
-    priority: z.enum(["LOW", "MEDIUM", "HIGH", "URGENT"]).default("MEDIUM"),
-});
-export const UPDATE_AGENT_MESSAGE_STATUS_ARGS_SCHEMA = z.object({
-    agent: z.string().min(1),
-    traceId: z.string().min(1),
-    newStatus: z.enum(["ACKNOWLEDGED", "COMPLETED", "REJECTED"]),
-});
-export const SEARCH_KNOWLEDGE_BASE_ARGS_SCHEMA = z.object({
-    query: z.string().min(1),
-});
-export const UPDATE_KNOWLEDGE_BASE_ARGS_SCHEMA = z.object({
-    topic: z.string().min(1),
-    content: z.string().min(1),
-    tags: z.array(z.string().min(1)).default([]),
-});
-export const ANALYZE_DATABASE_SCHEMA_ARGS_SCHEMA = z.object({
-    path: z.string().default("apps/backend"),
-});
-export const GENERATE_STRATEGIC_BRIEFING_ARGS_SCHEMA = z.object({
-    focusArea: z.string().optional(),
-});
-export const ANALYZE_CONSTITUTION_COMPLIANCE_ARGS_SCHEMA = z.object({
-    path: z.string().min(1),
-});
-export const GENERATE_DEPENDENCY_GRAPH_ARGS_SCHEMA = z.object({
-    path: z.string().default("src"),
-    format: z.enum(["mermaid", "json"]).default("mermaid"),
-});
-export const GENERATE_ACADEMY_PROGRESS_REPORT_ARGS_SCHEMA = z.object({
-    days: z.number().default(7),
-});
-export const ANALYZE_DOCUMENTATION_DEBT_ARGS_SCHEMA = z.object({
-    path: z.string().default("."),
-});
-export const VALIDATE_REPOSITORY_HEALTH_ARGS_SCHEMA = z.object({
-    scope: z.enum(["full", "lint", "test", "build"]).default("full"),
-});
-export const READ_AGENT_MESSAGES_ARGS_SCHEMA = z.object({
-    agent: z.string().min(1),
-    traceId: z.string().min(1).optional(),
-});
-export const VERIFY_CONTRACT_INTEGRITY_ARGS_SCHEMA = z.object({
-    domain: z.string().min(1),
-});
-export const GENERATE_SEMANTIC_COMMIT_MESSAGE_ARGS_SCHEMA = z.object({
-    traceId: z.string().min(1),
-});
-export const ANALYZE_CODEBASE_INTELLIGENCE_ARGS_SCHEMA = z.object({
-    path: z.string().default("."),
-});
-export const GET_ACADEMY_PERFORMANCE_ARGS_SCHEMA = z.object({
-    periodDays: z.number().default(30),
-});
-export const ANALYZE_PROCEDURAL_CONTINUITY_ARGS_SCHEMA = z.object({
-    targetPath: z.string().min(1),
-    referencePath: z.string().min(1),
-});
-export const GET_AGENT_AUDIT_REPORT_ARGS_SCHEMA = z.object({
-    agent: z.string().min(1),
-    days: z.number().default(7),
-});
-export const GET_AGENT_INBOX_STATS_ARGS_SCHEMA = z.object({
-    agent: z.string().min(1),
-});
-export const GET_KNOWLEDGE_GRAPH_ARGS_SCHEMA = z.object({
-    tag: z.string().optional(),
-});
-export const SYNC_CONTRACT_HASH_ARGS_SCHEMA = z.object({
-    force: z.boolean().default(false),
-});
-export const VERIFY_FRAMEWORK_HEALTH_ARGS_SCHEMA = z.object({
-    detailed: z.boolean().default(false),
-});
-export const INSTANTIATE_BLUEPRINT_ARGS_SCHEMA = z.object({
-    blueprintPath: z.string().min(1),
-    targetPath: z.string().min(1),
-});
-export const LIST_BLUEPRINTS_ARGS_SCHEMA = z.object({
-    category: z.enum(["backend", "frontend"]).optional(),
-});
-export const SAVE_AS_BLUEPRINT_ARGS_SCHEMA = z.object({
-    blueprintPath: z.string().min(1),
-    content: z.string().min(1),
-    description: z.string().optional(),
-});