agent-enderun 0.4.7 → 0.5.1

package/.enderun/PROJECT_MEMORY.md

@@ -6,10 +6,12 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 | Active Phase | Profile | Last Update | Active Trace ID | Blockers |
 | :----------- | :------ | :---------- | :-------------- | :------- |
-| PHASE_0      | Lightweight | 2026-05-12 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
+| PHASE_0      | Lightweight | 2026-05-15 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
 
 ## PROJECT DEFINITION
 
+- **Name:** Agent Enderun
+- **Version:** v0.5.1
 | Field | Value |
 | :--- | :--- |
 | Project Name | agent-enderun |
@@ -49,6 +51,18 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 ## HISTORY (Persistent Memory)
 
+### 2026-05-15 — The Academy Upgrade & v0.5.1 Release
+
+- **Agent:** @manager
+- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
+- **Action:** Major framework upgrade (v0.5.1). Implemented Hermes Messaging Protocol and Obsidian-style LLM Wiki with YAML metadata. Consolidated constitution into root `ENDERUN.md` and removed legacy `jest.config.js`. Enhanced MCP server with new intelligence tools for knowledge graphs and system health.
+
+### 2026-05-15 — Hermes + Obsidian + LLM Wiki & Discovery
+
+- **Agent:** @manager
+- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
+- **Action:** Major upgrade to framework intelligence. Implemented Hermes Messaging Protocol for inter-agent orchestration and Obsidian-style structured Wiki for knowledge management. Unified versioning across all packages to v0.5.0.
+
 ### 2026-05-12 — The Installation Fix & v0.4.5 Release
 +
 +- **Agent:** @manager

package/.enderun/docs/tech-stack.md

@@ -1,10 +1,38 @@
-# TECH STACK
-
-| Layer | Technology |
-| :--- | :--- |
-| Frontend | React 19 + Vite (SPA) |
-| Styling | Panda CSS |
-| Backend | Node.js (Fastify/Hono) |
-| Database | PostgreSQL (Kysely) |
-| Architecture | Contract-First (Shared Types) |
-| AI Adapter | Gemini / Claude / Cursor |
+# TECH STACK & ARCHITECTURE
+
+## Core Technologies
+
+| Layer | Technology | Description |
+| :--- | :--- | :--- |
+| **Frontend** | React 19 + Vite (SPA) | Modern, fast, and scalable UI layer. |
+| **Styling** | Panda CSS | Type-safe, zero-runtime CSS-in-JS for high performance. |
+| **Backend** | Node.js (Fastify/Hono) | High-performance, schema-driven backend architecture. |
+| **Database** | PostgreSQL (Kysely) | Type-safe SQL builder for robust data management. |
+| **Orchestration** | Agent Enderun (v0.5.0) | Multi-agent autonomous governance framework. |
+
+## Architectural Patterns
+
+- **Contract-First Development:** All API and data models are defined in `packages/shared-types` before implementation.
+- **Branded Types Law:** All unique identifiers must be branded to prevent type-collision and runtime errors.
+- **Zero Mock Policy:** Real integration with database/services is preferred over fragile mocks (except for external 3rd-party APIs).
+- **Phase-Based Execution:** Development follows a strict state machine (Discovery → Architecture → Core → Integration → Optimization).
+
+## MCP Framework Intelligence
+
+The project uses a modular Model Context Protocol (MCP) server for agent tooling:
+- **Codebase:** Intelligence, dependency graphs, and AST-based search.
+- **Security:** Automated audits and constitution compliance scanning.
+- **Academy:** Strategic briefing, performance metrics, and agent memory.
+- **Hermes:** Standardized inter-agent messaging protocol.
+- **Knowledge:** Structured Obsidian-style Wiki for persistent technical context.
+
+## Monorepo Structure
+
+```text
+/
+├── apps/               # Production applications (web, backend, etc.)
+├── packages/           # Shared libraries
+│   ├── shared-types/   # Single source of truth for types
+│   └── framework-mcp/  # Core MCP tools and logic
+└── .enderun/           # Governance, memory, and logs
+```

