agent-enderun 0.5.7 → 0.5.9

package/.enderun/blueprints/frontend/ui/Button.tsx

@@ -0,0 +1,60 @@
+import { css, cx } from "../../../styled-system/css";
+import { type HTMLPandaProps } from "../../../styled-system/types";
+
+/**
+ * GOLDEN STANDARD: Button Component
+ * Uses Semantic Tokens for automatic theme support.
+ */
+export interface ButtonProps extends HTMLPandaProps<"button"> {
+  variant?: "primary" | "secondary" | "outline" | "ghost";
+  size?: "sm" | "md" | "lg";
+}
+
+export const Button = (props: ButtonProps) => {
+  const { variant = "primary", size = "md", className, ...rest } = props;
+
+  const buttonStyles = css({
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    fontWeight: "600",
+    borderRadius: "md",
+    cursor: "pointer",
+    transition: "all 0.2s ease",
+    _disabled: { opacity: 0.5, cursor: "not-allowed" },
+    _active: { transform: "scale(0.98)" },
+
+    // Size variants
+    ...(size === "sm" && { px: "3", py: "1.5", fontSize: "xs" }),
+    ...(size === "md" && { px: "4", py: "2", fontSize: "sm" }),
+    ...(size === "lg" && { px: "6", py: "3", fontSize: "md" }),
+
+    // Theme-aware Semantic Tokens
+    ...(variant === "primary" && {
+      bg: "accent.default",
+      color: "accent.fg",
+      _hover: { bg: "accent.emphasis" },
+    }),
+    ...(variant === "secondary" && {
+      bg: "bg.muted",
+      color: "text.default",
+      _hover: { bg: "border.default" },
+    }),
+    ...(variant === "outline" && {
+      bg: "transparent",
+      border: "1px solid",
+      borderColor: "border.default",
+      color: "text.default",
+      _hover: { bg: "bg.muted" },
+    }),
+    ...(variant === "ghost" && {
+      bg: "transparent",
+      color: "text.default",
+      _hover: { bg: "bg.muted" },
+    }),
+  });
+
+  return (
+    <button className={cx(buttonStyles, className)} {...rest} />
+  );
+};

package/.enderun/blueprints/frontend/ui/Input.tsx

@@ -0,0 +1,43 @@
+import { css, cx } from "../../../styled-system/css";
+import { type HTMLPandaProps } from "../../../styled-system/types";
+
+/**
+ * GOLDEN STANDARD: Input Component
+ * Fully theme-aware using semantic border and background tokens.
+ */
+export interface InputProps extends HTMLPandaProps<"input"> {
+  label?: string;
+}
+
+export const Input = (props: InputProps) => {
+  const { className, ...rest } = props;
+
+  const inputStyles = css({
+    width: "100%",
+    px: "4",
+    py: "2",
+    borderRadius: "md",
+    border: "1px solid",
+    borderColor: "border.default",
+    bg: "bg.canvas",
+    color: "text.default",
+    fontSize: "sm",
+    outline: "none",
+    transition: "all 0.2s ease",
+    _placeholder: { color: "text.muted" },
+    _focus: {
+      borderColor: "accent.default",
+      ring: "2px",
+      ringColor: "accent.default/20",
+    },
+    _disabled: {
+      opacity: 0.5,
+      cursor: "not-allowed",
+      bg: "bg.muted",
+    },
+  });
+
+  return (
+    <input className={cx(inputStyles, className)} {...rest} />
+  );
+};

package/.enderun/logs/manager.json

@@ -0,0 +1 @@
+[]

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.5.7)
+# Agent Enderun (v0.5.9)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
@@ -11,6 +11,29 @@
 
 ---
 
