agent-enderun 0.8.6 → 0.8.8

package/docs/roadmap.md

@@ -42,7 +42,7 @@ This program systematically audits current agent maturity levels and runs struct
 | **@explorer** | 6.5 | 8.5 | High / Stable. Highly capable in dependency analysis and codebase intelligence. |
 | **@analyst** | 6.5 | 8.5 | Medium / Stable. Handles system health metrics and compliance audits. |
 | **@git** | 6.0 | 8.0 | Medium / Stable. Coordinates PRs, semantic commits, and version compliance. |
-| **@mobile & @native** | 2.0 | 7.5 | Low / Dormant. Foundational blueprints and Hermes safety rules added. |
+| **@mobile** | 2.0 | 7.5 | Low / Dormant. Foundational blueprints and Hermes safety rules added. |
 
 > **Note:** `@frontend` is currently the highest risk to enterprise onboarding and is the top priority.
 

package/framework-mcp/dist/schemas.js

@@ -46,12 +46,6 @@ export const UPDATE_KNOWLEDGE_BASE_ARGS_SCHEMA = z.object({
     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),
 });
@@ -59,15 +53,6 @@ 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(),
@@ -81,17 +66,10 @@ export const GENERATE_SEMANTIC_COMMIT_MESSAGE_ARGS_SCHEMA = z.object({
 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),
 });
@@ -104,15 +82,3 @@ export const SYNC_CONTRACT_HASH_ARGS_SCHEMA = z.object({
 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(),
-});

package/framework-mcp/dist/tools/framework.js

@@ -1,6 +1,5 @@
 import fs from "fs";
 import path from "path";
-import { execSync } from "child_process";
 import { getFrameworkDir, collectMarkdownArtifacts, FRAMEWORK_VERSION } from "../utils.js";
 export const frameworkTools = [
     {
@@ -119,10 +118,9 @@ export const frameworkHandlers = {
             missing.push(`[MISSING FOLDER] ${frameworkDir}/agents`);
         }
         else {
-            const agents = fs.readdirSync(agentsDir).filter((f) => {
-                const fullAgentDir = path.join(agentsDir, f);
-                return fs.statSync(fullAgentDir).isDirectory() && fs.existsSync(path.join(fullAgentDir, "agent.json"));
-            });
+            const agents = fs.readdirSync(agentsDir)
+                .filter((f) => f.endsWith(".md") && f !== "README.md")
+                .map((f) => f.replace(".md", ""));
             const logsDir = path.join(projectRoot, frameworkDir, "logs");
             for (const agentName of agents) {
                 const logFile = path.join(logsDir, `${agentName}.json`);
@@ -182,15 +180,46 @@ export const frameworkHandlers = {
     },
     verify_framework_health: async (args, projectRoot) => {
         try {
-            // Run the internal CLI check command via tsx to ensure we test current state
-            // If the CLI is not yet linked, we might need a relative path
-            const cliPath = path.join(projectRoot, "bin/cli.js");
-            const output = execSync(`node ${cliPath} check`, { cwd: projectRoot, encoding: "utf-8", stdio: "pipe" });
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK\n\n${output}` }] };
+            const frameworkDir = getFrameworkDir(projectRoot);
+            const requiredFiles = [
+                ["Constitution", fs.existsSync(path.join(projectRoot, "ENDERUN.md")) ? "ENDERUN.md" : path.join(frameworkDir, "ENDERUN.md")],
+                ["Memory", path.join(frameworkDir, "PROJECT_MEMORY.md")],
+                ["Command Map", path.join(frameworkDir, "cli-commands.json")],
+                ["Framework Config", path.join(frameworkDir, "config.json")],
+                ["Agent Status", path.join(frameworkDir, "STATUS.md")],
+                ["MCP Config", "mcp.json"],
+                ["Backend Contract", "apps/backend/contract.version.json"],
+                ["MCP Server", "framework-mcp/package.json"],
+                ["Panda CSS Config", "panda.config.ts"],
+                ["Brain Dashboard", path.join(frameworkDir, "BRAIN_DASHBOARD.md")],
+                ["Docs Portal", "docs/README.md"],
+                ["Getting Started", "docs/getting-started.md"],
+            ];
+            const lines = [];
+            let issues = 0;
+            for (const [name, relativePath] of requiredFiles) {
+                if (fs.existsSync(path.join(projectRoot, relativePath))) {
+                    lines.push(`OK ${name}: ${relativePath}`);
+                }
+                else {
+                    issues += 1;
+                    lines.push(`MISSING ${name}: ${relativePath}`);
+                }
+            }
+            const buildPath = path.join(projectRoot, "framework-mcp/dist/index.js");
+            if (fs.existsSync(buildPath)) {
+                lines.push("OK MCP Build: framework-mcp/dist/index.js");
+            }
+            else {
+                issues += 1;
+                lines.push("MISSING MCP Build: framework-mcp/dist/index.js");
+            }
+            const status = issues === 0 ? "PASSED" : "FAILED";
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (${status})\n\n${lines.join("\n")}` }] };
         }
         catch (error) {
             const err = error;
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.stdout || err.message}` }] };
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.message ?? "Unknown error"}` }] };
         }
     }
 };