package/.enderun/knowledge/branded_types_pattern.md

@@ -1 +1,8 @@
+---
+title: Branded Types Pattern
+tags: [architecture, typescript, security]
+related: [api_design_rules]
+last_updated: 2026-05-15
+---
+
 To ensure type safety, use Branded Types for all IDs. Example: export type UserID = Brand<string, 'UserID'>. This prevents using a raw string where a specific ID is expected.

package/.enderun/knowledge/hermes_protocol.md

@@ -0,0 +1,59 @@
+# 📡 Hermes Messaging Protocol
+
+The Hermes protocol defines the standardized way for Agent Enderun specialized agents to communicate, delegate tasks, and share state updates.
+
+---
+
+## 🏗️ Message Structure
+
+Every message sent via `send_agent_message` must follow this conceptual structure (enforced by the MCP tool):
+
+```json
+{
+  "timestamp": "ISO-8601",
+  "from": "@agent_name",
+  "to": "@agent_name",
+  "category": "ACTION | DELEGATION | INFO | ALERT",
+  "priority": "LOW | MEDIUM | HIGH | URGENT",
+  "traceId": "ULID",
+  "content": "Message content",
+  "status": "PENDING | READ | ACKNOWLEDGED | COMPLETED"
+}
+```
+
+---
+
+## 📂 Message Categories
+
+| Category | Usage | Expectation |
+| :--- | :--- | :--- |
+| **ACTION** | Requesting a specific action (e.g., "Run security scan"). | Must be acknowledged and logged in `STATUS.md`. |
+| **DELEGATION** | Handing off a sub-task (e.g., "@backend, create the schema"). | Becomes the primary task for the recipient. |
+| **INFO** | Sharing architectural decisions or updates. | No direct action required, but must be read. |
+| **ALERT** | Critical blockers or security violations. | Immediate attention required by `@manager`. |
+
+---
+
+## 🚦 Priority Levels
+
+- **URGENT:** Must be handled in the current turn.
+- **HIGH:** Top of the queue for the next turn.
+- **MEDIUM:** Standard task priority (Default).
+- **LOW:** Non-critical background updates.
+
+---
+
+## 🔄 Lifecycle Protocol
+
+1.  **Dispatch:** Agent calls `send_agent_message`. Message is saved in `{{FRAMEWORK_DIR}}/messages/recipient.json`.
+2.  **Notification:** The recipient agent checks their inbox during their turn via `read_agent_messages`.
+3.  **Acknowledgment:** For `ACTION` or `DELEGATION`, the recipient should send an `INFO` message back once started or completed.
+4.  **Logging:** All critical communications must be summarized in the agent's log file (`{{FRAMEWORK_DIR}}/logs/agent.json`).
+
+---
+
+## 🛡️ Hermes Safety Rules
+
+- **No circular delegation:** Agent A cannot delegate X to Agent B if B delegated Y (a dependency of X) to A.
+- **Trace ID Integrity:** Every message MUST include a valid `traceId` from `PROJECT_MEMORY.md`.
+- **Atomic Content:** One message per specific intent. Avoid monolithic "do everything" messages.

package/.enderun/knowledge/zero_ui_library_policy.md

@@ -1,9 +1,13 @@
-# Zero UI Library Policy
+---
+title: Zero UI Library Policy
+tags: [design, security, compliance]
+related: [responsive_design_standards]
+last_updated: 2026-05-15
+---
 
-Do not use Shadcn, MUI, or any other UI library. Build components from scratch using **Panda CSS** tokens defined in `panda.config.ts`.
+The project strictly follows the Zero UI Library Policy. Importing external UI frameworks like shadcn/ui, MUI, or Chakra UI is forbidden. All styling must be implemented using Panda CSS to ensure zero-runtime overhead and complete control over the design system.
 
 ## Rationale
 - **Performance:** Zero-runtime CSS extraction.
 - **Type Safety:** Type-safe styles and tokens.
