agent-enderun 0.4.6 → 0.5.0

package/.enderun/ENDERUN.md

@@ -1,63 +1,63 @@
-# Agent Enderun (v0.4.6)
+# Agent Enderun (v0.5.0)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
 > Check this list at the end of every response:
 > - [ ] **Zero Mock:** Did you use fake data or placeholders? (Strictly Forbidden)
 > - [ ] **Contract First:** Are `shared-types` and `contract.version.json` up to date?
-> - [ ] **Audit Log:** Did you log this action in `.enderun/logs/[agent].json`?
-> - [ ] **CLI Orchestration:** Does the action comply with `gemini cli` rules?
+> - [ ] **Audit Log:** Did you log this action in `{{FRAMEWORK_DIR}}/logs/[agent].json`?
+> - [ ] **CLI Orchestration:** Does the action comply with `{{ADAPTER}} cli` rules?
 > - [ ] **No "..." allowed:** Did you write the code completely without omitting parts?
 
 ---
 
 ## Constitution Status
-This file (`./gemini.md`) and the `.enderun/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 `.enderun/docs/`.
+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/`.
 
 ---
 
 ## STEP 0 — STARTUP (EVERY SESSION, NON-NEGOTIABLE)
 
-1. **Read ./gemini.md First:** Read and fully understand this file before taking any action.
-2. **Check `.enderun/docs/` Folder:** Verify the existence of the `.enderun/docs/` folder (located within the framework directory).
-3. **Absorb Context:** Read `.enderun/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
-4. **Demand Context:** If the `.enderun/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
-5. Default Frontend: React 19 + Vite (SPA) + react-router-dom (User Preference)
+1. **Read ./{{ADAPTER}}.md First:** Read and fully understand this file before taking any action.
+2. **Check `{{FRAMEWORK_DIR}}/docs/` Folder:** Verify the existence of the `{{FRAMEWORK_DIR}}/docs/` folder (located within the framework directory).
+3. **Absorb Context:** Read `{{FRAMEWORK_DIR}}/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
+4. **Demand Context:** If the `{{FRAMEWORK_DIR}}/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
+5. **Mandatory @manager Activation:** You MUST act as `@manager` for the initial response to any new user request.
 
-**NEVER SKIP THIS STEP.** Do not assume context; read first, then act.
+**NEVER SKIP THIS STEP.** Do not assume context; read first, then act as @manager.
 
 ---
 
 ## CORE PRINCIPLES
 
-- **Agent Academy Focus:** This repository is dedicated to the development and evolution of AI Agents. All actions must aim to improve agent intelligence, autonomy, and procedural continuity.
+- **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.
 - **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.
 - **CLI-First Policy:** Due to the AI CLI Assistant focus, all outputs must be user-friendly (using Chalk, Clack, etc.) and stream-based. All commands must support the `--output json` flag and produce machine-readable output.
-- **Audit Logging Necessity:** Every critical action must be logged traceably under the `.enderun/logs/` folder.
+- **Audit Logging Necessity:** Every critical action must be logged traceably under the `{{FRAMEWORK_DIR}}/logs/` folder.
 - **Design Continuity & Response Policy:** All UI changes MUST be responsive (Mobile-First + Fluid) and surgical. Unnecessary overhauls of existing layouts are strictly forbidden.
 - **Shared Component First Policy:** Defining common UI elements (Button, Input, Card, etc.) inside page files is FORBIDDEN. All atomic UI components must be created in a shared directory (e.g., `apps/web/src/components/ui/`) and reused across the project.
 - **File Ownership Rule:** Each file is the responsibility of a single agent.
-- **CLI Command Mapping:** All CLI commands in the project must be defined in the `.enderun/cli-commands.json` file and assigned to the relevant agent.
+- **CLI Command Mapping:** All CLI commands in the project must be defined in the `{{FRAMEWORK_DIR}}/cli-commands.json` file and assigned to the relevant agent.
 - **Exit Code Standard:** Standard exit codes (e.g., 64: User Error, 70: Internal Error) must be used in error situations.
 - **Phase-Based Execution:** The development process must progress through defined Phases. You cannot move to the next phase until the current one is completed.
-- **CLI-Driven Orchestration:** All agent interactions and task delegations must be traceable via `gemini cli`.
+- **CLI-Driven Orchestration:** All agent interactions and task delegations must be traceable via `{{ADAPTER}} cli`.
 - **Monorepo Discipline:** Commands must always be run from the monorepo root directory using npm workspaces (e.g., `npm run dev --workspace=web`).
 
 ---
 
 ## STEP 1 — VALIDATE BEFORE ACTING
 
-Before writing any code or design, check `.enderun/docs/tech-stack.md`:
+Before writing any code or design, check `{{FRAMEWORK_DIR}}/docs/tech-stack.md`:
 
 | Unknown | Action |
 |---|---|
 | Target Audience | Ask — do not proceed |
 | Platform (web / mobile / desktop / backend) | Ask — do not proceed |
-| **Technology Stack** | **Check `.enderun/docs/tech-stack.md` → If missing → ASK** |
+| **Technology Stack** | **Check `{{FRAMEWORK_DIR}}/docs/tech-stack.md` → If missing → ASK** |
 | **Execution Profile (Full / Lightweight)** | **Ask — do not proceed** |
 | Database (MariaDB / SQLite / PostgreSQL) | Ask — do not proceed |
 | Environment (prototype / production) | Ask — do not proceed |
@@ -148,7 +148,7 @@ This file is the single source of truth for API stability. `@backend-architect`
 
 The development process follows a strict State Machine. Transition to the next phase is prohibited until the "Success Criteria" of the current phase is met.
 