+## 🧠 INTELLIGENCE & DISCOVERY PROTOCOLS
+
+### 🔍 Architecture Discovery Protocol (ADP)
+When encountering a project, agents must never assume a specific folder structure. Use the following algorithm:
+1. **Entry Point Hunt:** Identify main entry points (`index.ts`, `main.ts`, `server.ts`) via `search_codebase`.
+2. **Business Logic Mapping:** Search for core domain keywords (e.g. `service`, `repository`, `controller`) to find where logic resides, regardless of directory names.
+3. **Contract Analysis:** Locate type definitions and API schemas to establish the "System Contract".
+4. **Adaptive Scaffolding:** Always propose architectural improvements or scaffolding *before* writing code. Wait for explicit User consent.
+
+---
+
+## 🪙 TOKEN ECONOMY & CONTEXT MANAGEMENT
+
+To minimize AI costs and maximize speed, all agents must adhere to the **Token Economy Protocol**:
+
+1. **Search Before Reading (MANDATORY):** Never `read_file` an entire directory or large file without searching for specific points of interest first.
+2. **Surgical Operations:** When editing, use the `replace` tool for targeted changes instead of overwriting entire files unless the file is very small (<50 lines).
+3. **Output Conciseness:** MCP tools must return the minimum required data. Avoid verbose logs or redundant status messages in tool outputs.
+4. **Context Compaction:** Before starting a new task, use `get_memory_insights` to retrieve only the relevant historical context.
+5. **No Blind Coding:** Stop and ask if a task requires reading more than 5 large files without a clear search result.
+
+---
+
 ## Constitution Status
 This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represent the "Supreme Law" of the project. All agents must read this file first in every session and strictly comply with its rules 100%. All framework-specific documentation is stored within `{{FRAMEWORK_DIR}}/docs/`.
 
@@ -41,7 +64,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 - **Team-Lead MANDATORY Orchestration:** Every user request MUST first be handled by the `@manager` (Team-Lead) agent. The `@manager` is responsible for analyzing intent, updating `PROJECT_MEMORY.md`, and delegating tasks to specialists. Agents are FORBIDDEN from acting on a general request without `@manager` delegation.
 - **Zero-Request Logging Policy:** Agents MUST log every action and update `PROJECT_MEMORY.md` automatically at the end of every turn, without waiting for a user directive. This is the "Operating Mode" of the framework.
 - **Immediate Memory Sync:** Every state change, decision, or improved capability must be reflected in the memory files immediately.
-- **Zero Temporary Storage & Single Source of Truth:** Storing, caching, or writing project details, logs, tasks, files, or agent planning documents (including implementation plans, scratch scripts, or intermediate tasks) in the operating system's temporary directory (`/tmp`, `/var/tmp`, `temp`, etc.) is strictly forbidden. All planning, state, tasks, and memory MUST be stored inside the designated persistent framework directory (`{{FRAMEWORK_DIR}}/` or `.gemini/` etc.) or the project workspace. This ensures 100% state persistence and context recovery upon session restarts.
+- **Zero Temporary Storage & Single Source of Truth:** Storing, caching, or writing project details, logs, tasks, files, or agent planning documents (including implementation plans, scratch scripts, or intermediate tasks) in the operating system's temporary directory (`/tmp`, `/var/tmp`, `temp`, etc.) is strictly forbidden. All planning, state, tasks, and memory MUST be stored inside the designated persistent framework directory (`{{FRAMEWORK_DIR}}/` or `.{{ADAPTER}}/` etc.) or the project workspace. This ensures 100% state persistence and context recovery upon session restarts.
 - **Contract-First Agent Evolution:** Tools and SOPs used by agents must be defined via schemas and contracts first.
 - **Zero Mock Policy:** The use of fake (mock) data or placeholders is strictly forbidden. Every line of code must connect to a real endpoint or a typed contract. (Exception: Controlled mock usage is allowed for external 3rd party services like Stripe, Twilio).
 - **Branded Types Law:** All IDs (UserID, ProjectID, etc.) must be in the "Branded Types" format defined under `packages/shared-types`. Using plain strings or numbers is forbidden.

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun (v0.5.7) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.5.9) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -12,7 +12,12 @@
 
 Agent Enderun, yazılım ekipleri için tasarlanmış, **Anayasal Yönetişim (Constitutional Governance)** ve **Çoklu Ajan Orkestrasyonu (Multi-Agent Orchestration)** sağlayan kurumsal düzeyde bir framework'tür. 
 