-- **Originality:** Unique and premium aesthetics without "library look".
-- **Control:** Full control over responsiveness and accessibility.
+- **Originality:** Unique and premium aesthetics without "library look".

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.4.7)
+# Agent Enderun (v0.5.1)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
@@ -6,7 +6,7 @@
 > - [ ] **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 `{{FRAMEWORK_DIR}}/logs/[agent].json`?
-> - [ ] **CLI Orchestration:** Does the action comply with `gemini cli` rules?
+> - [ ] **CLI Orchestration:** Does the action comply with `{{ADAPTER}} cli` rules?
 > - [ ] **No "..." allowed:** Did you write the code completely without omitting parts?
 
 ---
@@ -22,20 +22,25 @@ 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. **Automatic @manager Mode:** You are ALWAYS operating as `@manager` (Team-Lead). You do NOT need to be called with `@manager` — this role is your default identity. You analyze, delegate, and orchestrate on EVERY turn without exception.
 
-**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.
-- **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.
+- **Permanent @manager Identity:** The AI assistant is ALWAYS the `@manager` (Team-Lead) by default — on every turn, every message, without exception. The user does NOT need to type `@manager` to trigger this role. Explicitly typing a different agent (e.g. `@backend`) overrides this and activates that specialist directly.
+- **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 `{{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 `{{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.

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun — v0.4.7
+# 🏛️ Agent Enderun (v0.5.1) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -10,6 +10,17 @@
 
 ## Executive Summary
 
+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.1: The Academy & Hermes Upgrade
+
+Bu sürümle birlikte Agent Enderun, basit bir yönetişim aracından otonom bir **Ajan Akademisi**'ne dönüşmüştür:
+
+- **📡 Hermes Messaging Protocol:** Ajanlar arası kategorize edilmiş (Action/Delegation/Info) ve önceliklendirilmiş iletişim bus'ı.
+- **📚 Obsidian-Style LLM Wiki:** YAML metadata destekli, ilişkisel ve graf tabanlı teknik bilgi bankası yönetimi.
+- **🛡️ Contract-First Automation:** API ve tip kontratlarının SHA-256 ile otomatik doğrulanması.
+- **🤖 MCP Intelligence:** Bilgi grafiği üretme, inbox istatistikleri ve anlık sistem sağlığı denetimi sağlayan gelişmiş MCP araçları.
+
 Agent Enderun is a **production-grade AI governance framework** designed for engineering teams that must maintain control, traceability, and discipline when using AI assistants for code generation. It transforms chaotic AI output into structured, auditable, enterprise-ready deliverables through:
 
 - **Agent-Led Orchestration**: 8 specialized AI agent roles with defined responsibilities
@@ -37,7 +48,7 @@ git clone https://github.com/ybekar/agent-enderun.git
 cd agent-enderun
 
 # Option B: Or use as npm package (when published)
-npx agent-enderun init gemini
+npx agent{{FRAMEWORK_DIR}} init gemini
 ```
 
 #### Step 2: Install Dependencies
@@ -52,7 +63,7 @@ npm run enderun:build
 
 #### Step 4: Verify Setup
 ```bash
-agent-enderun check
+agent{{FRAMEWORK_DIR}} check
 ```
 
 Expected output:
@@ -70,38 +81,38 @@ Expected output:
 
 ### Initialize Your Project
 ```bash
-# Creates .enderun/ directory with governance files
-npx agent-enderun init gemini
+# Creates {{FRAMEWORK_DIR}}/ directory with governance files
+npx agent{{FRAMEWORK_DIR}} init gemini
 ```
 
 ### Check Project Health
 ```bash
 # Runs security audit, compliance check, and dependency analysis
-agent-enderun check
+agent{{FRAMEWORK_DIR}} check
 
 # Just security
-agent-enderun check:security
+agent{{FRAMEWORK_DIR}} check:security
 
 # Just compliance
-agent-enderun check:compliance
+agent{{FRAMEWORK_DIR}} check:compliance
 ```
 
 ### View Project Status
 ```bash
 # Shows current phase, active agents, and blockers
-agent-enderun status
+agent{{FRAMEWORK_DIR}} status
 ```
 
 ### Create a New Task
 ```bash
 # Creates a ULID-based trace for a new feature
-agent-enderun trace:new "Implement User Authentication" backend P1
+agent{{FRAMEWORK_DIR}} trace:new "Implement User Authentication" backend P1
 ```
 
 ### Verify API Contracts
 ```bash
 # Ensures shared-types and API docs are synchronized
-agent-enderun verify-contract
+agent{{FRAMEWORK_DIR}} verify-contract
 ```
 
 ---
@@ -110,9 +121,9 @@ agent-enderun verify-contract
 
 Agent Enderun consists of **4 integrated layers**:
 
-### Layer 1: Governance (.enderun/)
+### Layer 1: Governance ({{FRAMEWORK_DIR}}/)
 ```
-.enderun/
+{{FRAMEWORK_DIR}}/
 ├── ENDERUN.md              ← The "Supreme Law" (read this first!)
 ├── PROJECT_MEMORY.md       ← Single source of truth for state
 ├── STATUS.md               ← Agent status dashboard
@@ -237,8 +248,8 @@ Agents use the `search_knowledge_base` tool to find answers to common questions.
 - [ ] **npm 9+** installed (`npm --version`)
 - [ ] **Git** initialized (`git init`)
 - [ ] **Framework installed** (`npm install && npm run enderun:build`)
-- [ ] **Health check passed** (`agent-enderun check` shows ✅)
-- [ ] **First task created** (`agent-enderun trace:new "Your task" backend P1`)
+- [ ] **Health check passed** (`agent{{FRAMEWORK_DIR}} check` shows ✅)
+- [ ] **First task created** (`agent{{FRAMEWORK_DIR}} trace:new "Your task" backend P1`)
 - [ ] **Docs created** (add files to `docs/` for agents to read)
 - [ ] **MCP connected** (agents can now use tools)
 
@@ -259,7 +270,7 @@ Implement JWT-based authentication with refresh tokens.
 " > docs/requirements.md
 
 # Step 2: Create a task
-agent-enderun trace:new "Implement Auth Module" backend P1
+agent{{FRAMEWORK_DIR}} trace:new "Implement Auth Module" backend P1
 
 # Step 3: Agents read requirements and build
 # (They will automatically read docs/requirements.md)
@@ -270,7 +281,7 @@ agent-enderun trace:new "Implement Auth Module" backend P1
 ## 📁 Project Structure
 
 ```
-agent-enderun/
+agent{{FRAMEWORK_DIR}}/
 ├── README.md                          ← This file
 ├── package.json                       ← Root npm config
 ├── bin/
@@ -298,7 +309,7 @@ agent-enderun/
 ├── apps/                              ← Your applications (start here)
 │   ├── backend/                       ← (you create this)
 │   └── web/                           ← (you create this)
-└── .enderun/                          ← Framework governance
+└── {{FRAMEWORK_DIR}}/                          ← Framework governance
     ├── ENDERUN.md                     ← Constitution (MANDATORY READ)
     ├── PROJECT_MEMORY.md              ← State machine
     ├── STATUS.md                      ← Agent dashboard
@@ -349,9 +360,9 @@ 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)
+4. `{{FRAMEWORK_DIR}}/knowledge/` (technical guidelines)
 
 ### Q: What if I don't use an AI adapter?
 **A:** The framework still works as a **collaborative development platform**. You and your team use it to enforce:
@@ -364,7 +375,7 @@ agent-enderun/
 **A:** Yes. Add new tool files in `packages/framework-mcp/src/tools/`, define the schema, and export the handler. The CLI will automatically discover them.
 
 ### Q: How do I add my own agents?
-**A:** Create a markdown file in `.enderun/agents/your-agent.md`, define the SOP, and add a CLI mapping in `.enderun/cli-commands.json`.
+**A:** Create a markdown file in `{{FRAMEWORK_DIR}}/agents/your-agent.md`, define the SOP, and add a CLI mapping in `{{FRAMEWORK_DIR}}/cli-commands.json`.
 
 ### Q: Is this production-ready?
 **A:** The **framework** is production-ready. Individual features (like `apps/`) depend on what you build. Start with `apps/backend` or `apps/web`.
@@ -373,8 +384,8 @@ agent-enderun/
 
 ## 🔗 Key Files to Read First
 
-1. **`.enderun/ENDERUN.md`** — The constitution (rules all agents must follow)
-2. **`.enderun/PROJECT_MEMORY.md`** — Current project state and history
+1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — The constitution (rules all agents must follow)
+2. **`{{FRAMEWORK_DIR}}/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)
 5. **`README.md`** (this file) — How to use the framework
@@ -387,7 +398,7 @@ agent-enderun/
 File issues with clear reproduction steps and framework version.
 
 ### Contribute
-1. Read `.enderun/ENDERUN.md`
+1. Read `{{FRAMEWORK_DIR}}/ENDERUN.md`
 2. Follow the agent role guidelines
 3. Submit PRs with semantic commit messages
 4. Ensure tests pass: `npm run enderun:build`
@@ -428,7 +439,7 @@ git clone https://github.com/ybekar/agent-enderun.git
 cd agent-enderun
 
 # Seçenek B: veya npm paketi olarak kullan
-npx agent-enderun init gemini
+npx agent{{FRAMEWORK_DIR}} init gemini
 ```
 
 #### Adım 2: Bağımlılıkları Yükle
@@ -443,7 +454,7 @@ npm run enderun:build
 
 #### Adım 4: Kurulumu Doğrula
 ```bash
-agent-enderun check
+agent{{FRAMEWORK_DIR}} check
 ```
 
 Beklenen çıktı:
@@ -461,29 +472,29 @@ Beklenen çıktı:
 
 ### Projeyi Başlat
 ```bash
-npx agent-enderun init gemini
+npx agent{{FRAMEWORK_DIR}} init gemini
 ```
 
 ### Sağlık Durumunu Kontrol Et
 ```bash
-agent-enderun check                 # Tam kontrol
-agent-enderun check:security        # Sadece güvenlik
-agent-enderun check:compliance      # Sadece uyum
+agent{{FRAMEWORK_DIR}} check                 # Tam kontrol
+agent{{FRAMEWORK_DIR}} check:security        # Sadece güvenlik
+agent{{FRAMEWORK_DIR}} check:compliance      # Sadece uyum
 ```
 
 ### Proje Durumunu Görüntüle
 ```bash
-agent-enderun status
+agent{{FRAMEWORK_DIR}} status
 ```
 
 ### Yeni Görev Oluştur
 ```bash
-agent-enderun trace:new "Kullanıcı Doğrulama Uygulaması" backend P1
+agent{{FRAMEWORK_DIR}} trace:new "Kullanıcı Doğrulama Uygulaması" backend P1
 ```
 
 ### API Kontratlarını Doğrula
 ```bash
-agent-enderun verify-contract
+agent{{FRAMEWORK_DIR}} verify-contract
 ```
 
 ---
@@ -492,7 +503,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ı
@@ -537,8 +548,8 @@ Agent Enderun **4 entegre katmandan** oluşur:
 - [ ] **npm 9+** yüklü (`npm --version`)
 - [ ] **Git** başlatılmış (`git init`)
 - [ ] **Framework yüklü** (`npm install && npm run enderun:build`)
-- [ ] **Sağlık kontrolü geçti** (`agent-enderun check` ✅ gösteriyor)
-- [ ] **İlk görev oluşturuldu** (`agent-enderun trace:new "Görev" backend P1`)
+- [ ] **Sağlık kontrolü geçti** (`agent{{FRAMEWORK_DIR}} check` ✅ gösteriyor)
+- [ ] **İlk görev oluşturuldu** (`agent{{FRAMEWORK_DIR}} trace:new "Görev" backend P1`)
 - [ ] **Doklar oluşturuldu** (`docs/` klasörüne dosya ekledim)
 - [ ] **MCP bağlandı** (ajanlar araçları kullanabiliyor)
 
@@ -559,7 +570,7 @@ JWT tabanlı kimlik doğrulama sistemi kurun.
 " > docs/requirements.md
 
 # Adım 2: Görev oluşturun
-agent-enderun trace:new "Auth Modülü Uygula" backend P1
+agent{{FRAMEWORK_DIR}} trace:new "Auth Modülü Uygula" backend P1
 
 # Adım 3: Ajanlar sizin için çalışır
 # (Otomatik olarak docs/requirements.md okurlar)
@@ -570,13 +581,13 @@ agent-enderun trace:new "Auth Modülü Uygula" backend P1
 ## 📁 Proje Yapısı
 
 ```
-agent-enderun/
+agent{{FRAMEWORK_DIR}}/
 ├── docs/                 ← Ajanların okuyacağı dokümantasyon
 ├── packages/
 │   ├── shared-types/     ← Paylaşılan türler (sözleşme)
 │   └── framework-mcp/    ← MCP sunucusu (40+ araç)
 ├── apps/                 ← Uygulamalarınız (siz oluşturun)
-├── .enderun/             ← Yönetişim dosyaları
+├── {{FRAMEWORK_DIR}}/             ← Yönetişim dosyaları
 │   ├── ENDERUN.md        ← Anayasa (OKUNMALI)
 │   ├── PROJECT_MEMORY.md ← Proje durumu
 │   ├── agents/           ← 8 ajan tanımı
@@ -597,9 +608,9 @@ 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)
+4. `{{FRAMEWORK_DIR}}/knowledge/` (teknik rehberler)
 
 ### S: AI adaptörü kullanmak zorunlu mu?
 **C:** Hayır. Framework, AI'sız da işlev görür. Faz ilerleme, denetim kaydı ve tür disiplini zorunludur.