-- **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `.enderun/docs/tech-stack.md`.
+- **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `{{FRAMEWORK_DIR}}/docs/tech-stack.md`.
 - **[STATE: PHASE_1] Architecture & Contracts:** Setup of data models, API schemas, and `packages/shared-types`. Cannot proceed until Frontend and Backend approve these schemas.
 - **[STATE: PHASE_2] Core Development:** Active agents build core features in parallel based on the selected profile. (Under the apps/ folder)
 - **[STATE: PHASE_3] Integration & Testing:** System integration.
@@ -166,13 +166,13 @@ Every agent must produce a response for their assigned task within a maximum of
 
 ## CLI STANDARDS & CONFIGURATION
 
-### 1. CLI Command Map (`.enderun/cli-commands.json`)
+### 1. CLI Command Map (`{{FRAMEWORK_DIR}}/cli-commands.json`)
 All CLI commands are centrally managed in this file. Each command must have a designated owner agent.
 
-### 2. Configuration (`.enderun/config.json`)
+### 2. Configuration (`{{FRAMEWORK_DIR}}/config.json`)
 CLI behaviors (logLevel, outputFormat, defaultProfile) are managed through this file.
 
-**Priority Rule:** CLI Flags > `.enderun/config.json` > `.env` > Default Values.
+**Priority Rule:** CLI Flags > `{{FRAMEWORK_DIR}}/config.json` > `.env` > Default Values.
 
 ### 3. Exit Codes
 - `0`: Success
@@ -191,12 +191,12 @@ All APIs are versioned via the URL path (`/api/v1/...`). The `packages/shared-ty
 ## PARALLEL EXECUTION & COORDINATION RULES
 
 1. **Shared-Types as Source of Truth:** All agents reference `packages/shared-types` and the `contract.version.json` file.
-2. **Commit-Level Logging:** Every agent must log every atomic change to the `.enderun/logs/[agent-name].json` file.
+2. **Commit-Level Logging:** Every agent must log every atomic change to the `{{FRAMEWORK_DIR}}/logs/[agent-name].json` file.
 3. **Implicit Dependency Lock:** If an agent's required output is not ready, it switches to `WAITING` state.
 4. **Ownership Enforcement:** Changes to files outside an agent's scope cannot be made without `@team-lead` approval.
-5. **No Blind Coding:** Agents must periodically read `.enderun/logs/` and `.enderun/STATUS.md`.
-6. **Agent Directives (Message Queue):** `.enderun/messages/` is used for inter-agent communication. 
-   - **Message Queue Lock Protocol:** Before writing to a file, check for `.enderun/messages/.lock`.
+5. **No Blind Coding:** Agents must periodically read `{{FRAMEWORK_DIR}}/logs/` and `{{FRAMEWORK_DIR}}/STATUS.md`.
+6. **Agent Directives (Message Queue):** `{{FRAMEWORK_DIR}}/messages/` is used for inter-agent communication. 
+   - **Message Queue Lock Protocol:** Before writing to a file, check for `{{FRAMEWORK_DIR}}/messages/.lock`.
    - If it exists, wait 500ms and retry (max 3 retries).
    - If lock persists after 3 retries, the agent MUST assume a **stale lock**, delete it, and notify `@team-lead` in their log.
    - Delete `.lock` and the message file immediately after processing.

package/ENDERUN.md

@@ -1,12 +1,12 @@
-# Agent Enderun (v0.4.6)
+# Agent Enderun (v0.5.0)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
 > Check this list at the end of every response:
 > - [ ] **Zero Mock:** Did you use fake data or placeholders? (Strictly Forbidden)
 > - [ ] **Contract First:** Are `shared-types` and `contract.version.json` up to date?
-> - [ ] **Audit Log:** Did you log this action in `.enderun/logs/[agent].json`?
-> - [ ] **CLI Orchestration:** Does the action comply with `gemini cli` rules?
+> - [ ] **Audit Log:** Did you log this action in `{{FRAMEWORK_DIR}}/logs/[agent].json`?
+> - [ ] **CLI Orchestration:** Does the action comply with `{{ADAPTER}} cli` rules?
 > - [ ] **No "..." allowed:** Did you write the code completely without omitting parts?
 
 ---
@@ -22,22 +22,22 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 2. **Check `{{FRAMEWORK_DIR}}/docs/` Folder:** Verify the existence of the `{{FRAMEWORK_DIR}}/docs/` folder (located within the framework directory).
 3. **Absorb Context:** Read `{{FRAMEWORK_DIR}}/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
 4. **Demand Context:** If the `{{FRAMEWORK_DIR}}/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
-5. Default Frontend: React 19 + Vite (SPA) + react-router-dom (User Preference)
+5. **Mandatory @manager Activation:** You MUST act as `@manager` for the initial response to any new user request.
 
-**NEVER SKIP THIS STEP.** Do not assume context; read first, then act.
+**NEVER SKIP THIS STEP.** Do not assume context; read first, then act as @manager.
 
 ---
 
 ## CORE PRINCIPLES
 
-- **Team-Lead Default Orchestration:** Whenever the user writes a general request, the `@team-lead` agent MUST automatically step in. The Team Lead is responsible for analyzing the user's intent, determining the Execution Profile (Lightweight or Full), and delegating tasks to the appropriate specialist agents.
+- **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.
 - **Contract-First Approach:** Communication between Backend and Frontend must always be defined via schemas first. The `packages/shared-types/contract.version.json` file must be kept in MAJOR.MINOR format and updated with every change. The `@backend-architect` is responsible for updating this file.
 - **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.
 - **CLI-First Policy:** Due to the AI CLI Assistant focus, all outputs must be user-friendly (using Chalk, Clack, etc.) and stream-based. All commands must support the `--output json` flag and produce machine-readable output.
 - **Audit Logging Necessity:** Every critical action must be logged traceably under the `{{FRAMEWORK_DIR}}/logs/` folder.
 - **File Ownership Rule:** Each file is the responsibility of a single agent.
-- **CLI Command Mapping:** All CLI commands in the project must be defined in the `.enderun/cli-commands.json` file and assigned to the relevant agent.
+- **CLI Command Mapping:** All CLI commands in the project must be defined in the `{{FRAMEWORK_DIR}}/cli-commands.json` file and assigned to the relevant agent.
 - **Exit Code Standard:** Standard exit codes (e.g., 64: User Error, 70: Internal Error) must be used in error situations.
 - **Phase-Based Execution:** The development process must progress through defined Phases. You cannot move to the next phase until the current one is completed.
 - **CLI-Driven Orchestration:** All agent interactions and task delegations must be traceable via `{{ADAPTER}} cli`.
@@ -47,7 +47,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 
 ## STEP 1 — VALIDATE BEFORE ACTING
 
-Before writing any code or design, check `.enderun/docs/tech-stack.md`:
+Before writing any code or design, check `{{FRAMEWORK_DIR}}/docs/tech-stack.md`:
 
 | Unknown | Action |
 |---|---|
@@ -144,7 +144,7 @@ This file is the single source of truth for API stability. `@backend-architect`
 
 The development process follows a strict State Machine. Transition to the next phase is prohibited until the "Success Criteria" of the current phase is met.
 
-- **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `.enderun/docs/tech-stack.md`.
+- **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `{{FRAMEWORK_DIR}}/docs/tech-stack.md`.
 - **[STATE: PHASE_1] Architecture & Contracts:** Setup of data models, API schemas, and `packages/shared-types`. Cannot proceed until Frontend and Backend approve these schemas.
 - **[STATE: PHASE_2] Core Development:** Active agents build core features in parallel based on the selected profile. (Under the apps/ folder)
 - **[STATE: PHASE_3] Integration & Testing:** System integration.
@@ -162,13 +162,13 @@ Every agent must produce a response for their assigned task within a maximum of
 
 ## CLI STANDARDS & CONFIGURATION
 
-### 1. CLI Command Map (`.enderun/cli-commands.json`)
+### 1. CLI Command Map (`{{FRAMEWORK_DIR}}/cli-commands.json`)
 All CLI commands are centrally managed in this file. Each command must have a designated owner agent.
 
-### 2. Configuration (`.enderun/config.json`)
+### 2. Configuration (`{{FRAMEWORK_DIR}}/config.json`)
 CLI behaviors (logLevel, outputFormat, defaultProfile) are managed through this file.
 
-**Priority Rule:** CLI Flags > `.enderun/config.json` > `.env` > Default Values.
+**Priority Rule:** CLI Flags > `{{FRAMEWORK_DIR}}/config.json` > `.env` > Default Values.
 
 ### 3. Exit Codes
 - `0`: Success

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun — v0.4.6
+# 🏛️ Agent Enderun — v0.5.0
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -110,7 +110,7 @@ agent-enderun verify-contract
 
 Agent Enderun consists of **4 integrated layers**:
 
-### Layer 1: Governance (.enderun/)
+### Layer 1: Governance ({{FRAMEWORK_DIR}}/)
 ```
 .enderun/
 ├── ENDERUN.md              ← The "Supreme Law" (read this first!)