-### 🚀 v0.5.7: Persistent Memory & Zero-Temp Governance
+### 🚀 v0.5.9: Adaptive Discovery & Token Economy Protocol
+
+- **Architecture Discovery Protocol (ADP):** Seamlessly ingest and adapt to existing (legacy) projects without rigid directory requirements.
+- **Token Economy & Context Management:** Advanced rules to optimize AI context usage, reducing token costs by up to 40%.
+- **Choice-Based Scaffolding:** Empowering users with consent-driven project setup and architectural blueprints.
+- **Modular MCP Ecosystem:** 30+ enterprise-grade intelligence tools for AST-based analysis and security.
 - **Zero Temporary Storage:** All task logs, plans, and state are strictly saved in persistent workspace directories; OS temp directories are completely forbidden.
 - **Session Memory Recovery:** Non-negotiable automatic first-turn state restoration and role initialization across all adapters.
 
@@ -77,7 +82,7 @@ agent-enderun check
 
 Expected output:
 ```
-✅ Framework active (v0.5.7)
+✅ Framework active (v0.5.8)
 ✅ MCP Server ready
 ✅ Shared types compiled
 ✅ Agent logs initialized
@@ -484,7 +489,7 @@ agent-enderun check
 
 Beklenen çıktı:
 ```
-✅ Framework aktif (v0.5.7)
+✅ Framework aktif (v0.5.8)
 ✅ MCP Sunucu hazır
 ✅ Paylaşılan türler derlenmiş
 ✅ Agent logları başlatılmış

package/bin/update-contract.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+/* global console, process */
+/* eslint-disable no-console */
+
 import fs from "fs";
 import path from "path";
 import crypto from "crypto";

package/claude.md

@@ -2,14 +2,14 @@
 
 This file is the entry point for Claude. The project's "Supreme Law" and all instructions are located in the following file:
 
-👉 **[.claude/ENDERUN.md](.claude/ENDERUN.md)**
+👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
 
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
 ⚠️ **CRITICAL STARTUP REQUIREMENT:**
 At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