package/framework-mcp/dist/tools/governance.js

@@ -1,7 +1,7 @@
 /**
  * Governance Tools - MCP Tools for enforcing corporate governance standards
  *
- * These tools bridge the .gemini/knowledge/corporate-governance/ knowledge base
+ * These tools bridge the .enderun/knowledge/corporate-governance/ knowledge base
  * with actual code-level compliance verification.
  *
  * Philosophy: We do not just document standards — we actively verify them.

package/framework-mcp/dist/tools/memory.js

@@ -78,14 +78,31 @@ export const memoryHandlers = {
         const lockPath = memoryPath + ".lock";
         const lockOwner = `lock-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
         try {
-            if (fs.existsSync(lockPath)) {
-                const stats = fs.statSync(lockPath);
-                if (Date.now() - stats.mtimeMs > 120000)
-                    fs.unlinkSync(lockPath);
-                else
-                    return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+            try {
+                // Atomic write using 'wx' flag to prevent TOCTOU race conditions
+                fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }), { flag: "wx" });
+            }
+            catch (error) {
+                if (error.code === "EEXIST") {
+                    const stats = fs.statSync(lockPath);
+                    if (Date.now() - stats.mtimeMs > 120000) {
+                        try {
+                            fs.unlinkSync(lockPath);
+                            // Retry atomic write once after unlinking stale lock
+                            fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }), { flag: "wx" });
+                        }
+                        catch {
+                            return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+                        }
+                    }
+                    else {
+                        return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+                    }
+                }
+                else {
+                    throw error;
+                }
             }
-            fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }));
             let memoryContent = fs.readFileSync(memoryPath, "utf-8");
             if (section === "HISTORY") {
                 let updated = false;

package/framework-mcp/dist/tools/monitoring.js

@@ -93,7 +93,7 @@ export const monitoringHandlers = {
             results.agents = [{ error: "STATUS.md not found or unreadable" }];
         }
         // Read queue depths
-        const queueBase = path.join(projectRoot, ".enderun", "queue");
+        const queueBase = path.join(projectRoot, getFrameworkDir(projectRoot), "queue");
         for (const subdir of ["pending", "processing", "completed", "failed"]) {
             try {
                 const files = await fs.readdir(path.join(queueBase, subdir));
@@ -104,7 +104,7 @@ export const monitoringHandlers = {
             }
         }
         // Read orchestrator log for recent blockages and broadcasts
-        const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
         try {
             const logContent = await fs.readFile(logPath, "utf-8");
             const log = JSON.parse(logContent);
@@ -128,7 +128,7 @@ export const monitoringHandlers = {
         const { agentName, lastN } = args;
         const n = lastN ?? 20;
         const logName = agentName.replace("@", "") + ".json";
-        const logPath = path.join(projectRoot, ".enderun", "logs", logName);
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", logName);
         try {
             const content = await fs.readFile(logPath, "utf-8");
             const log = JSON.parse(content);
@@ -172,7 +172,7 @@ export const monitoringHandlers = {
     async detect_bottleneck_agents(args, projectRoot) {
         const { thresholdMinutes } = args;
         const threshold = thresholdMinutes ?? 30;
-        const statusPath = path.join(projectRoot, ".enderun", "STATUS.md");
+        const statusPath = path.join(projectRoot, getFrameworkDir(projectRoot), "STATUS.md");
         const bottlenecks = [];
         try {
             const content = await fs.readFile(statusPath, "utf-8");
@@ -256,7 +256,7 @@ export const monitoringHandlers = {
             report.agentStatuses = [];
         }
         // Queue snapshot
-        const queueBase = path.join(projectRoot, ".enderun", "queue");
+        const queueBase = path.join(projectRoot, getFrameworkDir(projectRoot), "queue");
         const snapshot = {};
         for (const dir of ["pending", "processing", "completed", "failed"]) {
             try {
@@ -269,7 +269,7 @@ export const monitoringHandlers = {
         }
         report.queueSnapshot = snapshot;
         // Recent blockages
-        const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
         try {
             const logContent = await fs.readFile(logPath, "utf-8");
             const log = JSON.parse(logContent);

package/framework-mcp/dist/tools/orchestration.js

@@ -1,5 +1,6 @@
 import { promises as fs } from "fs";
 import path from "path";
+import { getFrameworkDir } from "../utils.js";
 // ─── Tool Definitions ─────────────────────────────────────────────────────────
 export const orchestrationTools = [
     {
@@ -178,7 +179,7 @@ export const orchestrationHandlers = {
             parallelOpportunities: executionWaves.filter((w) => w.length > 1).length,
         };
         // Persist to queue
-        const queueDir = path.join(projectRoot, ".enderun", "queue", "pending");
+        const queueDir = path.join(projectRoot, getFrameworkDir(projectRoot), "queue", "pending");
         await fs.mkdir(queueDir, { recursive: true });
         await fs.writeFile(path.join(queueDir, `${traceId}-dag.json`), JSON.stringify(dag, null, 2), "utf-8");
         return { content: [{ type: "text", text: JSON.stringify(dag, null, 2) }] };
@@ -188,7 +189,7 @@ export const orchestrationHandlers = {
         // Try to load capability roster from shared-facts.json (dynamic — fixes KRITIK-3)
         let agentCapabilityRoster = [];
         try {
-            const sharedFactsPath = path.join(projectRoot, ".enderun", "memory-graph", "shared-facts.json");
+            const sharedFactsPath = path.join(projectRoot, getFrameworkDir(projectRoot), "memory-graph", "shared-facts.json");
             const content = await fs.readFile(sharedFactsPath, "utf-8");
             const facts = JSON.parse(content);
             agentCapabilityRoster = facts.agentCapabilityRoster ?? [];
@@ -249,7 +250,7 @@ export const orchestrationHandlers = {
             sourceMap: Object.keys(domainMap).length > 0 ? "shared-facts" : "fallback",
         };
         // Write assignment log
-        const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
         let log = { assignments: [] };
         try {
             const existing = await fs.readFile(logPath, "utf-8");
@@ -264,7 +265,7 @@ export const orchestrationHandlers = {
         return { content: [{ type: "text", text: JSON.stringify(assignment, null, 2) }] };
     },
     async get_agent_workload(_args, projectRoot) {
-        const statusPath = path.join(projectRoot, ".enderun", "STATUS.md");
+        const statusPath = path.join(projectRoot, getFrameworkDir(projectRoot), "STATUS.md");
         let statusContent;
         try {
             statusContent = await fs.readFile(statusPath, "utf-8");
@@ -301,7 +302,7 @@ export const orchestrationHandlers = {
             status: "ESCALATED_TO_MANAGER",
         };
         // Log blockage
-        const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
         let log = { assignments: [], blockages: [] };
         try {
             const existing = await fs.readFile(logPath, "utf-8");
@@ -316,7 +317,7 @@ export const orchestrationHandlers = {
         await fs.mkdir(path.dirname(logPath), { recursive: true });
         await fs.writeFile(logPath, JSON.stringify(log, null, 2), "utf-8");
         // Write a message to @manager's inbox via messages folder
-        const messagesDir = path.join(projectRoot, ".enderun", "messages");
+        const messagesDir = path.join(projectRoot, getFrameworkDir(projectRoot), "messages");
         await fs.mkdir(messagesDir, { recursive: true });
         const messageFile = path.join(messagesDir, `BLOCKAGE-${traceId}-${Date.now()}.json`);
         await fs.writeFile(messageFile, JSON.stringify({
@@ -342,11 +343,11 @@ export const orchestrationHandlers = {
             timestamp: new Date().toISOString(),
         };
         // Write to messages folder for all agents
-        const messagesDir = path.join(projectRoot, ".enderun", "messages");
+        const messagesDir = path.join(projectRoot, getFrameworkDir(projectRoot), "messages");
         await fs.mkdir(messagesDir, { recursive: true });
         await fs.writeFile(path.join(messagesDir, `${broadcast.id}.json`), JSON.stringify(broadcast, null, 2), "utf-8");
         // Log broadcast
-        const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+        const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
         let log = {
             assignments: [],
             blockages: [],

package/framework-mcp/dist/utils.js

@@ -8,13 +8,13 @@ const getPackageVersion = () => {
         const pkgPath = path.join(__dirname, "../package.json");
         if (fs.existsSync(pkgPath)) {
             const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-            return pkg.version || "0.7.5";
+            return pkg.version || "0.8.8";
         }
     }
     catch {
         // fallback
     }
-    return "0.6.6";
+    return "0.8.8";
 };
 export const FRAMEWORK_VERSION = getPackageVersion();
 /**

package/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "author": "Yusuf BEKAR",
   "license": "MIT",

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

@@ -1,6 +1,5 @@
 import fs from "fs";
 import path from "path";
-import { execSync } from "child_process";
 import { 
     getFrameworkDir, 
     collectMarkdownArtifacts, 
@@ -179,14 +178,46 @@ export const frameworkHandlers = {
     },
     verify_framework_health: async (args: unknown, projectRoot: string) => {
         try {
-            // Run the internal CLI check command via tsx to ensure we test current state
-            // If the CLI is not yet linked, we might need a relative path
-            const cliPath = path.join(projectRoot, "bin/cli.js");
-            const output = execSync(`node ${cliPath} check`, { cwd: projectRoot, encoding: "utf-8", stdio: "pipe" });
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK\n\n${output}` }] };
+            const frameworkDir = getFrameworkDir(projectRoot);
+            const requiredFiles = [
+                ["Constitution", fs.existsSync(path.join(projectRoot, "ENDERUN.md")) ? "ENDERUN.md" : path.join(frameworkDir, "ENDERUN.md")],
+                ["Memory", path.join(frameworkDir, "PROJECT_MEMORY.md")],
+                ["Command Map", path.join(frameworkDir, "cli-commands.json")],
+                ["Framework Config", path.join(frameworkDir, "config.json")],
+                ["Agent Status", path.join(frameworkDir, "STATUS.md")],
+                ["MCP Config", "mcp.json"],
+                ["Backend Contract", "apps/backend/contract.version.json"],
+                ["MCP Server", "framework-mcp/package.json"],
+                ["Panda CSS Config", "panda.config.ts"],
+                ["Brain Dashboard", path.join(frameworkDir, "BRAIN_DASHBOARD.md")],
+                ["Docs Portal", "docs/README.md"],
+                ["Getting Started", "docs/getting-started.md"],
+            ] as const;
+
+            const lines: string[] = [];
+            let issues = 0;
+            for (const [name, relativePath] of requiredFiles) {
+                if (fs.existsSync(path.join(projectRoot, relativePath))) {
+                    lines.push(`OK ${name}: ${relativePath}`);
+                } else {
+                    issues += 1;
+                    lines.push(`MISSING ${name}: ${relativePath}`);
+                }
+            }
+
+            const buildPath = path.join(projectRoot, "framework-mcp/dist/index.js");
+            if (fs.existsSync(buildPath)) {
+                lines.push("OK MCP Build: framework-mcp/dist/index.js");
+            } else {
+                issues += 1;
+                lines.push("MISSING MCP Build: framework-mcp/dist/index.js");
+            }
+
+            const status = issues === 0 ? "PASSED" : "FAILED";
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (${status})\n\n${lines.join("\n")}` }] };
         } catch (error: unknown) {
-            const err = error as { stdout?: string; message?: string };
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.stdout || err.message}` }] };
+            const err = error as { message?: string };
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.message ?? "Unknown error"}` }] };
         }
     }
 };

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

@@ -83,12 +83,27 @@ export const memoryHandlers = {
         const lockPath = memoryPath + ".lock";
         const lockOwner = `lock-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
         try {
-            if (fs.existsSync(lockPath)) {
-                const stats = fs.statSync(lockPath);
-                if (Date.now() - stats.mtimeMs > 120000) fs.unlinkSync(lockPath);
-                else return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+            try {
+                // Atomic write using 'wx' flag to prevent TOCTOU race conditions
+                fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }), { flag: "wx" });
+            } catch (error: any) {
+                if (error.code === "EEXIST") {
+                    const stats = fs.statSync(lockPath);
+                    if (Date.now() - stats.mtimeMs > 120000) {
+                        try {
+                            fs.unlinkSync(lockPath);
+                            // Retry atomic write once after unlinking stale lock
+                            fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }), { flag: "wx" });
+                        } catch {
+                            return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+                        }
+                    } else {
+                        return { content: [{ type: "text", text: "Memory is locked. Try again later." }] };
+                    }
+                } else {
+                    throw error;
+                }
             }
-            fs.writeFileSync(lockPath, JSON.stringify({ owner: lockOwner, createdAt: new Date().toISOString() }));
             let memoryContent = fs.readFileSync(memoryPath, "utf-8");
             if (section === "HISTORY") {
                 let updated = false;

package/framework-mcp/src/tools/monitoring.ts

@@ -113,7 +113,7 @@ export const monitoringHandlers: Record<
     }
 
     // Read queue depths
-    const queueBase = path.join(projectRoot, ".enderun", "queue");
+    const queueBase = path.join(projectRoot, getFrameworkDir(projectRoot), "queue");
     for (const subdir of ["pending", "processing", "completed", "failed"] as const) {
       try {
         const files = await fs.readdir(path.join(queueBase, subdir));
@@ -124,7 +124,7 @@ export const monitoringHandlers: Record<
     }
 
     // Read orchestrator log for recent blockages and broadcasts
-    const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
     try {
       const logContent = await fs.readFile(logPath, "utf-8");
       const log = JSON.parse(logContent) as {
@@ -152,7 +152,7 @@ export const monitoringHandlers: Record<
     const { agentName, lastN } = args as { agentName: string; lastN?: number };
     const n = lastN ?? 20;
     const logName = agentName.replace("@", "") + ".json";
-    const logPath = path.join(projectRoot, ".enderun", "logs", logName);
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", logName);
 
     try {
       const content = await fs.readFile(logPath, "utf-8");
@@ -206,7 +206,7 @@ export const monitoringHandlers: Record<
     const { thresholdMinutes } = args as { thresholdMinutes?: number };
     const threshold = thresholdMinutes ?? 30;
 
-    const statusPath = path.join(projectRoot, ".enderun", "STATUS.md");
+    const statusPath = path.join(projectRoot, getFrameworkDir(projectRoot), "STATUS.md");
     const bottlenecks: Array<{ agent: string; reason: string; state: string; severity: string }> = [];
 
     try {
@@ -308,7 +308,7 @@ export const monitoringHandlers: Record<
     }
 
     // Queue snapshot
-    const queueBase = path.join(projectRoot, ".enderun", "queue");
+    const queueBase = path.join(projectRoot, getFrameworkDir(projectRoot), "queue");
     const snapshot: Record<string, number> = {};
     for (const dir of ["pending", "processing", "completed", "failed"]) {
       try {
@@ -321,7 +321,7 @@ export const monitoringHandlers: Record<
     report.queueSnapshot = snapshot;
 
     // Recent blockages
-    const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
     try {
       const logContent = await fs.readFile(logPath, "utf-8");
       const log = JSON.parse(logContent) as { blockages?: unknown[] };

package/framework-mcp/src/tools/orchestration.ts

@@ -1,6 +1,7 @@
 import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { promises as fs } from "fs";
 import path from "path";
+import { getFrameworkDir } from "../utils.js";
 
 // ─── Tool Definitions ─────────────────────────────────────────────────────────
 
@@ -208,7 +209,7 @@ export const orchestrationHandlers: Record<
     };
 
     // Persist to queue
-    const queueDir = path.join(projectRoot, ".enderun", "queue", "pending");
+    const queueDir = path.join(projectRoot, getFrameworkDir(projectRoot), "queue", "pending");
     await fs.mkdir(queueDir, { recursive: true });
     await fs.writeFile(
       path.join(queueDir, `${traceId}-dag.json`),
@@ -230,7 +231,7 @@ export const orchestrationHandlers: Record<
     // Try to load capability roster from shared-facts.json (dynamic — fixes KRITIK-3)
     let agentCapabilityRoster: Array<{ agent: string; primaryDomain: string; capability: number }> = [];
     try {
-      const sharedFactsPath = path.join(projectRoot, ".enderun", "memory-graph", "shared-facts.json");
+      const sharedFactsPath = path.join(projectRoot, getFrameworkDir(projectRoot), "memory-graph", "shared-facts.json");
       const content = await fs.readFile(sharedFactsPath, "utf-8");
       const facts = JSON.parse(content) as { agentCapabilityRoster?: typeof agentCapabilityRoster };
       agentCapabilityRoster = facts.agentCapabilityRoster ?? [];
@@ -294,7 +295,7 @@ export const orchestrationHandlers: Record<
     };
 
     // Write assignment log
-    const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
     let log: { assignments: unknown[] } = { assignments: [] };
     try {
       const existing = await fs.readFile(logPath, "utf-8");
@@ -310,7 +311,7 @@ export const orchestrationHandlers: Record<
   },
 
   async get_agent_workload(_args, projectRoot) {
-    const statusPath = path.join(projectRoot, ".enderun", "STATUS.md");
+    const statusPath = path.join(projectRoot, getFrameworkDir(projectRoot), "STATUS.md");
     let statusContent: string;
     try {
       statusContent = await fs.readFile(statusPath, "utf-8");
@@ -356,7 +357,7 @@ export const orchestrationHandlers: Record<
     };
 
     // Log blockage
-    const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
     let log: { assignments: unknown[]; blockages: unknown[] } = { assignments: [], blockages: [] };
     try {
       const existing = await fs.readFile(logPath, "utf-8");
@@ -370,7 +371,7 @@ export const orchestrationHandlers: Record<
     await fs.writeFile(logPath, JSON.stringify(log, null, 2), "utf-8");
 
     // Write a message to @manager's inbox via messages folder
-    const messagesDir = path.join(projectRoot, ".enderun", "messages");
+    const messagesDir = path.join(projectRoot, getFrameworkDir(projectRoot), "messages");
     await fs.mkdir(messagesDir, { recursive: true });
     const messageFile = path.join(messagesDir, `BLOCKAGE-${traceId}-${Date.now()}.json`);
     await fs.writeFile(
@@ -409,7 +410,7 @@ export const orchestrationHandlers: Record<
     };
 
     // Write to messages folder for all agents
-    const messagesDir = path.join(projectRoot, ".enderun", "messages");
+    const messagesDir = path.join(projectRoot, getFrameworkDir(projectRoot), "messages");
     await fs.mkdir(messagesDir, { recursive: true });
     await fs.writeFile(
       path.join(messagesDir, `${broadcast.id}.json`),
@@ -418,7 +419,7 @@ export const orchestrationHandlers: Record<
     );
 
     // Log broadcast
-    const logPath = path.join(projectRoot, ".enderun", "logs", "orchestrator.json");
+    const logPath = path.join(projectRoot, getFrameworkDir(projectRoot), "logs", "orchestrator.json");
     let log: { assignments: unknown[]; blockages: unknown[]; broadcasts: unknown[] } = {
       assignments: [],
       blockages: [],

package/framework-mcp/src/utils.ts

@@ -10,12 +10,12 @@ const getPackageVersion = (): string => {
         const pkgPath = path.join(__dirname, "../package.json");
         if (fs.existsSync(pkgPath)) {
             const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-            return pkg.version || "0.8.5";
+            return pkg.version || "0.8.8";
         }
     } catch {
         // fallback
     }
-    return "0.8.5";
+    return "0.8.8";
 };
 
 export const FRAMEWORK_VERSION = getPackageVersion();

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.6",
+  "version": "0.8.8",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",