agent-enderun 0.1.10 → 0.2.0

package/packages/framework-mcp/README.md

@@ -1,94 +1,60 @@
-# AI-Enderun MCP Server v0.1.10
+# AI-Enderun MCP Server (v0.2.0)
 
 English | [Türkçe](#türkçe)
 
-The `ai-enderun-mcp` package implements the Model Context Protocol server for AI-Enderun. It enables AI clients to inspect the repository, enforce conventions, manage project memory, and verify shared contract integrity.
+The `ai-enderun-mcp` package is the core intelligence engine of the Agent Enderun framework, implementing the Model Context Protocol (MCP).
 
 ## English
 
-### Purpose
-
-This package is the intelligence bridge between AI clients and the local repository. It gives agents structured access to repository state, rules, and verification tools.
-
-### What it provides
-
-- **Framework Status & Memory:** Evaluates active phase, trace IDs, and project history.
-- **Search & Analysis:** AST-powered code search, dependency analysis, and pattern discovery.
-- **Contract Verification:** Confirms shared types and API contracts match the stored hash.
-- **Security Auditing:** Detects unsafe patterns such as raw SQL, console logs, and `any` usage.
-- **Structured Logging:** Centralized JSON logs for agent actions and traceability.
-
-### Tools exposed to agents
-
-- `get_framework_status`
-- `search_codebase`
-- `analyze_dependencies`
-- `get_memory_insights`
-- `update_project_memory`
-- `get_project_gaps`
-- `security_audit_scan`
-- `verify_api_contract`
-- `update_contract_hash`
-- `log_agent_action`
-
-### Development
-
-```bash
-cd packages/framework-mcp
-npm install
-npm run build
-npm run dev
-```
-
-### Integration role
-
-This package interprets and verifies:
-
-- `.gemini/` or chosen adapter directories for agent SOPs and configuration.
-- `docs/` for project requirements and API contract definitions.
-- `packages/shared-types/` for contract-first type validation.
+### 🛠️ Categorized Tools
+
+#### 🛡️ Security & Compliance
+- `security_audit_scan`: Scans for secrets, raw SQL, and unsafe patterns using AST.
+- `analyze_constitution_compliance`: Verifies adherence to `ENDERUN.md` rules.
+
+#### 🧠 Framework & Memory
+- `get_framework_status`: Retrieves active phase and status.
+- `update_project_memory`: Atomic updates to project brain sections.
+- `bootstrap_legacy_memory`: Auto-generates memory for existing projects.
+- `read_project_memory`: Safe read access to the project brain.
+
+#### 🔍 Codebase Intelligence
+- `search_codebase`: Regex-powered semantic search.
+- `analyze_dependencies`: Deep import tracking and dependency mapping.
+- `analyze_codebase_intelligence`: Detects complexity spikes and dead code.
+- `generate_dependency_graph`: Creates Mermaid architecture maps.
+- `analyze_database_schema`: Generates Mermaid ER diagrams from migration code.
+
+#### 📜 Contract Management
+- `verify_api_contract`: Checks shared-types integrity via hashing.
+- `update_contract_hash`: Synchronizes the contract versioning.
+- `verify_contract_integrity`: Ensures API docs and types are in sync.
+
+#### 🎓 Academy & Orchestration
+- `log_agent_action`: Records traceable agent activities.
+- `get_academy_performance`: Aggregates success rates across the team.
+- `send_agent_message`: Facilitates inter-agent collaboration.
+- `read_agent_messages`: Inbox management for specialized agents.
+- `generate_strategic_briefing`: High-level executive performance summary.
+- `generate_academy_progress_report`: Narrative overview of project milestones.
+
+#### 📦 Repository & Git
+- `validate_repository_health`: Pre-commit health checks (lint/test/build).
+- `analyze_documentation_debt`: Scans for missing JSDoc and READMEs.
+- `generate_semantic_commit_message`: Automated commit messages based on diffs.
+
+---
 
 ## Türkçe
 
-`ai-enderun-mcp`, AI-Enderun için Model Context Protocol (MCP) sunucusunu sağlar. AI istemcilerinin depoyu incelemesi, kuralları denetlemesi, proje hafızasını yönetmesi ve paylaşılan kontrat bütünlüğünü doğrulaması için yapılandırılmış bir arayüz sunar.
-
-### Ne sağlar?
-
-- **Framework Durumu & Hafıza:** Aktif faz, trace ID'leri ve proje geçmişi değerlendirmesi.
-- **Arama & Analiz:** AST destekli kod arama, bağımlılık analizi ve desen keşfi.
-- **Kontrat Doğrulama:** Paylaşılan tipler ve API sözleşmelerinin kayıtlı hash ile uyumunu kontrol eder.
-- **Güvenlik Denetimi:** Raw SQL, console.log ve `any` kullanımı gibi güvensiz modelleri tespit eder.
-- **Yapısal Loglama:** Ajan eylemleri için merkezi JSON tabanlı takip.
-
-### Araçlar
-
-- `get_framework_status`
-- `search_codebase`
-- `analyze_dependencies`
-- `get_memory_insights`
-- `update_project_memory`
-- `get_project_gaps`
-- `security_audit_scan`
-- `verify_api_contract`
-- `update_contract_hash`
-- `log_agent_action`
-
-### Geliştirme
-
-```bash
-cd packages/framework-mcp
-npm install
-npm run build
-npm run dev
-```
-
-### Entegrasyon rolü
-
-Bu paket şunları yorumlar ve doğrular:
+### 🛠️ Kategorize Edilmiş Araçlar
 
-- Ajan SOP’ları ve yapılandırma için `.gemini/` veya seçilen adaptör dizinleri.
-- Proje gereksinimleri ve API sözleşmeleri için `docs/`.
-- Kontrat-öncelikli tip doğrulaması için `packages/shared-types/`.
+- **Güvenlik:** `security_audit_scan`, `analyze_constitution_compliance`.
+- **Hafıza:** `get_framework_status`, `update_project_memory`, `bootstrap_legacy_memory`.
+- **Zeka:** `search_codebase`, `analyze_dependencies`, `generate_dependency_graph`, `analyze_database_schema`.
+- **Kontrat:** `verify_api_contract`, `update_contract_hash`, `verify_contract_integrity`.
+- **Orkestrasyon:** `send_agent_message`, `log_agent_action`, `generate_strategic_briefing`.
+- **Repo:** `validate_repository_health`, `analyze_documentation_debt`, `generate_semantic_commit_message`.
 
 ## License