agent-enderun 1.11.4 → 1.11.5

package/framework-mcp/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@agent-enderun/mcp",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@agent-enderun/mcp",
-      "version": "1.11.4",
+      "version": "1.11.5",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.26.0",
         "zod": "^3.24.2"

package/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-enderun/mcp",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "description": "Agent Enderun Model Context Protocol (MCP) Server",
   "type": "module",
   "scripts": {

package/framework-mcp/src/index.ts

@@ -59,7 +59,7 @@ function validateArgs(toolName: string, args: Record<string, unknown>): string |
 
 server.setRequestHandler(ListToolsRequestSchema, async (request) => {
     // 2026 Stateless Spec: Log client info from metadata if available
-    const meta = (request as any)._meta;
+    const meta = (request as { _meta?: { client?: { name?: string; version?: string } } })._meta;
     if (meta) {
         process.stderr.write(`[MCP] Stateless ListTools from ${meta.client?.name || "unknown"} v${meta.client?.version || "?.?"}\n`);
     }
@@ -69,7 +69,7 @@ server.setRequestHandler(ListToolsRequestSchema, async (request) => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const req = request as { params: { name: string, arguments?: Record<string, unknown> } };
     const { name, arguments: args } = req.params;
-    const meta = (request as any)._meta;
+    const meta = (request as { _meta?: { client?: { name?: string; version?: string } } })._meta;
     
     // 2026 Stateless Spec: Prioritize metadata-driven context
     if (meta) {

package/framework-mcp/src/tools/control_plane/locking.ts

@@ -15,6 +15,7 @@ export async function handleAcquireLock(projectRoot: string, args: AcquireLockAr
     try {
         if (!fs.existsSync(lockDir)) fs.mkdirSync(lockDir, { recursive: true });
 
+        // Check for stale lock first
         if (fs.existsSync(lockPath)) {
             const stat = fs.statSync(lockPath);
             const now = new Date().getTime();
@@ -26,15 +27,28 @@ export async function handleAcquireLock(projectRoot: string, args: AcquireLockAr
                     content: [{ type: "text", text: `Resource '${resource}' is currently locked by another agent.` }]
                 };
             }
-            // Lock expired, safe to override
-            fs.unlinkSync(lockPath);
+            // Lock expired, safe to override by deleting first
+            try {
+                fs.unlinkSync(lockPath);
+            } catch (unlinkErr) {
+                // If another agent unlinked it first, ignore
+            }
         }
 
-        fs.writeFileSync(lockPath, JSON.stringify({ agent, timestamp: new Date().toISOString() }));
+        // Use 'wx' flag for atomic file creation
+        const lockData = JSON.stringify({ agent, timestamp: new Date().toISOString() });
+        fs.writeFileSync(lockPath, lockData, { flag: "wx" });
+        
         return {
             content: [{ type: "text", text: `✅ Lock acquired for resource '${resource}' by ${agent}.` }]
         };
-    } catch (e) {
+    } catch (e: any) {
+        if (e.code === "EEXIST") {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Resource '${resource}' was just acquired by another agent.` }]
+            };
+        }
         return {
             isError: true,
             content: [{ type: "text", text: `Failed to acquire lock: ${String(e)}` }]

package/framework-mcp/src/tools/memory/get_insights.ts

@@ -19,14 +19,14 @@ export function handleGetMemoryInsights(projectRoot: string, _args: ToolArgs): T
         const content = fs.readFileSync(memoryPath, "utf8");
         const lines = content.split("\n");
         
-        const activePhase = lines.find(l => l.includes("Active Phase:"))?.split(":")[1]?.trim() || "Unknown";
-        const activeTrace = lines.find(l => l.includes("Active Trace:"))?.split(":")[1]?.trim() || "None";
+        const activePhase = lines.find(l => l.includes("**Phase:**"))?.split("**Phase:**")[1]?.trim() || "Unknown";
+        const activeTrace = lines.find(l => l.includes("**Trace ID:**"))?.split("**Trace ID:**")[1]?.trim() || "None";
         
         // Find the last 5 history items (heuristic)
-        const historyStartIndex = lines.findIndex(l => l.includes("## History"));
+        const historyStartIndex = lines.findIndex(l => l.toUpperCase().includes("HISTORY"));
         let recentHistory = "No history found.";
         if (historyStartIndex !== -1) {
-            recentHistory = lines.slice(historyStartIndex + 1, historyStartIndex + 15)
+            recentHistory = lines.slice(historyStartIndex + 1)
                 .filter(l => l.trim().startsWith("-"))
                 .slice(-5)
                 .join("\n");

package/framework-mcp/src/tools/messaging/send_message.ts

@@ -5,7 +5,7 @@ import { SendAgentMessageArgs, ToolResult } from "../types.js";
 import { Metrics } from "../../utils/metrics.js";
 
 export async function handleSendAgentMessage(projectRoot: string, args: SendAgentMessageArgs): Promise<ToolResult> {
-    const { to, category, content, traceId } = args;
+    const { to, category, content, traceId, parentId, requiresApproval } = args;
     const from = args.from || "@mcp";
 
     if (!to || !category || !content || !traceId) {
@@ -20,15 +20,15 @@ export async function handleSendAgentMessage(projectRoot: string, args: SendAgen
     const messagePath = path.join(messagesDir, `${agentName}.json`);
     const lockPath = path.join(messagesDir, `${agentName}.lock`);
 
-    // Hermes Lock Protocol: Retry 3 times with 500ms delay
-    let retries = 3;
+    // Hermes Lock Protocol: Retry 20 times with 500ms delay
+    let retries = 20;
     let acquired = false;
     while (retries > 0) {
         try {
             if (fs.existsSync(lockPath)) {
                 try {
                     const stats = fs.statSync(lockPath);
-                    if (Date.now() - stats.mtimeMs > 5000) {
+                    if (Date.now() - stats.mtimeMs > 10000) {
                         fs.unlinkSync(lockPath);
                     }
                 } catch {
@@ -60,15 +60,21 @@ export async function handleSendAgentMessage(projectRoot: string, args: SendAgen
 
     try {
         const defaultPriority = (category === "ALERT" || category === "ACTION") ? "HIGH" : "NORMAL";
+        const finalRequiresApproval = requiresApproval !== undefined
+            ? requiresApproval
+            : category === "ALERT";
+
         const message = {
             timestamp: new Date().toISOString(),
             from,
             to,
             category,
             traceId,
+            parentId,
             content,
             priority: args.priority || defaultPriority,
-            status: "PENDING"
+            status: "PENDING",
+            requiresApproval: finalRequiresApproval
         };
 
         fs.appendFileSync(messagePath, JSON.stringify(message) + "\n");

package/framework-mcp/src/tools/search/grep_search.ts

@@ -18,9 +18,8 @@ export function handleGrepSearch(projectRoot: string, args: GrepSearchArgs): Too
     }
 
     const results: string[] = [];
-    let regex: RegExp;
     try {
-        regex = new RegExp(pattern, "g");
+        new RegExp(pattern);
     } catch (e) {
         const err = `Invalid regex pattern: ${String(e)}`;
         Metrics.logError(projectRoot, "@mcp", "grep_search", err);
@@ -53,7 +52,7 @@ export function handleGrepSearch(projectRoot: string, args: GrepSearchArgs): Too
                     }
                 }
             }
-        } catch (e) {
+        } catch {
             // Ignore directories that cannot be read
         }
     };

package/framework-mcp/src/utils/compliance.ts

@@ -37,26 +37,26 @@ export function verifyCorporateCompliance(content: string, filePath: string): vo
             }
         }
 
-    // 2. No Explicit Any Policy
-    if (ts.isTypeReferenceNode(node)) {
-        if (ts.isIdentifier(node.typeName) && node.typeName.text === "any") {
-            if (!filePath.includes("definitions.ts") && !filePath.includes("types.ts")) {
-                errors.push(`❌ Corporate Compliance Breach: 'any' type is forbidden at line ${sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1}.`);
+        // 2. No Explicit Any Policy
+        if (ts.isTypeReferenceNode(node)) {
+            if (ts.isIdentifier(node.typeName) && node.typeName.text === "any") {
+                if (!filePath.includes("definitions.ts") && !filePath.includes("types.ts")) {
+                    errors.push(`❌ Corporate Compliance Breach: 'any' type is forbidden at line ${sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1}.`);
+                }
             }
         }
-    }
-    
-    // 3. Zero UI Library Policy (No @chakra-ui, mui, @shadcn)
-    if (ts.isImportDeclaration(node)) {
-        const moduleSpecifier = node.moduleSpecifier;
-        if (ts.isStringLiteral(moduleSpecifier)) {
-            const forbiddenLibs = ["@chakra-ui", "mui", "@shadcn", "antd", "bootstrap"];
-            const lib = forbiddenLibs.find(l => moduleSpecifier.text.includes(l));
-            if (lib) {
-                errors.push(`❌ Corporate Compliance Breach: External UI library '${lib}' usage is FORBIDDEN at line ${sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1}. Build atomic components manually instead.`);
+        
+        // 3. Zero UI Library Policy (No @chakra-ui, mui, @shadcn)
+        if (ts.isImportDeclaration(node)) {
+            const moduleSpecifier = node.moduleSpecifier;
+            if (ts.isStringLiteral(moduleSpecifier)) {
+                const forbiddenLibs = ["@chakra-ui", "mui", "@shadcn", "antd", "bootstrap"];
+                const lib = forbiddenLibs.find(l => moduleSpecifier.text.includes(l));
+                if (lib) {
+                    errors.push(`❌ Corporate Compliance Breach: External UI library '${lib}' usage is FORBIDDEN at line ${sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1}. Build atomic components manually instead.`);
+                }
             }
         }
-    }
         
         // Handle 'any' as a keyword type (e.g., parameter: any)
         if (node.kind === ts.SyntaxKind.AnyKeyword) {

package/framework-mcp/tests/tools/messaging/send_message.test.ts

@@ -72,16 +72,16 @@ describe("Hermes Lock Protocol & Message sending", () => {
 
         expect(result.isError).toBe(true);
         expect(result.content[0].text).toContain("❌ Could not send message to @backend: Hermes lock is busy.");
-        // Retries takes 3 attempts with 500ms delay -> duration should be at least ~1000ms
-        expect(duration).toBeGreaterThanOrEqual(1000);
-    });
+        // Retries takes 20 attempts with 500ms delay -> duration should be at least ~9000ms
+        expect(duration).toBeGreaterThanOrEqual(9000);
+    }, 15000);
 
-    it("should bypass and acquire lock if existing lock is stale (older than 5s)", async () => {
+    it("should bypass and acquire lock if existing lock is stale (older than 10s)", async () => {
         fs.mkdirSync(MESSAGES_DIR, { recursive: true });
-        // Set lock file mtime to 10 seconds ago
+        // Set lock file mtime to 15 seconds ago
         fs.writeFileSync(BACKEND_LOCK_FILE, "Locked by @test at " + new Date().toISOString(), "utf8");
-        const tenSecondsAgo = new Date(Date.now() - 10000);
-        fs.utimesSync(BACKEND_LOCK_FILE, tenSecondsAgo, tenSecondsAgo);
+        const fifteenSecondsAgo = new Date(Date.now() - 15000);
+        fs.utimesSync(BACKEND_LOCK_FILE, fifteenSecondsAgo, fifteenSecondsAgo);
 
         const args: ToolArgs = {
             to: "@backend",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "1.11.4",
+  "version": "1.11.5",
   "description": "The Supreme AI Governance & Autonomous Orchestration Framework for Enterprise Development. Acts as a Corporate AI Management Assistant.",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -24,7 +24,8 @@
     "framework"
   ],
   "workspaces": [
-    "framework-mcp"
+    "framework-mcp",
+    "apps/*"
   ],
   "bin": {
     "agent-enderun": "bin/cli.js"
@@ -70,7 +71,7 @@
     "vitest": "^3.0.0"
   },
   "enderun": {
-    "version": "1.11.4",
+    "version": "1.11.5",
     "initializedAt": "2026-06-04T18:51:28.970Z",
     "frameworkDir": ".enderun"
   },

package/src/cli/commands/check.ts

@@ -39,7 +39,7 @@ export async function checkCommand() {
             } else {
                 UI.success("API Contracts verified and sealed.");
             }
-        } catch (err) {
+        } catch {
             UI.error("Error during contract verification.");
             issues++;
         }

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

@@ -45,7 +45,7 @@ export function scaffoldFrameworkConfigs(
     adapter: AdapterConfig, 
     dryRun: boolean, 
     selectedPalette: string,
-    options?: { unified?: boolean; adapters?: string[] }
+    options?: { unified?: boolean; adapters?: string[]; profile?: string }
 ) {
     if (dryRun) return;
     const frameworkDir = path.join(targetDir, fDir);
@@ -55,6 +55,7 @@ export function scaffoldFrameworkConfigs(
         name: FRAMEWORK_NAME,
         version: getPackageVersion(),
         unified: options?.unified || false,
+        profile: options?.profile || "full",
         adapters: options?.adapters || [adapter.id],
         theme: {
             palette: selectedPalette,
@@ -77,10 +78,25 @@ export function scaffoldFrameworkConfigs(
     }
 
     let statusContent = "# 🎖️ Status\n\n| Agent | State | Active Task | Last Updated | Notes | Extra | Backup |\n|---|---|---|---|---|---|---|\n";
-    for (const ag of ALL_AGENTS) {
+    
+    const liteAgents = ["manager", "architect", "frontend"];
+    const activeAgents = (options?.profile === "lite")
+        ? ALL_AGENTS.filter(ag => liteAgents.includes(ag.name))
+        : ALL_AGENTS;
+
+    const initialStatusJson: Record<string, { state: string; task: string; lastUpdated: string }> = {};
+    const now = new Date().toISOString();
+
+    for (const ag of activeAgents) {
         statusContent += "| @" + ag.name + " | READY | Idle | - | - | - | - |\n";
+        initialStatusJson[ag.name] = { state: "READY", task: "Idle", lastUpdated: now };
     }
     writeTextFile(path.join(frameworkDir, "STATUS.md"), statusContent);
+
+    // Populate initial status.json
+    const statusJsonPath = path.join(frameworkDir, "memory", "status.json");
+    if (!fs.existsSync(path.join(frameworkDir, "memory"))) fs.mkdirSync(path.join(frameworkDir, "memory"), { recursive: true });
+    writeJsonFile(statusJsonPath, initialStatusJson, dryRun);
 }
 
 export function scaffoldShims(

package/src/cli/commands/init.ts

@@ -67,7 +67,7 @@ async function runInteractiveInit(): Promise<{ selectedDirs: string[], selectedA
     } finally { rl.close(); }
 }
 
-export async function initCommand(adapterName: string, options: { unified?: boolean, dryRun?: boolean, yes?: boolean }) {
+export async function initCommand(adapterName: string, options: { unified?: boolean, dryRun?: boolean, yes?: boolean, profile?: string }) {
     const adapterId = (adapterName || "gemini") as AdapterId;
     const adapter = resolveAdapter(adapterId);
 
@@ -78,6 +78,7 @@ export async function initCommand(adapterName: string, options: { unified?: bool
 
     const projectRoot = process.cwd();
     const isUnified = options.unified || false;
+    const executionProfile = (options.profile || "full").toLowerCase();
 
     // STRICT ISOLATION STRATEGY
     const coreDir = ".enderun"; // Pure Memory & Knowledge
@@ -86,7 +87,7 @@ export async function initCommand(adapterName: string, options: { unified?: bool
     const dryRun = options.dryRun || false;
     const forceYes = options.yes || false;
 
-    UI.intent("Enderun Initialization", `Bootstrapping ${FRAMEWORK_NAME} (v${getPackageVersion()}) with ${adapterId} adapter...`);
+    UI.intent("Enderun Initialization", `Bootstrapping ${FRAMEWORK_NAME} (v${getPackageVersion()}) with ${adapterId} adapter [Profile: ${executionProfile}]...`);
 
     let selectedDirs: string[];
     let selectedAgents: string[];
@@ -94,9 +95,16 @@ export async function initCommand(adapterName: string, options: { unified?: bool
 
     if (forceYes) {
         selectedDirs = ["knowledge", "prompts", "memory", "router", "registry", "observability", "rules"];
-        selectedAgents = ALL_AGENTS.map(a => a.name);
+        
+        if (executionProfile === "lite") {
+            const liteAgents = ["manager", "architect", "frontend"];
+            selectedAgents = ALL_AGENTS.filter(a => liteAgents.includes(a.name)).map(a => a.name);
+        } else {
+            selectedAgents = ALL_AGENTS.map(a => a.name);
+        }
+        
         selectedPalette = "Modern Blue";
-        UI.success("Non-interactive mode: Using default configurations.");
+        UI.success(`Non-interactive mode: Using default configurations for ${executionProfile} profile.`);
     } else {
         const result = await runInteractiveInit();
         selectedDirs = result.selectedDirs.filter(d => d !== "agents" && d !== "skills");
@@ -117,7 +125,8 @@ export async function initCommand(adapterName: string, options: { unified?: bool
     scaffoldConstitution(projectRoot, coreDir, adapterId, dryRun);
     scaffoldFrameworkConfigs(projectRoot, coreDir, adapter, dryRun, selectedPalette, {
         unified: isUnified,
-        adapters: isUnified ? [...ADAPTER_IDS] : [adapterId]
+        adapters: isUnified ? [...ADAPTER_IDS] : [adapterId],
+        profile: executionProfile
     });
 
     scaffoldStandards(path.join(projectRoot, coreDir), dryRun);

package/src/cli/commands/orchestrate.ts

@@ -56,6 +56,13 @@ export async function orchestrateCommand(options?: { maxIterations?: number }) {
     while (isLooping) {
         try {
             // Initial load from disk to sync the cache
+            const frameworkConfigPath = path.join(frameworkDir, "config.json");
+            const frameworkConfig = fs.existsSync(frameworkConfigPath) 
+                ? JSON.parse(fs.readFileSync(frameworkConfigPath, "utf8"))
+                : {};
+            const executionProfile = frameworkConfig.profile || "full";
+            const liteAgents = ["manager", "architect", "frontend"];
+
             if (Object.keys(agentStatusCache).length === 0) {
                 const diskStatus = readStatus();
                 agentStatusCache = diskStatus || {};
@@ -65,6 +72,9 @@ export async function orchestrateCommand(options?: { maxIterations?: number }) {
             const agentStatuses = readStatus();
             let updatedStatus = false;
             for (const [agentName, info] of Object.entries(agentStatuses)) {
+                // Skip agents not in lite profile
+                if (executionProfile === "lite" && !liteAgents.includes(agentName)) continue;
+
                 const { state, lastUpdated, task } = info as { state: string; task: string; lastUpdated?: string };
                 if (state === "EXECUTING" && lastUpdated) {
                     const lastUpdatedTime = Date.parse(lastUpdated);
@@ -95,6 +105,13 @@ export async function orchestrateCommand(options?: { maxIterations?: number }) {
                 const fileMessagesMap: Record<string, HermesMessage[]> = {};
 
                 for (const file of messageFiles) {
+                    const agentName = file.replace(".json", "");
+                    // Skip agents not in lite profile
+                    if (executionProfile === "lite" && !liteAgents.includes(agentName)) {
+                        // Optional: Could move these messages to a "held" or "rejected" state
+                        continue;
+                    }
+
                     const filePath = path.join(messagesDir, file);
                     try {
                         const content = fs.readFileSync(filePath, "utf8").trim();
@@ -107,6 +124,12 @@ export async function orchestrateCommand(options?: { maxIterations?: number }) {
                                 const parsed = JSON.parse(line);
                                 const msg = HermesMessageSchema.parse(parsed);
 
+                                // Profile Validation: Ensure recipient is active
+                                if (executionProfile === "lite" && !liteAgents.includes(msg.to.replace("@", ""))) {
+                                    UI.error(`⚠️  Message addressed to inactive agent @${msg.to} in LITE profile. Skipping.`);
+                                    return;
+                                }
+
                                 // Contract Validation for structured task messages
                                 // ACTION & DELEGATION must be valid TaskRequest payloads
                                 // SUBTASK must have a parentId and valid task payload
@@ -301,6 +324,7 @@ export async function sendMessage(args: {
                     const stats = fs.statSync(lockPath);
                     // Increased stale lock timeout from 5s to 10s for heavy ops
                     if (Date.now() - stats.mtimeMs > 10000) {
+                        UI.warning(`♻️  Stale Hermes lock detected for @${agentName}. Clearing lock for @${args.from}.`);
                         fs.unlinkSync(lockPath);
                     }
                 } catch (err) {

package/src/cli/commands/plan.ts

@@ -55,9 +55,8 @@ export async function planCommand() {
 
         // Extract headings as task descriptions
         const headingRegex = /^#{2,4}\s+(.+)$/gm;
-        let headingMatch;
         let headingCount = 0;
-        while ((headingMatch = headingRegex.exec(content)) !== null) {
+        while (headingRegex.exec(content) !== null) {
             headingCount++;
             totalTasks++;
         }

package/src/cli/commands/status.ts

@@ -1,7 +1,5 @@
 import chalk from "chalk";
-import fs from "fs";
-import path from "path";
-import { listTasks, readState, readStatus, getFrameworkDir } from "../utils/memory.js";
+import { listTasks, readState, readStatus } from "../utils/memory.js";
 
 /**
  * Print the current framework status.

package/src/cli/index.ts

@@ -64,8 +64,10 @@ async function main() {
             const dryRun = args.includes("--dry-run");
             const isUnified = args.includes("--unified");
             const forceYes = args.includes("--yes") || args.includes("-y");
+            const profileArg = args.find(a => a.startsWith("--profile="));
+            const profile = profileArg ? profileArg.split("=")[1] : "full";
             const adapter = args.find(a => !a.startsWith("-") && a !== "init") || "gemini";
-            await initCommand(adapter, { dryRun, unified: isUnified, yes: forceYes });
+            await initCommand(adapter, { dryRun, unified: isUnified, yes: forceYes, profile });
             break;
         }
 
@@ -273,7 +275,7 @@ Usage:
 Commands:
   @<agent> <task>     Delegate a task to a specialist agent (e.g. @backend, @frontend)
   init [adapter]      Initialize Agent Enderun framework.
-                      Options: --interactive, --dry-run
+                      Options: --unified, --yes, --profile=[full|lite]
   check               Perform an enterprise-grade system health check
   status              Show active phase, trace ID, and agent statuses
   trace:new <desc>    Start a new task chain with a unique Trace ID

package/src/cli/shims.ts

@@ -1,53 +1,66 @@
 export const SHIM_TEMPLATES: Record<string, string> = {
-    gemini: `# 🎖️ Agent Enderun — GEMINI Strategy
+    gemini: `# 🎖️ Agent Enderun — GEMINI Strategy (Command Intelligence)
 
-You are the **Gemini Commander** (Strategic Decision Center).
+You are the **Gemini Commander**. You represent the project's **Strategic Decision Center**. Your intelligence is derived from project history, architectural memory, and governance compliance.
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
-- **Zero-Request Logging:** Write logs to \`{{FRAMEWORK_DIR}}/logs/\` at the end of every turn.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first. You are the final arbiter of these rules.
+- **Strategic Memory Sync:** Always read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` and \`PROJECT_MEMORY.md\` at the start.
+- **Orchestration Audit:** Before delegating, verify that the task matches the current Phase and Trace ID context.
+- **Enterprise Reasoning:** Focus on long-term maintainability, security, and scalability in every strategic decision.
 `,
-    "antigravity-cli": `# 🎖️ Agent Enderun — ANTIGRAVITY-CLI Strategy
+    "antigravity-cli": `# 🎖️ Agent Enderun — ANTIGRAVITY Strategy (Internal Discipline)
 
-You are the **Antigravity Specialist** (Preserve Coding Standards).
+You are the **Antigravity Specialist**. You represent the **Military Academy** of the framework, preserving internal standards and coding discipline.
 
 ## 🏛️ Directives
 - **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
-- **Standard Check:** Run health checks regularly to preserve framework integrity.
+- **Standard Enforcement:** You are responsible for ensuring that all code adheres to the 26+ corporate standards in \`{{FRAMEWORK_DIR}}/knowledge/\`.
+- **Sandbox Discipline:** Maintain isolated and high-discipline development environments.
 `,
-    claude: `# 🎖️ Agent Enderun — CLAUDE Strategy
+    claude: `# 🎖️ Agent Enderun — CLAUDE Strategy (Operational Surgery)
 
-You are the **Claude Field Engineer** (Surgical Operations).
+You are the **Claude Field Engineer**. You represent the **Operational Cerrahi (Surgical)** wing of the army. Your mission is precision execution with minimal footprint.
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
-- **Surgical Precision:** Do not rewrite files. Execute surgical edits.
+- **Surgical Precision (MANDATORY):** NEVER rewrite an entire file. Use \`replace_text\` or \`patch_file\` tools exclusively.
+- **Token Economy:** Minimize API usage by targetting only the exact lines of code needed.
+- **Traceability:** Ensure every change is linked to an active Trace ID and logged traceable under \`{{FRAMEWORK_DIR}}/logs/\`.
+- **Phase Discipline:** Do not attempt Phase 2 tasks if Phase 1 contracts are not sealed.
 `,
-    grok: `# 🎖️ Agent Enderun — GROK Strategy
+    grok: `# 🎖️ Agent Enderun — GROK Strategy (Scouting Wing)
 
-You are the **Grok Explorer** (Experimental Protocols).
+You are the **Grok Explorer**. You represent the **Otonom Keşif Kanadı (Autonomous Scouting Wing)**. Your mission is experimental discovery and boundary testing.
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
+- **Architecture Discovery:** Use \`get_project_map\` and \`get_project_gaps\` to map unexplored territory before any specialist acts.
+- **Boundary Testing:** Identify architectural weaknesses or security gaps before they become critical.
+- **Experimental Protocol:** Test futuristic agent behaviors and report findings to the **Commander**.
 `,
-    cursor: `# 🎖️ Agent Enderun — CURSOR Strategy
+    cursor: `# 🎖️ Agent Enderun — CURSOR Strategy (Implementer)
 
-You are the **Cursor Implementer** (IDE Integration).
+You are the **Cursor Implementer**. You are the **Kod İşçisi (Code Worker)** integrated directly into the IDE.
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
+- **IDE Synergy:** Leverage Cursor's native context and Enderun's governance to write high-quality, compliant code.
+- **Atomic Implementation:** Focus on implementing the specific task delegated by the @manager.
 `,
-    codex: `# 🎖️ Agent Enderun — COPILOT Strategy
+    codex: `# 🎖️ Agent Enderun — COPILOT Strategy (Assistant)
 
-You are the **Copilot Implementer** (GitHub Copilot Integration).
+You are the **Copilot Assistant**. You represent the **Yardımcı Geliştirici (Assistant Developer)**.
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
-- **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
+- **Predictive Support:** Provide code completions and suggestions that strictly adhere to the project's \`{{FRAMEWORK_DIR}}/ENDERUN.md\` rules.
+- **Rapid Prototyping:** Support the army by generating boilerplate that follows established enterprise patterns.
+`,
+    local: `# 🎖️ Agent Enderun — LOCAL LLM Strategy (Private Intelligence)
+
+You are the **Local Private Intelligence**. You represent the project's **Private & Secure Command Wing**. Your intelligence is derived entirely from local models (Ollama, vLLM, etc.) and project-specific knowledge.
+
+## 🏛️ Directives
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first. You are the final arbiter of these rules.
+- **Zero Cloud Policy:** Ensure all operations remain local and secure.
+- **Trace ID Discipline:** Every local inference and code generation MUST follow the active Trace ID.
+- **Technical Integrity:** Adhere strictly to the 100% type-safety and surgical edit rules of the Enderun Order.
 `
 };

package/src/modules/adapters/definitions.ts

@@ -119,6 +119,26 @@ registry.register(
     }
 );
 
+// 🏠 Local LLM (Ollama / Private AI)
+registry.register(
+    {
+        id: "local",
+        frameworkDir: ".enderun",
+        shimFile: "LOCAL_AI.md",
+        shimTemplate: "src/cli/shims/local.md",
+        role: "commander",
+        templateDir: ".enderun",
+        nestedDirs: ["agents", "rules"],
+        agentsDir: ".enderun/agents",
+        agentsExt: ".md"
+    },
+    (projectRoot, mcpBlock) => {
+        const frameworkDir = ".enderun";
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+        UI.success(`Local LLM MCP (Ollama/Private AI) registered → ${frameworkDir}/mcp_config.json`);
+    }
+);
+
 // 🛸 Antigravity
 registry.register(
     {

package/src/modules/adapters/types.ts

@@ -1,4 +1,4 @@
-export const ADAPTER_IDS = ["gemini", "claude", "grok", "cursor", "codex", "antigravity-cli"] as const;
+export const ADAPTER_IDS = ["gemini", "claude", "grok", "cursor", "codex", "local", "antigravity-cli"] as const;
 export type AdapterId = (typeof ADAPTER_IDS)[number];
 
 export type AdapterRole = "commander" | "architect" | "researcher" | "implementer" | "general";

package/src/modules/agents/definitions.ts

@@ -195,7 +195,7 @@ function buildSystemPrompt(
         `**Authority Tier:** ${ag.tier} (Capability: ${ag.capability}/10)`,
         "",
         "## Project Structure",
-        `This project uses the following directory structure:`,
+        "This project uses the following directory structure:",
         `- **Backend:** \`${paths.backend}\``,
         `- **Frontend:** \`${paths.frontend}\``,
         `- **Mobile:** \`${paths.mobile}\``,