@@ -608,7 +619,7 @@ agent-enderun/
 **C:** Evet. `packages/framework-mcp/src/tools/` klasörüne yeni dosya ekleyin.
 
 ### S: Kendi ajanlarımı ekleyebilir miyim?
-**C:** Evet. `.enderun/agents/` klasörüne `.md` dosyası oluşturun ve CLI mapping'ini güncelleyin.
+**C:** Evet. `{{FRAMEWORK_DIR}}/agents/` klasörüne `.md` dosyası oluşturun ve CLI mapping'ini güncelleyin.
 
 ### S: Üretim için hazır mı?
 **C:** Framework hazır. `apps/` klasörü tamamen sizin.
@@ -617,8 +628,8 @@ agent-enderun/
 
 ## 🔗 Önce Okumanız Gereken Dosyalar
 
-1. **`.enderun/ENDERUN.md`** — Anayasa
-2. **`.enderun/PROJECT_MEMORY.md`** — Proje durumu
+1. **`{{FRAMEWORK_DIR}}/ENDERUN.md`** — Anayasa
+2. **`{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md`** — Proje durumu
 3. **`docs/tech-stack.md`** — Teknoloji kararları
 4. **`packages/shared-types/src/index.ts`** — Sözleşme (türler)
 5. **`README.md`** — Bu dosya