-1. You **MUST** read `.claude/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
-2. You **MUST** read `.claude/agents/manager.md` (or the specialist's md file in `.claude/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+1. You **MUST** read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `{{FRAMEWORK_DIR}}/agents/manager.md` (or the specialist's md file in `{{FRAMEWORK_DIR}}/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
 
 Please read the Supreme Law thoroughly before taking any action.

package/codex.md

@@ -2,14 +2,14 @@
 
 This file is the entry point for Codex. The project's "Supreme Law" and all instructions are located in the following file:
 
-👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
+👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
 
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
 ⚠️ **CRITICAL STARTUP REQUIREMENT:**
 At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
-1. You **MUST** read `.enderun/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
-2. You **MUST** read `.enderun/agents/manager.md` (or the specialist's md file in `.enderun/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+1. You **MUST** read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `{{FRAMEWORK_DIR}}/agents/manager.md` (or the specialist's md file in `{{FRAMEWORK_DIR}}/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
 
 Please read the Supreme Law thoroughly before taking any action.

package/cursor.md

@@ -2,14 +2,14 @@
 
 This file is the entry point for Cursor. The project's "Supreme Law" and all instructions are located in the following file:
 
-👉 **[.cursor/ENDERUN.md](.cursor/ENDERUN.md)**
+👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
 
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
 ⚠️ **CRITICAL STARTUP REQUIREMENT:**
 At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
-1. You **MUST** read `.cursor/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
-2. You **MUST** read `.cursor/agents/manager.md` (or the specialist's md file in `.cursor/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+1. You **MUST** read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `{{FRAMEWORK_DIR}}/agents/manager.md` (or the specialist's md file in `{{FRAMEWORK_DIR}}/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
 
 Please read the Supreme Law thoroughly before taking any action.

package/gemini-extension.json

@@ -5,7 +5,9 @@
   "mcpServers": {
     "agent-enderun": {
       "command": "node",
-      "args": ["packages/framework-mcp/dist/index.js"]
+      "args": [
+        "packages/framework-mcp/dist/index.js"
+      ]
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -55,7 +55,7 @@
     "docs"
   ],
   "scripts": {
-    "enderun:build": "npm run build --workspaces --if-present",
+    "enderun:build": "npm run build --prefix packages/shared-types && npm run build --prefix packages/framework-mcp",
     "enderun:test": "vitest run",
     "enderun:test:watch": "vitest",
     "enderun:status": "agent-enderun status",
@@ -76,10 +76,12 @@
     "tsx": "^4.19.4",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.59.3",
-    "vitest": "^3.0.5"
+    "vitest": "^3.0.5",
+    "@pandacss/dev": "^0.53.0"
   },
   "enderun": {
-    "version": "0.5.7",
-    "initializedAt": "2026-05-09T13:24:27.472Z"
-  }
-}
+    "version": "0.5.9",
+    "initializedAt": "2026-05-19T14:23:38.760Z"
+  },
+  "dependencies": {}
+}

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

@@ -83,15 +83,21 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesPath = path.join(projectRoot, "packages/shared-types/src/index.ts");
+            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
             if (!fs.existsSync(apiDocPath))
                 return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
-            if (!fs.existsSync(sharedTypesPath))
-                return { content: [{ type: "text", text: "Shared types index.ts not found." }] };
-            const sourceFile = new Project().addSourceFileAtPath(sharedTypesPath);
-            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g)).map(m => m[1]).filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+            if (!fs.existsSync(sharedTypesDir))
+                return { content: [{ type: "text", text: "Shared types directory not found." }] };
+            const project = new Project();
+            project.addSourceFilesAtPaths(path.join(sharedTypesDir, "**/*.ts"));
+            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g))
+                .map(m => m[1])
+                .filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
             const uniqueTypes = Array.from(new Set(mentionedTypes));