@@ -349,7 +349,7 @@ agent-enderun/
 ### Q: Do agents actually understand all this?
 **A:** Yes. Before every action, agents read:
 1. `ENDERUN.md` (the constitution)
-2. `.enderun/PROJECT_MEMORY.md` (project state)
+2. `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` (project state)
 3. `docs/` files (your requirements)
 4. `.enderun/knowledge/` (technical guidelines)
 
@@ -373,7 +373,7 @@ agent-enderun/
 
 ## 🔗 Key Files to Read First
 
-1. **`.enderun/ENDERUN.md`** — The constitution (rules all agents must follow)
+1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — The constitution (rules all agents must follow)
 2. **`.enderun/PROJECT_MEMORY.md`** — Current project state and history
 3. **`docs/tech-stack.md`** — Technology decisions
 4. **`packages/shared-types/src/index.ts`** — The contract (types)
@@ -492,7 +492,7 @@ agent-enderun verify-contract
 
 Agent Enderun **4 entegre katmandan** oluşur:
 
-### Katman 1: Yönetişim (.enderun/)
+### Katman 1: Yönetişim ({{FRAMEWORK_DIR}}/)
 - `ENDERUN.md` — Anayasa (bunu ilk oku!)
 - `PROJECT_MEMORY.md` — Proje durumu
 - `agents/` — 8 ajan rolü tanımları
@@ -597,7 +597,7 @@ agent-enderun/
 ### S: Ajanlar bütün bunları anlıyor mu?
 **C:** Evet. Her işlem öncesi şunları okurlar:
 1. `ENDERUN.md` (anayasa)
-2. `.enderun/PROJECT_MEMORY.md` (proje durumu)
+2. `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md` (proje durumu)
 3. `docs/` dosyaları (gereksinimler)
 4. `.enderun/knowledge/` (teknik rehberler)
 
@@ -617,7 +617,7 @@ agent-enderun/
 
 ## 🔗 Önce Okumanız Gereken Dosyalar
 
-1. **`.enderun/ENDERUN.md`** — Anayasa
+1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — Anayasa
 2. **`.enderun/PROJECT_MEMORY.md`** — Proje durumu
 3. **`docs/tech-stack.md`** — Teknoloji kararları
 4. **`packages/shared-types/src/index.ts`** — Sözleşme (türler)

package/bin/cli.js