@@ -631,7 +642,7 @@ agent-enderun/
 Net adımlarla ve versiyon numarası ile sorun bildir.
 
 ### Katkıda Bulun
-1. `.enderun/ENDERUN.md` oku
+1. `{{FRAMEWORK_DIR}}/ENDERUN.md` oku
 2. Agent rolü yönergelerine uyun
 3. Semantik commit'ler gönder
 4. Testleri geç: `npm run enderun:build`
@@ -639,30 +650,30 @@ Net adımlarla ve versiyon numarası ile sorun bildir.
 ### Lisans
 MIT © 2026 Yusuf BEKAR
 ```bash
-agent-enderun status
+agent{{FRAMEWORK_DIR}} status
 ```
 
 ### 4. Advanced Intelligence Commands
 ```bash
 # Run Security Audit
-agent-enderun check:security
+agent{{FRAMEWORK_DIR}} check:security
 
 # Generate Dependency Graph
-agent-enderun explorer:graph
+agent{{FRAMEWORK_DIR}} explorer:graph
 
 # Get Commit Suggestion
-agent-enderun git:commit [TRACE-ID]
+agent{{FRAMEWORK_DIR}} git:commit [TRACE-ID]
 ```
 
 ---
 
-## 📂 Consolidated Framework Structure (`.enderun/`)
+## 📂 Consolidated Framework Structure (`{{FRAMEWORK_DIR}}/`)
 
 All governance and engineering assets are consolidated under the framework directory for a clean project root.
 
 ```text
 .
-├── .enderun/
+├── {{FRAMEWORK_DIR}}/
 │   ├── ENDERUN.md           # Supreme Law (Constitution)
 │   ├── PROJECT_MEMORY.md    # Working Memory & History
 │   ├── BRAIN_DASHBOARD.md   # Intelligence & Performance Stats

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"
   ];
@@ -533,6 +525,12 @@ async function initCommand(selectedAdapter) {
   const buildCmd = pkgMgr === "npm" ? "npm run enderun:build" : `${pkgMgr} run enderun:build`;
 
   console.log(`\n✨ Framework scaffolded! (v${FRAMEWORK_VERSION})`);
+
+  // Allow skipping install in test/CI environments
+  if (process.env.ENDERUN_SKIP_INSTALL === "1") {
+    console.log("\n⏭️  Skipping install steps (ENDERUN_SKIP_INSTALL=1).");
+    return;
+  }
   
   try {
     const { execSync } = await import("child_process");

package/bin/update-contract.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import crypto from "crypto";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.join(__dirname, "..");
+
+const contractPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
+const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+
+function calculateHash(dir) {
+  const hash = crypto.createHash("sha256");
+  const files = fs.readdirSync(dir).filter(f => f.endsWith(".ts") || f.endsWith(".json")).sort();
+  
+  files.forEach(file => {
+    const content = fs.readFileSync(path.join(dir, file));
+    hash.update(content);
+  });
+  
+  return hash.digest("hex");
+}
+
+try {
+  console.log("🔍 Calculating shared-types contract hash...");
+  const newHash = calculateHash(sharedTypesDir);
+  
+  const contract = JSON.parse(fs.readFileSync(contractPath, "utf-8"));
+  
+  if (contract.contract_hash === newHash) {
+    console.log("✅ Contract hash is already up to date.");
+  } else {
+    contract.contract_hash = newHash;
+    contract.last_updated = new Date().toISOString();
+    fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2));
+    console.log(`🚀 Contract updated with new hash: ${newHash.slice(0, 10)}...`);
+  }
+} catch (error) {
+  console.error("❌ Failed to update contract hash:", error.message);
+  process.exit(1);
+}

package/claude.md

@@ -4,4 +4,7 @@ This file is the entry point for Claude. The project's "Supreme Law" and all ins
 
 👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
 
-Please read that file thoroughly before taking any action.
+### 🤖 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.
+
+Please read the Supreme Law thoroughly before taking any action.