-            const missingTypes = uniqueTypes.filter(t => !sourceFile.getInterface(t) && !sourceFile.getTypeAlias(t) && !sourceFile.getEnum(t) && !sourceFile.getClass(t));
+            const missingTypes = uniqueTypes.filter(t => {
+                const found = project.getSourceFiles().some(sf => sf.getInterface(t) || sf.getTypeAlias(t) || sf.getEnum(t) || sf.getClass(t));
+                return !found;
+            });
             return { content: [{ type: "text", text: `### CONTRACT INTEGRITY SHIELD: ${parsed.data.domain.toUpperCase()}\n\n` + `- **Missing/Undefined Types:** ${missingTypes.length > 0 ? `⚠️ ${missingTypes.join(", ")}` : "✅ All types synchronized"}\n\n` + `**Result:** ${missingTypes.length === 0 ? "PASSED" : "FAILED"}` }] };
         }
         catch (error) {

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

@@ -180,7 +180,8 @@ export const frameworkHandlers = {
             return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK\n\n${output}` }] };
         }
         catch (error) {
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${error.stdout || error.message}` }] };
+            const err = error;
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.stdout || err.message}` }] };
         }
     }
 };

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

@@ -118,7 +118,7 @@ export const knowledgeHandlers = {
                 const label = metadata.title || id;
                 mermaid += `  ${id}["${label}"]\n`;
                 if (metadata.related) {
-                    const related = metadata.related.replace(/[\[\]]/g, "").split(",");
+                    const related = metadata.related.replace(/[[\]]/g, "").split(",");
                     related.forEach((r) => {
                         mermaid += `  ${id} --> ${r.trim().replace(".md", "")}\n`;
                     });

package/packages/framework-mcp/dist/utils.js

@@ -1,6 +1,6 @@
 import path from "path";
 import fs from "fs";
-export const FRAMEWORK_VERSION = "0.5.7";
+export const FRAMEWORK_VERSION = "0.5.9";
 export function getFrameworkDir(projectRoot) {
     const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];
     for (const adp of adapters) {

package/packages/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -25,6 +25,9 @@
     "dist",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "start": "node dist/index.js",

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

@@ -83,13 +83,26 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesPath = path.join(projectRoot, "packages/shared-types/src/index.ts");
+            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+
             if (!fs.existsSync(apiDocPath)) return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
-            if (!fs.existsSync(sharedTypesPath)) return { content: [{ type: "text", text: "Shared types index.ts not found." }] };
-            const sourceFile = new Project().addSourceFileAtPath(sharedTypesPath);
-            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g)).map(m => m[1]).filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+            if (!fs.existsSync(sharedTypesDir)) return { content: [{ type: "text", text: "Shared types directory not found." }] };
+
+            const project = new Project();
+            project.addSourceFilesAtPaths(path.join(sharedTypesDir, "**/*.ts"));
+
+            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g))
+                .map(m => m[1])
+                .filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+
             const uniqueTypes = Array.from(new Set(mentionedTypes));
-            const missingTypes = uniqueTypes.filter(t => !sourceFile.getInterface(t) && !sourceFile.getTypeAlias(t) && !sourceFile.getEnum(t) && !sourceFile.getClass(t));
+            const missingTypes = uniqueTypes.filter(t => {
+                const found = project.getSourceFiles().some(sf => 
+                    sf.getInterface(t) || sf.getTypeAlias(t) || sf.getEnum(t) || sf.getClass(t)
+                );
+                return !found;
+            });
+
             return { content: [{ type: "text", text: `### CONTRACT INTEGRITY SHIELD: ${parsed.data.domain.toUpperCase()}\n\n` + `- **Missing/Undefined Types:** ${missingTypes.length > 0 ? `⚠️ ${missingTypes.join(", ")}` : "✅ All types synchronized"}\n\n` + `**Result:** ${missingTypes.length === 0 ? "PASSED" : "FAILED"}` }] };
         } catch (error) {
             return { content: [{ type: "text", text: "Contract verification failed." }] };

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

@@ -174,8 +174,9 @@ export const frameworkHandlers = {
             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}` }] };
-        } catch (error: any) {
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${error.stdout || error.message}` }] };
+        } 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}` }] };
         }
     }
 };

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

@@ -48,15 +48,15 @@ function parseFrontmatter(content: string) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     if (!match) return { metadata: {}, body: content };
     const yaml = match[1];
-    const metadata: Record<string, any> = {};
+    const metadata: Record<string, string | undefined> = {};
     yaml.split("\n").forEach(line => {
         const [key, ...val] = line.split(":");
         if (key && val.length > 0) metadata[key.trim()] = val.join(":").trim();
     });
     return { metadata, body: content.replace(match[0], "").trim() };
-}
+    }
 
-export const knowledgeHandlers = {
+    export const knowledgeHandlers = {
     search_knowledge_base: async (args: unknown, projectRoot: string) => {
         const parsed = SEARCH_KNOWLEDGE_BASE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid search query." }] };
@@ -64,12 +64,12 @@ export const knowledgeHandlers = {
             const frameworkDir = getFrameworkDir(projectRoot);
             const kbDir = path.join(projectRoot, frameworkDir, "knowledge");
             if (!fs.existsSync(kbDir)) return { content: [{ type: "text", text: "Knowledge base is empty." }] };
-            
+
             const query = parsed.data.query.toLowerCase();
             const results = fs.readdirSync(kbDir).filter(f => f.endsWith(".md")).map(file => {
                 const content = fs.readFileSync(path.join(kbDir, file), "utf-8");
                 const { metadata, body } = parseFrontmatter(content);
-                
+
                 const matchesQuery = body.toLowerCase().includes(query) || 
                                    file.toLowerCase().includes(query) ||
                                    (metadata.tags && metadata.tags.toLowerCase().includes(query)) ||
@@ -127,7 +127,7 @@ export const knowledgeHandlers = {
                 mermaid += `  ${id}["${label}"]\n`;
                 
                 if (metadata.related) {
-                    const related = metadata.related.replace(/[\[\]]/g, "").split(",");
+                    const related = metadata.related.replace(/[[\]]/g, "").split(",");
                     related.forEach((r: string) => {
                         mermaid += `  ${id} --> ${r.trim().replace(".md", "")}\n`;
                     });

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

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs";
 
-export const FRAMEWORK_VERSION = "0.5.7";
+export const FRAMEWORK_VERSION = "0.5.9";
 
 export function getFrameworkDir(projectRoot: string): string {
     const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];

package/packages/shared-types/dist/api.d.ts

@@ -0,0 +1,18 @@
+import { TraceID } from "./brands.js";
+/**
+ * API Response Wrappers
+ */
+export interface ApiResponse<T> {
+    data: T;
+    meta?: {
+        requestId: TraceID;
+        timestamp: string;
+    };
+}
+export interface ApiError {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}

package/packages/shared-types/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/packages/shared-types/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/packages/shared-types/dist/brands.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Branded Type Utility
+ */
+export type Brand<K, T> = K & {
+    __brand: T;
+};
+/**
+ * Entity IDs (Branded)
+ */
+export type TraceID = Brand<string, "TraceID">;
+export type AgentID = Brand<string, "AgentID">;
+export type ProjectID = Brand<string, "ProjectID">;
+export type UserID = Brand<string, "UserID">;

package/packages/shared-types/dist/brands.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=brands.js.map

package/packages/shared-types/dist/brands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brands.js","sourceRoot":"","sources":["../src/brands.ts"],"names":[],"mappings":""}

package/packages/shared-types/dist/constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Project Phases
+ */
+export declare const PROJECT_PHASES: readonly ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+export type ProjectPhase = (typeof PROJECT_PHASES)[number];
+/**
+ * Execution Profiles
+ */
+export declare const EXECUTION_PROFILES: readonly ["Lightweight", "Full"];
+export type ExecutionProfile = (typeof EXECUTION_PROFILES)[number];
+/**
+ * Task Priorities
+ */
+export declare const TASK_PRIORITIES: readonly ["P0", "P1", "P2", "P3"];
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+/**
+ * Task Statuses
+ */
+export declare const TASK_STATUSES: readonly ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+/**
+ * Action Types & Status
+ */
+export declare const ACTION_TYPES: readonly ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"];
+export type ActionType = (typeof ACTION_TYPES)[number];
+export declare const ACTION_STATUSES: readonly ["SUCCESS", "FAILURE", "WAITING"];
+export type ActionStatus = (typeof ACTION_STATUSES)[number];

package/packages/shared-types/dist/constants.js

@@ -0,0 +1,22 @@
+/**
+ * Project Phases
+ */
+export const PROJECT_PHASES = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+/**
+ * Execution Profiles
+ */
+export const EXECUTION_PROFILES = ["Lightweight", "Full"];
+/**
+ * Task Priorities
+ */
+export const TASK_PRIORITIES = ["P0", "P1", "P2", "P3"];
+/**
+ * Task Statuses
+ */
+export const TASK_STATUSES = ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"];
+/**
+ * Action Types & Status
+ */
+export const ACTION_TYPES = ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"];
+export const ACTION_STATUSES = ["SUCCESS", "FAILURE", "WAITING"];
+//# sourceMappingURL=constants.js.map

package/packages/shared-types/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAG/F;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,MAAM,CAAU,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAGjE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGnG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAG/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC"}