@@ -197,16 +197,8 @@ function mergePackageJson(targetPath, sourcePath) {
 function updateGitIgnore(targetPath, frameworkDir = ".enderun") {
   const IGNORE_LINES = [
     "# AI-Enderun",
-    ".enderun/logs/*.json",
-    ".claude/logs/*.json",
-    ".cursor/logs/*.json",
-    ".codex/logs/*.json",
-    ".enderun/logs/*.json",
-    ".enderun/*.lock",
-    ".claude/*.lock",
-    ".cursor/*.lock",
-    ".codex/*.lock",
-    ".enderun/*.lock",
+    `${frameworkDir}/logs/*.json`,
+    `${frameworkDir}/*.lock`,
     ".env",
     ".DS_Store"
   ];

package/claude.md

@@ -2,6 +2,9 @@
 
 This file is the entry point for Claude. 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)**
 
-Please read that file thoroughly before taking any action.
+### 🤖 AGENT DIRECTIVE
+You MUST act as the `@manager` (Team-Lead) for the initial response to any user request. You are responsible for analysis and delegation.
+
+Please read the Supreme Law thoroughly before taking any action.

package/codex.md

@@ -2,6 +2,9 @@
 
 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)**
 
-Please read that file thoroughly before taking any action.
+### 🤖 AGENT DIRECTIVE
+You MUST act as the `@manager` (Team-Lead) for the initial response to any user request. You are responsible for analysis and delegation.
+
+Please read the Supreme Law thoroughly before taking any action.

package/cursor.md

@@ -2,6 +2,9 @@
 
 This file is the entry point for Cursor. 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)**
 
-Please read that file thoroughly before taking any action.
+### 🤖 AGENT DIRECTIVE
+You MUST act as the `@manager` (Team-Lead) for the initial response to any user request. You are responsible for analysis and delegation.
+
+Please read the Supreme Law thoroughly before taking any action.

package/gemini-extension.json

@@ -1,5 +1,5 @@
 {
   "name": "Agent Enderun",
   "description": "Enterprise-grade AI orchestration framework for software teams.",
-  "instructions": ".enderun/ENDERUN.md"
+  "instructions": "{{FRAMEWORK_DIR}}/ENDERUN.md"
 }

package/gemini.md

@@ -2,6 +2,9 @@
 
 This file is the entry point for Gemini. 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)**
 
-Please read that file thoroughly before taking any action.
+### 🤖 AGENT DIRECTIVE
+You MUST act as the `@manager` (Team-Lead) for the initial response to any user request. You are responsible for analysis and delegation.
+
+Please read the Supreme Law thoroughly before taking any action.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -61,22 +61,24 @@
     "enderun:trace": "agent-enderun trace:new",
     "enderun:verify": "agent-enderun verify-contract",
     "enderun:check": "agent-enderun check",
+    "lint": "eslint .",
     "clean": "rm -rf node_modules packages/*/node_modules apps/*/node_modules packages/*/dist apps/*/dist"
   },
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {},
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@types/node": "^22.13.4",
-    "typescript": "^5.9.3",
-    "tsx": "^4.19.4",
-    "vitest": "^3.0.5",
+    "concurrently": "^9.1.2",
     "eslint": "^9.20.1",
-    "concurrently": "^9.1.2"
+    "tsx": "^4.19.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.3",
+    "vitest": "^3.0.5"
   },
   "enderun": {
-    "version": "0.4.6",
+    "version": "0.5.0",
     "initializedAt": "2026-05-09T13:24:27.472Z"
   }
-}
+}

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

@@ -2,9 +2,10 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { allTools, allHandlers } from "./tools/index.js";
+import { FRAMEWORK_VERSION } from "./utils.js";
 const server = new Server({
     name: "ai-enderun-mcp",
-    version: "0.3.4",
+    version: FRAMEWORK_VERSION,
 }, {
     capabilities: {
         tools: {},

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

@@ -57,7 +57,9 @@ export const memoryHandlers = {
                         updated = true;
                         break;
                     }
-                    catch (e) { }
+                    catch (e) {
+                        // Ignore section not found
+                    }
                 }
                 if (!updated)
                     throw new Error("HISTORY section not found.");

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

@@ -40,7 +40,7 @@ export const messageHandlers = {
             if (!fs.existsSync(messagesDir))
                 fs.mkdirSync(messagesDir, { recursive: true });
             const messagePath = path.join(messagesDir, `${recipient}.json`);
-            let messages = fs.existsSync(messagePath) ? JSON.parse(fs.readFileSync(messagePath, "utf-8")) : [];
+            const messages = (fs.existsSync(messagePath) ? JSON.parse(fs.readFileSync(messagePath, "utf-8")) : []);
             messages.push({ timestamp: new Date().toISOString(), from: "manager", traceId: parsed.data.traceId, content: parsed.data.message, read: false });
             fs.writeFileSync(messagePath, JSON.stringify(messages, null, 2));
             return { content: [{ type: "text", text: `Message sent to @${recipient}.` }] };

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

@@ -62,8 +62,12 @@ export const repositoryHandlers = {
                 if (relativePath.includes("node_modules") || relativePath.includes("dist"))
                     continue;
                 sourceFile.getExportedDeclarations().forEach((declarations, name) => {
-                    declarations.forEach(decl => { if (typeof decl.getJsDocs === "function" && decl.getJsDocs().length === 0)
-                        missingJSDoc.push(`${relativePath} -> ${name}`); });
+                    declarations.forEach(decl => {
+                        const d = decl;
+                        if (typeof d.getJsDocs === "function" && d.getJsDocs().length === 0) {
+                            missingJSDoc.push(`${relativePath} -> ${name}`);
+                        }
+                    });
                 });
             }
             const majorDirs = ["apps/backend", "apps/web", "packages/shared-types", "packages/framework-mcp"], missingREADME = majorDirs.filter(dir => fs.existsSync(path.join(projectRoot, dir)) && !fs.existsSync(path.join(projectRoot, dir, "README.md")));

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

@@ -1,6 +1,6 @@
 import path from "path";
 import fs from "fs";
-export const FRAMEWORK_VERSION = "0.3.4";
+export const FRAMEWORK_VERSION = "0.5.0";
 export function getFrameworkDir(projectRoot) {
     const adapters = [".gemini", ".claude", ".cursor", ".codex", ".enderun"];
     for (const adp of adapters) {
@@ -71,7 +71,7 @@ export function collectMarkdownArtifacts(projectRoot) {
 }
 export function replaceSectionContent(markdown, sectionTitle, newBody) {
     const escaped = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`, "m");
+    const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`);
     if (!sectionRegex.test(markdown)) {
         throw new Error(`Section not found: ${sectionTitle}`);
     }
@@ -79,7 +79,7 @@ export function replaceSectionContent(markdown, sectionTitle, newBody) {
 }
 export function prependToSection(markdown, sectionTitle, contentToPrepend) {
     const escaped = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const sectionRegex = new RegExp(`(## ${escaped}\\n)([\\s\\S]*?)(?=\\n## |$)`, "m");
+    const sectionRegex = new RegExp(`(## ${escaped}\\n)([\\s\\S]*?)(?=\\n## |$)`);
     const match = markdown.match(sectionRegex);
     if (!match) {
         throw new Error(`Section not found: ${sectionTitle}`);

package/packages/framework-mcp/package.json

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

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

@@ -2,10 +2,11 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { allTools, allHandlers } from "./tools/index.js";
+import { FRAMEWORK_VERSION } from "./utils.js";
 
 const server = new Server({
     name: "ai-enderun-mcp",
-    version: "0.3.4",
+    version: FRAMEWORK_VERSION,
 }, {
     capabilities: {
         tools: {},

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

@@ -89,8 +89,14 @@ export const academyTools = [
     },
 ];
 
+interface AgentLog {
+    timestamp: string;
+    status: string;
+    [key: string]: unknown;
+}
+
 export const academyHandlers = {
-    get_academy_performance: async (args: any, projectRoot: string) => {
+    get_academy_performance: async (args: unknown, projectRoot: string) => {
         const parsed = GET_ACADEMY_PERFORMANCE_ARGS_SCHEMA.safeParse(args ?? {});
         const days = parsed.success ? parsed.data.periodDays : 30;
         try {
@@ -100,8 +106,8 @@ export const academyHandlers = {
             const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
             let totalActions = 0, totalSuccess = 0;
             const agentStats = fs.readdirSync(logsDir).filter(f => f.endsWith(".json")).map(file => {
-                const logs = JSON.parse(fs.readFileSync(path.join(logsDir, file), "utf-8")).filter((l: any) => new Date(l.timestamp) >= cutoff);
-                const success = logs.filter((l: any) => l.status === "SUCCESS").length;
+                const logs = (JSON.parse(fs.readFileSync(path.join(logsDir, file), "utf-8")) as AgentLog[]).filter((l) => new Date(l.timestamp) >= cutoff);
+                const success = logs.filter((l) => l.status === "SUCCESS").length;
                 totalActions += logs.length; totalSuccess += success;
                 return { agent: file.replace(".json", ""), actions: logs.length, successRate: (success / (logs.length || 1)) * 100 };
             }).filter(s => s.actions > 0);
@@ -110,15 +116,15 @@ export const academyHandlers = {
             return { content: [{ type: "text", text: "Failed to generate global performance report." }] };
         }
     },
-    generate_strategic_briefing: async (args: any, projectRoot: string) => {
+    generate_strategic_briefing: async (args: unknown, projectRoot: string) => {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const logsDir = path.join(projectRoot, frameworkDir, "logs");
             let totalActions = 0, successCount = 0;
             if (fs.existsSync(logsDir)) {
                 fs.readdirSync(logsDir).filter(f => f.endsWith(".json")).forEach(file => {
-                    const logs = JSON.parse(fs.readFileSync(path.join(logsDir, file), "utf-8"));
-                    totalActions += logs.length; successCount += logs.filter((l: any) => l.status === "SUCCESS").length;
+                    const logs = JSON.parse(fs.readFileSync(path.join(logsDir, file), "utf-8")) as AgentLog[];
+                    totalActions += logs.length; successCount += logs.filter((l) => l.status === "SUCCESS").length;
                 });
             }
             const successRate = (successCount / (totalActions || 1)) * 100;
@@ -127,7 +133,7 @@ export const academyHandlers = {
             return { content: [{ type: "text", text: "Strategic briefing generation failed." }] };
         }
     },
-    generate_academy_progress_report: async (args: any, projectRoot: string) => {
+    generate_academy_progress_report: async (args: unknown, projectRoot: string) => {
         const parsed = GENERATE_ACADEMY_PROGRESS_REPORT_ARGS_SCHEMA.safeParse(args ?? {});
         const days = parsed.success ? parsed.data.days : 7;
         try {
@@ -141,7 +147,7 @@ export const academyHandlers = {
             return { content: [{ type: "text", text: "Failed to generate progress report." }] };
         }
     },
-    get_agent_audit_report: async (args: any, projectRoot: string) => {
+    get_agent_audit_report: async (args: unknown, projectRoot: string) => {
         const parsed = GET_AGENT_AUDIT_REPORT_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid agent or days argument." }] };
         try {
@@ -149,14 +155,14 @@ export const academyHandlers = {
             const logPath = path.join(projectRoot, frameworkDir, "logs", `${parsed.data.agent}.json`);
             if (!fs.existsSync(logPath)) return { content: [{ type: "text", text: `No logs found for agent: ${parsed.data.agent}` }] };
             const cutoff = new Date(Date.now() - parsed.data.days * 24 * 60 * 60 * 1000);
-            const logs = JSON.parse(fs.readFileSync(logPath, "utf-8")).filter((l: any) => new Date(l.timestamp) >= cutoff);
-            const successCount = logs.filter((l: any) => l.status === "SUCCESS").length;
+            const logs = (JSON.parse(fs.readFileSync(logPath, "utf-8")) as AgentLog[]).filter((l) => new Date(l.timestamp) >= cutoff);
+            const successCount = logs.filter((l) => l.status === "SUCCESS").length;
             return { content: [{ type: "text", text: `### AGENT AUDIT REPORT: ${parsed.data.agent.toUpperCase()}\n\n- **Total Actions:** ${logs.length}\n- **Success Rate:** ${((successCount / (logs.length || 1)) * 100).toFixed(1)}%` }] };
         } catch (error) {
             return { content: [{ type: "text", text: "Failed to generate audit report." }] };
         }
     },
-    log_agent_action: async (args: any, projectRoot: string) => {
+    log_agent_action: async (args: unknown, projectRoot: string) => {
         const parsed = LOG_AGENT_ACTION_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid arguments for log_agent_action." }] };
         try {

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

@@ -134,7 +134,7 @@ export const codebaseTools = [
 ];
 
 export const codebaseHandlers = {
-    search_codebase: async (args: any, projectRoot: string) => {
+    search_codebase: async (args: unknown, projectRoot: string) => {
         const parsed = SEARCH_CODEBASE_ARGS_SCHEMA.safeParse(args);
         if (!parsed.success) {
             return { content: [{ type: "text", text: "Invalid query/extension argument." }] };
@@ -168,7 +168,7 @@ export const codebaseHandlers = {
             return { content: [{ type: "text", text: "Search failed." }] };
         }
     },
-    analyze_dependencies: async (args: any, projectRoot: string) => {
+    analyze_dependencies: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_DEPENDENCIES_ARGS_SCHEMA.safeParse(args);
         if (!parsed.success) {
             return { content: [{ type: "text", text: "Invalid path argument." }] };
@@ -198,7 +198,7 @@ export const codebaseHandlers = {
             return { content: [{ type: "text", text: "Analysis failed: " + (error instanceof Error ? error.message : String(error)) }] };
         }
     },
-    analyze_codebase_intelligence: async (args: any, projectRoot: string) => {
+    analyze_codebase_intelligence: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_CODEBASE_INTELLIGENCE_ARGS_SCHEMA.safeParse(args);
         const targetPath = parsed.success ? parsed.data.path : ".";
         try {
@@ -227,7 +227,7 @@ export const codebaseHandlers = {
             return { content: [{ type: "text", text: "Intelligence scan failed." }] };
         }
     },
-    analyze_procedural_continuity: async (args: any, projectRoot: string) => {
+    analyze_procedural_continuity: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_PROCEDURAL_CONTINUITY_ARGS_SCHEMA.safeParse(args);
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid targetPath or referencePath." }] };
         try {
@@ -251,7 +251,7 @@ export const codebaseHandlers = {
             return { content: [{ type: "text", text: "Continuity analysis failed." }] };
         }
     },
-    generate_dependency_graph: async (args: any, projectRoot: string) => {
+    generate_dependency_graph: async (args: unknown, projectRoot: string) => {
         const parsed = GENERATE_DEPENDENCY_GRAPH_ARGS_SCHEMA.safeParse(args);
         const targetPath = parsed.success ? parsed.data.path : "src";
         const format = parsed.success ? parsed.data.format : "mermaid";

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

@@ -36,7 +36,7 @@ export const contractTools = [
 ];
 
 export const contractHandlers = {
-    verify_api_contract: async (args: any, projectRoot: string) => {
+    verify_api_contract: async (args: unknown, projectRoot: string) => {
         try {
             const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
             const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
@@ -51,7 +51,7 @@ export const contractHandlers = {
             return { content: [{ type: "text", text: "Failed to verify contract." }] };
         }
     },
-    update_contract_hash: async (args: any, projectRoot: string) => {
+    update_contract_hash: async (args: unknown, projectRoot: string) => {
         try {
             const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
             const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
@@ -70,7 +70,7 @@ export const contractHandlers = {
             return { content: [{ type: "text", text: "Failed to update contract hash." }] };
         }
     },
-    verify_contract_integrity: async (args: any, projectRoot: string) => {
+    verify_contract_integrity: async (args: unknown, projectRoot: string) => {
         const parsed = VERIFY_CONTRACT_INTEGRITY_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid domain argument." }] };
         try {

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

@@ -18,7 +18,7 @@ export const databaseTools = [
 ];
 
 export const databaseHandlers = {
-    analyze_database_schema: async (args: any, projectRoot: string) => {
+    analyze_database_schema: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_DATABASE_SCHEMA_ARGS_SCHEMA.safeParse(args ?? {});
         const targetPath = parsed.success ? parsed.data.path : "apps/backend";
         try {

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

@@ -45,7 +45,7 @@ export const frameworkTools = [
 ];
 
 export const frameworkHandlers = {
-    bootstrap_legacy_memory: async (args: any, projectRoot: string) => {
+    bootstrap_legacy_memory: async (args: unknown, projectRoot: string) => {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
@@ -71,7 +71,7 @@ export const frameworkHandlers = {
             return { content: [{ type: "text", text: "Failed to bootstrap legacy memory." }] };
         }
     },
-    get_framework_status: async (args: any, projectRoot: string) => {
+    get_framework_status: async (args: unknown, projectRoot: string) => {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
@@ -86,7 +86,7 @@ export const frameworkHandlers = {
             return { content: [{ type: "text", text: "Framework active. Memory unreadable." }] };
         }
     },
-    get_project_gaps: async (args: any, projectRoot: string) => {
+    get_project_gaps: async (args: unknown, projectRoot: string) => {
         const missing: string[] = [];
         const frameworkDir = getFrameworkDir(projectRoot);
         const checkPaths = [
@@ -121,7 +121,7 @@ export const frameworkHandlers = {
         }
         return { content: [{ type: "text", text: missing.length > 0 ? `Detected Gaps:\n${missing.join("\n")}` : "No structural gaps detected based on core standards." }] };
     },
-    get_memory_insights: async (args: any, projectRoot: string) => {
+    get_memory_insights: async (args: unknown, projectRoot: string) => {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");
@@ -138,7 +138,7 @@ export const frameworkHandlers = {
             return { content: [{ type: "text", text: "Failed to gather memory insights." }] };
         }
     },
-    codebase_context: async (args: any, projectRoot: string) => {
+    codebase_context: async (args: unknown, projectRoot: string) => {
         try {
             const artifacts = collectMarkdownArtifacts(projectRoot);
             const frameworkDir = getFrameworkDir(projectRoot);

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

@@ -17,7 +17,7 @@ export const gitTools = [
 ];
 
 export const gitHandlers = {
-    generate_semantic_commit_message: async (args: any, projectRoot: string) => {
+    generate_semantic_commit_message: async (args: unknown, projectRoot: string) => {
         const parsed = GENERATE_SEMANTIC_COMMIT_MESSAGE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid traceId argument." }] };
         try {

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

@@ -24,7 +24,7 @@ export const allTools = [
     ...repositoryTools,
 ];
 
-export const allHandlers: Record<string, (args: any, projectRoot: string) => Promise<any>> = {
+export const allHandlers: Record<string, (args: unknown, projectRoot: string) => Promise<unknown>> = {
     ...codebaseHandlers,
     ...frameworkHandlers,
     ...securityHandlers,

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

@@ -33,7 +33,7 @@ export const knowledgeTools = [
 ];
 
 export const knowledgeHandlers = {
-    search_knowledge_base: async (args: any, projectRoot: string) => {
+    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." }] };
         try {
@@ -52,7 +52,7 @@ export const knowledgeHandlers = {
             return { content: [{ type: "text", text: "Knowledge base search failed." }] };
         }
     },
-    update_knowledge_base: async (args: any, projectRoot: string) => {
+    update_knowledge_base: async (args: unknown, projectRoot: string) => {
         const parsed = UPDATE_KNOWLEDGE_BASE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid topic or content." }] };
         try {

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

@@ -35,7 +35,7 @@ export const memoryTools = [
 ];
 
 export const memoryHandlers = {
-    update_project_memory: async (args: any, projectRoot: string) => {
+    update_project_memory: async (args: unknown, projectRoot: string) => {
         const parsed = UPDATE_MEMORY_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid section or content." }] };
         const { section, content } = parsed.data;
@@ -59,7 +59,9 @@ export const memoryHandlers = {
                         memoryContent = prependToSection(memoryContent, h, content);
                         updated = true;
                         break;
-                    } catch (e) {}
+                    } catch (e) {
+                        // Ignore section not found
+                    }
                 }
                 if (!updated) throw new Error("HISTORY section not found.");
             } else if (section === "CURRENT STATUS") {
@@ -75,7 +77,7 @@ export const memoryHandlers = {
             return { content: [{ type: "text", text: `Memory update failed: ${error instanceof Error ? error.message : "Unknown error"}` }] };
         }
     },
-    read_project_memory: async (args: any, projectRoot: string) => {
+    read_project_memory: async (args: unknown, projectRoot: string) => {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const memoryPath = path.join(projectRoot, frameworkDir, "PROJECT_MEMORY.md");

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

@@ -33,8 +33,16 @@ export const messageTools = [
     },
 ];
 
+interface Message {
+    timestamp: string;
+    from: string;
+    traceId: string;
+    content: string;
+    read: boolean;
+}
+
 export const messageHandlers = {
-    send_agent_message: async (args: any, projectRoot: string) => {
+    send_agent_message: async (args: unknown, projectRoot: string) => {
         const parsed = SEND_AGENT_MESSAGE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid message arguments." }] };
         try {
@@ -43,7 +51,7 @@ export const messageHandlers = {
             const messagesDir = path.join(projectRoot, frameworkDir, "messages");
             if (!fs.existsSync(messagesDir)) fs.mkdirSync(messagesDir, { recursive: true });
             const messagePath = path.join(messagesDir, `${recipient}.json`);
-            let messages = fs.existsSync(messagePath) ? JSON.parse(fs.readFileSync(messagePath, "utf-8")) : [];
+            const messages = (fs.existsSync(messagePath) ? JSON.parse(fs.readFileSync(messagePath, "utf-8")) : []) as Message[];
             messages.push({ timestamp: new Date().toISOString(), from: "manager", traceId: parsed.data.traceId, content: parsed.data.message, read: false });
             fs.writeFileSync(messagePath, JSON.stringify(messages, null, 2));
             return { content: [{ type: "text", text: `Message sent to @${recipient}.` }] };
@@ -51,7 +59,7 @@ export const messageHandlers = {
             return { content: [{ type: "text", text: "Failed to send message." }] };
         }
     },
-    read_agent_messages: async (args: any, projectRoot: string) => {
+    read_agent_messages: async (args: unknown, projectRoot: string) => {
         const parsed = READ_AGENT_MESSAGES_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid agent name." }] };
         try {
@@ -59,10 +67,10 @@ export const messageHandlers = {
             const agentName = parsed.data.agent.replace(/^@/, "");
             const messagePath = path.join(projectRoot, frameworkDir, "messages", `${agentName}.json`);
             if (!fs.existsSync(messagePath)) return { content: [{ type: "text", text: "No messages found." }] };
-            const messages = JSON.parse(fs.readFileSync(messagePath, "utf-8"));
-            const unread = messages.filter((m: any) => !m.read);
-            fs.writeFileSync(messagePath, JSON.stringify(messages.map((m: any) => ({ ...m, read: true })), null, 2));
-            return { content: [{ type: "text", text: unread.length === 0 ? "No new messages." : `### INBOX: @${agentName}\n\n` + unread.map((m: any) => `- **From:** ${m.from}\n  **Message:** ${m.content}`).join("\n\n") }] };
+            const messages = JSON.parse(fs.readFileSync(messagePath, "utf-8")) as Message[];
+            const unread = messages.filter((m) => !m.read);
+            fs.writeFileSync(messagePath, JSON.stringify(messages.map((m) => ({ ...m, read: true })), null, 2));
+            return { content: [{ type: "text", text: unread.length === 0 ? "No new messages." : `### INBOX: @${agentName}\n\n` + unread.map((m) => `- **From:** ${m.from}\n  **Message:** ${m.content}`).join("\n\n") }] };
         } catch (error) {
             return { content: [{ type: "text", text: "Failed to read messages." }] };
         }

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

@@ -35,7 +35,7 @@ export const repositoryTools = [
 ];
 
 export const repositoryHandlers = {
-    validate_repository_health: async (args: any, projectRoot: string) => {
+    validate_repository_health: async (args: unknown, projectRoot: string) => {
         const parsed = VALIDATE_REPOSITORY_HEALTH_ARGS_SCHEMA.safeParse(args ?? {});
         const scope = parsed.success ? parsed.data.scope : "full";
         try {
@@ -52,7 +52,7 @@ export const repositoryHandlers = {
             return { content: [{ type: "text", text: "Health validation failed." }] };
         }
     },
-    analyze_documentation_debt: async (args: any, projectRoot: string) => {
+    analyze_documentation_debt: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_DOCUMENTATION_DEBT_ARGS_SCHEMA.safeParse(args ?? {});
         const targetPath = parsed.success ? parsed.data.path : ".";
         try {
@@ -64,7 +64,12 @@ export const repositoryHandlers = {
                 const relativePath = path.relative(projectRoot, sourceFile.getFilePath());
                 if (relativePath.includes("node_modules") || relativePath.includes("dist")) continue;
                 sourceFile.getExportedDeclarations().forEach((declarations, name) => {
-                    declarations.forEach(decl => { if (typeof (decl as any).getJsDocs === "function" && (decl as any).getJsDocs().length === 0) missingJSDoc.push(`${relativePath} -> ${name}`); });
+                    declarations.forEach(decl => { 
+                        const d = decl as unknown as { getJsDocs?: () => unknown[] };
+                        if (typeof d.getJsDocs === "function" && d.getJsDocs().length === 0) {
+                            missingJSDoc.push(`${relativePath} -> ${name}`);
+                        }
+                    });
                 });
             }
             const majorDirs = ["apps/backend", "apps/web", "packages/shared-types", "packages/framework-mcp"], missingREADME = majorDirs.filter(dir => fs.existsSync(path.join(projectRoot, dir)) && !fs.existsSync(path.join(projectRoot, dir, "README.md")));

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

@@ -43,7 +43,7 @@ export const securityTools = [
 ];
 
 export const securityHandlers = {
-    security_audit_scan: async (args: any, projectRoot: string) => {
+    security_audit_scan: async (args: unknown, projectRoot: string) => {
         const parsed = SECURITY_AUDIT_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid path argument." }] };
         const vulnerabilities: string[] = [];
@@ -86,7 +86,7 @@ export const securityHandlers = {
             return { content: [{ type: "text", text: "Security scan failed." }] };
         }
     },
-    analyze_constitution_compliance: async (args: any, projectRoot: string) => {
+    analyze_constitution_compliance: async (args: unknown, projectRoot: string) => {
         const parsed = ANALYZE_CONSTITUTION_COMPLIANCE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid path argument." }] };
         try {

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

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs";
 
-export const FRAMEWORK_VERSION = "0.4.6";
+export const FRAMEWORK_VERSION = "0.5.0";
 
 export function getFrameworkDir(projectRoot: string): string {
     const adapters = [".gemini", ".claude", ".cursor", ".codex", ".enderun"];
@@ -79,7 +79,7 @@ export function collectMarkdownArtifacts(projectRoot: string): string[] {
 
 export function replaceSectionContent(markdown: string, sectionTitle: string, newBody: string): string {
     const escaped = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`, "m");
+    const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`);
     if (!sectionRegex.test(markdown)) {
         throw new Error(`Section not found: ${sectionTitle}`);
     }
@@ -88,7 +88,7 @@ export function replaceSectionContent(markdown: string, sectionTitle: string, ne
 
 export function prependToSection(markdown: string, sectionTitle: string, contentToPrepend: string): string {
     const escaped = sectionTitle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const sectionRegex = new RegExp(`(## ${escaped}\\n)([\\s\\S]*?)(?=\\n## |$)`, "m");
+    const sectionRegex = new RegExp(`(## ${escaped}\\n)([\\s\\S]*?)(?=\\n## |$)`);
     const match = markdown.match(sectionRegex);
     if (!match) {
         throw new Error(`Section not found: ${sectionTitle}`);

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-enderun/shared-types",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "author": "Yusuf BEKAR",
   "license": "MIT",