atabey 0.0.12 → 0.0.13

package/README.md

@@ -1,159 +1,424 @@
-# [GOV] Agent Atabey -- Enterprise AI Governance & Autonomous Orchestration Framework
+# [GOV] Agent Atabey — MCP-Powered AI Governance & Autonomous Orchestration
 
-[![Version](https://img.shields.io/badge/Version-v0.0.12-blue.svg)](https://github.com/ysf-bkr/atabey)
+[![Version](https://img.shields.io/badge/Version-v0.0.13-blue.svg)](https://github.com/ysf-bkr/atabey)
 [![npm](https://img.shields.io/npm/v/atabey)](https://www.npmjs.com/package/atabey)
 [![npm-mcp](https://img.shields.io/npm/v/atabey-mcp)](https://www.npmjs.com/package/atabey-mcp)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
 [![Type-Safety](https://img.shields.io/badge/Type--Safety-100%25-green.svg)](https://github.com/ysf-bkr/atabey)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/Tests-205%20passed-brightgreen)](https://github.com/ysf-bkr/atabey)
-[![CI](https://img.shields.io/badge/CI-GitHub%20Actions-blue)](https://github.com/ysf-bkr/atabey/actions)
+[![Tests](https://img.shields.io/badge/Tests-223%20passed-brightgreen)](https://github.com/ysf-bkr/atabey)
 
-**[EN]** Agent Atabey is a Supreme AI Governance & Autonomous Orchestration Framework designed for Enterprise Development. It enforces strict "Zero Type Hole" and "Zero Mock" policies via deterministic Quality Gates, provides local Vector Memory, and orchestrates 13 specialized AI agents through a SQLite-backed Hermes Message Broker. Production ready for MCP integrations (Claude, Gemini, Cursor).
+**Agent Atabey** is a **MCP (Model Context Protocol) server** that plugs directly into your AI coding interface — Claude Code, Gemini CLI, or Cursor — adding 13 specialized AI agents with enterprise-grade governance.
 
-**[TR]** Agent Atabey, kurumsal projeler için geliştirilmiş Yüce Yapay Zeka Yönetişim ve Otonom Orkestrasyon Çerçevesidir. Deterministik Kalite Kapıları ile katı "Zero Type Hole" ve "Zero Mock" kurallarını uygular, yerel Vektörel Hafıza sağlar ve 13 uzman yapay zeka ajanını SQLite tabanlı Hermes Mesajlaşma Aracısı üzerinden koordine eder. MCP entegrasyonları (Claude, Gemini, Cursor) için üretime tam hazırdır.
+> **Philosophy:** "Order from Chaos"
+> **How it works:** Install → Connect to your AI → Use `@agent` commands in chat
 
 ---
 
-## [INSTALL] Installation / Kurulum
+## 🚀 How It Works
 
-### Requirements / Gereksinimler
+Atabey connects to your AI interface as an **MCP tool server**. Once connected, you use `@agent` commands directly in your AI chat:
+
+```
+You (@backend): "Create a user login service with JWT authentication"
+     │
+     ▼
+  Atabey MCP Server (framework-mcp/)
+     │  Intercepts @agent command
+     │  Routes via RoutingEngine (TF-IDF)
+     │  Routes to @backend specialist
+     │  Quality Gate checks output
+     │  Stores in Vector Memory
+     │
+     ▼
+  Returns governed, reviewed, audited code
+```
+
+**No separate terminal needed. No CLI commands for daily use.** Just chat with your AI and use `@agent` syntax.
+
+---
+
+## 📋 Table of Contents
+
+- [Quick Start](#quick-start)
+- [How Atabey Plugs Into Your AI](#how-atabey-plugs-into-your-ai)
+- [Installation](#installation)
+- [Profile-Based Setup](#profile-based-setup)
+- [13 Specialized Agents](#13-specialized-agents)
+- [Core Features](#core-features)
+- [Dashboard](#dashboard)
+- [CLI Reference](#cli-reference)
+- [Architecture](#architecture)
+- [LLM Gateway](#llm-gateway)
+- [Security](#security)
+- [Contributing](#contributing)
+
+---
+
+## Quick Start
+
+### 1. Initialize Atabey in Your Project
+
+```bash
+npx atabey init gemini --profile freelancer --yes
+```
+
+### 2. Connect to Your AI Interface
+
+Atabey generates an `mcp.json` config. Point your AI assistant to it:
+
+**Claude Code:**
+```json
+// mcp.json
+{
+  "mcpServers": {
+    "atabey": {
+      "command": "npx",
+      "args": ["atabey-mcp"],
+      "env": {
+        "ATABEY_PROJECT_ROOT": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+**Gemini CLI:**
+```bash
+gemini config set mcpServers.atabey.command "npx"
+gemini config set mcpServers.atabey.args "[\"atabey-mcp\"]"
+```
+
+**Cursor:**
+```json
+// .cursor/mcp.json
+{
+  "mcpServers": {
+    "atabey": {
+      "command": "npx",
+      "args": ["atabey-mcp"]
+    }
+  }
+}
+```
+
+### 3. Start Using in AI Chat
+
+Open your AI interface and simply type:
+
+```
+@backend Create a REST API for user management with CRUD operations
+@security Audit the authentication middleware
+@quality Run compliance check on the new feature
+```
+
+**That's it.** Atabey handles routing, quality gates, memory, and governance automatically.
+
+---
+
+## How Atabey Plugs Into Your AI
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                   YOUR AI INTERFACE                                │
+│   Claude Code · Gemini CLI · Cursor · Codex CLI                   │
+│   You type: @backend Create login service                         │
+├──────────────────────────────────────────────────────────────────┤
+│                    MCP PROTOCOL (stdio)                            │
+│   JSON-RPC messages over stdin/stdout                             │
+├──────────────────────────────────────────────────────────────────┤
+│                    ATABEY MCP SERVER                               │
+│   ┌──────────────────────────────────────────────────────────┐   │
+│   │  30+ Tools: read_file, write_file, send_message,        │   │
+│   │  orchestrate_loop, run_tests, check_lint, query_gateway │   │
+│   └──────────────────────────────────────────────────────────┘   │
+├──────────────────────────────────────────────────────────────────┤
+│                    GOVERNANCE LAYER                                │
+│   Quality Gate → Risk Engine → Vector Memory → Audit Log         │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Atabey is **not a separate platform**. It's a tool server that augments your existing AI assistant with:
+- **13 specialized agents** (backend, frontend, security, etc.)
+- **Deterministic quality gates** (AST analysis + lint + tests)
+- **Risk detection** (blocks destructive operations)
+- **Vector memory** (remembers past decisions)
+- **Audit trails** (every action logged)
+
+---
+
+## Installation
+
+### Requirements
 
 | Requirement | Version |
-|-----------|----------|
+|------------|---------|
 | **Node.js** | >= 18.0.0 |
 | **npm** | >= 9.0.0 |
-| **SQLite** | Built-in (via better-sqlite3) |
+| **AI Interface** | Claude Code, Gemini CLI, Cursor, Codex CLI |
 
-### Global Install / Global Kurulum
-
-**[EN]** Install the main CLI and the optional MCP server globally.
-**[TR]** Ana CLI aracını ve isteğe bağlı MCP sunucusunu global olarak kurun.
+### Quick Install
 
 ```bash
-# Main package / Ana Paket (CLI + Framework)
+# Install globally (recommended)
 npm install -g atabey
 
-# MCP Server (for Claude/Gemini integration)
-npm install -g atabey-mcp
+# Initialize with your preferred profile
+npx atabey init gemini --profile freelancer --yes
+
+# Verify installation
+npx atabey status
+
+# (Optional) Open the web dashboard
+npx atabey dashboard
 ```
 
 ---
 
-## [QUICKSTART] Quick Start / Hızlı Başlangıç
+## Profile-Based Setup
 
-### 1. Initialize Your Project / Projeyi Başlat
+Choose the profile that matches your team size. Atabey automatically configures the right agents, directories, and governance rules.
 
-**[EN]** Enable Atabey in your project. This creates the `.atabey/` working directory, configures 13 specialized agents, and initializes the Hermes message infrastructure.
-**[TR]** Atabey'i proje dizininde aktif edin. Bu komut `.atabey/` çalışma dizinini oluşturur, 13 uzman ajanı yapılandırır ve Hermes mesaj altyapısını başlatır.
+### `--profile freelancer` (1-3 people)
 
 ```bash
-atabey init gemini --unified --yes
+npx atabey init gemini --profile freelancer
 ```
 
-### 2. Start a Task / Ajanlara Görev Ver
+| Feature | What You Get |
+|---------|-------------|
+| **Agents** | `@manager`, `@backend`, `@quality` (3 agents) |
+| **Setup Time** | ~10 seconds |
+| **Daily Workflow** | Chat with AI using `@backend`, `@quality` |
+| **Governance** | Basic quality gate + risk engine |
+| **Why?** | Minimal overhead, just code |
 
-**[EN]** Delegate directly to an agent or start smart orchestration.
-**[TR]** Doğrudan bir ajana görev verin veya akıllı orkestrasyonu başlatın.
+### `--profile team` (5-15 people)
 
 ```bash
-# Direct delegation
-atabey @backend "Write and test the user login service"
+npx atabey init gemini --profile team --unified
+```
+
+| Feature | What You Get |
+|---------|-------------|
+| **Agents** | 7 core agents (manager, security, architect, backend, frontend, quality, database) |
+| **Setup Time** | ~30 seconds |
+| **Daily Workflow** | Multi-agent collaboration with quality gate |
+| **Dashboard** | 8 live modules, WebSocket real-time |
+| **Governance** | Quality gate + risk engine + contract validation |
+| **Why?** | Team-scale governance without overhead |
 
-# Smart orchestration
-atabey orchestrate
+### `--profile enterprise` (15+ people)
+
+```bash
+npx atabey init gemini --profile enterprise
 ```
 
-### 3. Dashboard / Kontrol Paneli
+| Feature | What You Get |
+|---------|-------------|
+| **Agents** | All 13 agents (Supreme + Core + Recon) |
+| **Setup Time** | ~1 minute |
+| **Daily Workflow** | Full governance with human-in-the-loop |
+| **Dashboard** | 8 modules + audit/error/memory tracking |
+| **Security** | Human-in-the-Loop, KVKK PII masking, audit log |
 
-**[EN]** Open the web-based visual control panel.
-**[TR]** Web tabanlı görsel yönetim panelini açın.
+### Custom Setup
 
 ```bash
-atabey dashboard
+npx atabey init gemini
+# Interactive menu: choose agents, directories, colors manually
 ```
 
 ---
 
-## [FEATURES] Core Features / Temel Özellikler
+## 13 Specialized Agents
+
+| Agent | Tier | Role | Freelancer | Team | Enterprise |
+|-------|------|------|:----------:|:----:|:----------:|
+| **@manager** | Supreme | Orchestration, governance, quality gate | ✅ | ✅ | ✅ |
+| **@security** | Supreme | Security audit, vulnerability scanning | ❌ | ✅ | ✅ |
+| **@architect** | Core | System design, contracts, architecture | ❌ | ✅ | ✅ |
+| **@backend** | Core | Backend dev, API, business logic, tests | ✅ | ✅ | ✅ |
+| **@frontend** | Core | UI, atomic components, responsive design | ❌ | ✅ | ✅ |
+| **@quality** | Core | Compliance, lint, test coverage | ✅ | ✅ | ✅ |
+| **@database** | Core | Database management, migrations, queries | ❌ | ✅ | ✅ |
+| **@analyst** | Core | Strategy analysis, requirements | ❌ | ❌ | ✅ |
+| **@mobile** | Core | React Native mobile development | ❌ | ❌ | ✅ |
+| **@native** | Core | Native platform integration | ❌ | ❌ | ✅ |
+| **@devops** | Core | CI/CD, deploy, infrastructure | ❌ | ❌ | ✅ |
+| **@explorer** | Recon | Codebase discovery, analysis | ❌ | ❌ | ✅ |
+| **@git** | Recon | Version control, commit management | ❌ | ❌ | ✅ |
+
+---
+
+## Core Features
+
+### 1. Deterministic Quality Gate
+No agent can push code directly to production. All outputs pass through AST analysis (compliance), linting, and unit tests. Failed code triggers an automatic 3-attempt retry loop.
+
+### 2. Autonomous Vector Memory
+Project context, contracts, and past tasks are stored locally via `better-sqlite3` using TF-IDF semantic search (cosine similarity). Agents search past architectural decisions.
+
+### 3. Hermes Message Broker
+Agents communicate asynchronously via a SQLite-backed message queue. A file-based lock protocol prevents race conditions.
+
+### 4. Risk Engine (Human-in-the-Loop)
+Operations containing `DROP`, `DELETE`, `TRUNCATE`, or secret manipulation are flagged. Execution is blocked until human approval via `atabey approve <traceId>`.
+
+### 5. Smart Routing Engine
+TF-IDF keyword matching routes natural language tasks to the most capable agent. Uses specialized weights for all 13 agents.
+
+### 6. Web Dashboard
+Real-time WebSocket dashboard with 8 live modules. Fully responsive (mobile + desktop).
 
-### 1. Deterministic Quality Gate / Deterministik Kalite Kapısı
-**[EN]** No agent can push code directly to production. All outputs pass through AST Analysis (Compliance), Linting, and Unit Tests. If the code fails, the agent is forced into an automatic 3-attempt Retry Loop to fix its mistakes.
-**[TR]** Hiçbir ajan doğrudan üretime kod gönderemez. Tüm çıktılar AST Analizi, Lint ve Unit Test süreçlerinden geçer. Kod başarısız olursa, ajan hatalarını düzeltmesi için otomatik olarak 3 denemelik bir döngüye sokulur.
+### 7. LLM Gateway & Load Balancer
+Load balancing across multiple LLM providers (OpenAI, Anthropic, Google, Groq, Ollama) with circuit breaker, rate limiting, and cost tracking.
 
-### 2. Autonomous Vector Memory / Otonom Vektör Hafızası
-**[EN]** Atabey stores project context, contracts, and past tasks locally via `better-sqlite3` using a TF-IDF semantic search engine (Cosine Similarity). Agents can search and retrieve past architectural decisions.
-**[TR]** Proje bağlamı, kontratlar ve geçmiş görevler yerel SQLite üzerinde anlamsal bir arama motoruyla vektörel olarak depolanır. Ajanlar geçmiş mimari kararları arayıp bulabilir.
+### 8. Multi-Platform Support
+Claude Code, Gemini CLI, Cursor, Codex CLI, Antigravity CLI — automatic agent configuration for all platforms.
 
-### 3. Hermes Message Broker / Hermes Mesaj Kuyruğu
-**[EN]** Agents communicate asynchronously via a SQLite-backed message queue (`@manager` -> `@backend` -> `@quality`). A file-based Lock Protocol is used to prevent race conditions.
-**[TR]** Ajanlar SQLite tabanlı bir mesaj kuyruğu üzerinden birbirleriyle asenkron olarak haberleşir. Çakışmaları önlemek için dosya tabanlı kilit protokolü kullanılır.
+### 9. Polyglot Backend Support
+Node.js, Go, Java, Python, .NET — automatic scaffolding based on backend language selection.
 
-### 4. Risk Engine / Risk Motoru
-**[EN]** Operations containing `DROP`, `DELETE`, `TRUNCATE`, or secret manipulation are flagged. Execution is blocked until a human administrator approves it via `atabey approve <traceId>` (Human-in-the-Loop).
-**[TR]** Tehlikeli veritabanı komutları veya gizli anahtar manipülasyonu içeren işlemler işaretlenir. Yönetici `atabey approve <traceId>` ile onay verene kadar işlem durdurulur (Human-in-the-Loop).
+---
+
+## Dashboard
+
+```bash
+npx atabey dashboard  # Opens at http://localhost:5858
+```
 
-### 5. Smart Routing Engine / Akıllı Yönlendirme Motoru
-**[EN]** Uses TF-IDF based keyword matching (Specialty + Role + DisplayName) to automatically route the user's natural language task to the most capable agent and split it into sub-tasks.
-**[TR]** TF-IDF tabanlı kelime eşleştirme kullanarak kullanıcının doğal dildeki görevini en yetkin ajana yönlendirir ve alt görevlere böler.
+| Module | Description | Update |
+|--------|-------------|--------|
+| 🤖 **Agent Monitor** | AI agent status + tasks | WS (5s) |
+| 📨 **Hermes Messages** | Message queue + filter | WS (5s) |
+| 🔐 **Approval Center** | Human approvals | WS |
+| 📋 **Task Planner** | Task DAG + progress | REST (5s) |
+| 📝 **Agent Logs** | Execution logs | WS (5s) |
+| ⚠️ **Error Tracker** | Lint/compliance errors | WS |
+| 🧠 **Memory Insights** | Vector memory search | REST |
+| 🛡️ **Compliance** | Quality gate status | REST (15s) |
 
 ---
 
-## [AGENTS] 13 Specialized Agents / 13 Uzman Ajan
+## CLI Reference
 
-**[EN]** The framework consists of 13 agents divided into 3 tiers based on authority and role:
-**[TR]** Framework, yetki ve görevlerine göre 3 katmana ayrılmış 13 ajandan oluşur:
+```bash
+atabey init [adapter]     Initialize Atabey (--profile freelancer|team|enterprise)
+atabey mcp start          Start MCP server (connects to your AI interface)
+atabey mcp install        Generate mcp.json config for AI integration
+atabey dashboard [port]   Open web dashboard (default: 5858)
+atabey status             Show agent statuses and costs
+atabey check              Full health and compliance check
+atabey orchestrate        Start autonomous orchestration loop
+atabey approve <traceId>  Approve a blocked high-risk task
+atabey @agent "task"      Send task directly to an agent
+```
 
-| Agent | Tier | Role | Description |
-|------|------|------|-------------|
-| **@manager** | [S] Supreme | Orchestration | Manages all agents, distributes tasks, oversees the Quality Gate. |
-| **@security** | [S] Supreme | Security Audit | Enforces Zero-Trust, encryption, and secret management. |
-| **@architect** | [C] Core | System Design | Manages system architecture and API contracts. |
-| **@backend** | [C] Core | Backend Dev. | Develops API endpoints, business logic, and writes mandatory tests. |
-| **@frontend** | [C] Core | Frontend Dev. | Builds UI, atomic components, and responsive designs (React/Vite). |
-| **@quality** | [C] Core | Quality Audit | Validates code compliance (Lint, AST) and test coverage. |
-| **@database** | [C] Core | DB Management | Handles schemas, migrations, and query optimization. |
-| **@analyst** | [C] Core | Strategy | Performs requirement analysis and contract validation. |
-| **@mobile** | [C] Core | Mobile Dev. | Develops offline-first React Native architecture. |
-| **@native** | [C] Core | Native Ops. | Handles OS-level integrations and system calls. |
-| **@devops** | [C] Core | Infrastructure | Manages CI/CD, Docker configurations, and server health. |
-| **@explorer** | [R] Recon | Discovery | Maps the codebase and analyzes dependencies. |
-| **@git** | [R] Recon | Version Control | Enforces Trace ID-based commit discipline and Git operations. |
+Full command list: see `atabey help` or [ARCHITECTURE.md](ARCHITECTURE.md)
 
 ---
 
-## [CLI] Command Reference / Komut Referansı
+## Architecture
 
-| Command | Usage | Description |
-|-------|-------|-------------|
-| `init` | `atabey init <adapter>` | Initialize the project and structure |
-| `orchestrate` | `atabey orchestrate` | Start the autonomous agent orchestration loop |
-| `dashboard` | `atabey dashboard` | Open the web-based visual control panel |
-| `approve` | `atabey approve <traceId>` | Approve a blocked high-risk task |
-| `status` | `atabey status` | Show current agent statuses and costs |
-| `trace` | `atabey trace [id]` | View execution trace history |
-| `check` | `atabey check` | Run AST compliance check |
-| `lint` | `atabey lint` | Run code quality checks (ESLint) |
-| `mcp` | `atabey mcp` | Manage MCP server configuration |
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                      AI Chat Interface                            │
+│    @backend Create login service (in Claude/Gemini/Cursor)      │
+├──────────────────────────────────────────────────────────────────┤
+│                    MCP Server (framework-mcp/)                    │
+│                    30+ Tools · Stdio Transport                    │
+│                    Zod Validation · Error Handling                │
+├──────────────────────────────────────────────────────────────────┤
+│                    src/cli/  30+ Commands                         │
+│                    src/modules/  Engines + Agents                 │
+│                    src/shared/  Types + Storage                   │
+├────────────────┬───────────────────────────┬──────────────────────┤
+│                ▼                           ▼                      │
+│  ┌──────────────────────────┐  ┌──────────────────────────────┐  │
+│  │ Web Dashboard            │  │ SQLite (better-sqlite3)      │  │
+│  │ Port 5858                │  │ Hermes Queue · Memory        │  │
+│  │ 8 Module WS Live         │  │ Audit Logs · Locks          │  │
+│  │ Responsive (Mob+Desk)    │  │                              │  │
+│  └──────────────────────────┘  └──────────────────────────────┘  │
+└──────────────────────────────────────────────────────────────────┘
+```
 
 ---
 
-## [TEST] Testing / Testler
+## LLM Gateway
 
-**[EN]** The project is comprehensively tested using Vitest (100% Success).
-**[TR]** Proje Vitest kullanılarak kapsamlı bir şekilde test edilmektedir (%100 Başarı).
+Atabey provides an integrated gateway for managing multiple LLM providers:
+
+| Provider | Models | Status |
+|----------|--------|--------|
+| **OpenAI** | GPT-4, GPT-4o, o3, o4-mini | ✅ Active |
+| **Anthropic** | Claude Opus 4.5, Sonnet 4.5, Haiku 3.5 | ✅ Active |
+| **Google** | Gemini 2.5 Pro, Flash, Flash-Lite | ✅ Active |
+| **Groq** | Llama, Mixtral (fast inference) | ✅ Active |
+| **Ollama** | Local models (LLaMA, Mistral, etc.) | ✅ Active |
 
 ```bash
-# Run all tests
-npm test
+npx atabey gateway status
+npx atabey gateway configure
+```
 
-# Test coverage report
-npm run test:coverage
+---
+
+## Security
+
+### Zero Type Hole Policy
+- `any` type usage is **strictly forbidden**
+- All function inputs validated with Zod schemas
+- Type safety enforced in CI pipeline
+
+### Zero Mock Policy
+- Mock data usage is **forbidden** (except 3rd party services)
+- Tests run against real implementations
+
+### PII Masking (KVKK Compliant)
+- All logs scanned for Personally Identifiable Information
+- Sensitive data automatically masked
+- Turkish KVKK and EU GDPR compliant
+
+### Human-in-the-Loop
+- Risk score ≥ 60 requires human approval
+- `DROP`, `DELETE`, `TRUNCATE` operations blocked
+- Approval via `atabey approve <traceId>`
+
+---
+
+## Testing
+
+```bash
+npm test                    # Run all tests (223 passing)
+npm run test:watch          # Watch mode
+npm run test:coverage       # Coverage report
 ```
 
 ---
 
-## [LICENSE] License / Lisans
+## Contributing
 
-MIT License -- [Yusuf BEKAR](mailto:ybekar@msn.com)
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on the code of conduct and pull request process.
+
+```bash
+git clone https://github.com/ysf-bkr/atabey.git
+cd atabey
+npm install
+npm install --prefix framework-mcp
+npm install --prefix framework-mcp/dashboard
+npm run build
+```
+
+---
+
+## License
+
+MIT License — [Yusuf BEKAR](mailto:ybekar@msn.com)
 
 Enterprise inquiries: **ybekar@msn.com**
+
+---
+
+*Developer: **Yusuf BEKAR** — "Order from Chaos"*

package/bin/validate-al-registry.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 import fs from "fs";
-import path from "path";
 import yaml from "js-yaml";
+import path from "path";
 
 /**
  * AL-compatible agent folder names across all adapters (after init).
@@ -48,10 +48,10 @@ function parseFrontmatter(content) {
         try {
             fm = yaml.load(match[1]) || {};
         } catch (e) {
-            console.error("Error parsing YAML frontmatter:", e);
+            process.stderr.write(`[ERROR] Error parsing YAML frontmatter: ${e}\n`);
         }
     }
-    
+
     // Also parse from HTML comments in the body as fallback/complement
     const commentMatches = content.matchAll(/<!--\s*(\w+)\s*:\s*(.*?)\s*-->/g);
     for (const m of commentMatches) {
@@ -103,7 +103,7 @@ try {
         const fileName = file.name;
         const filePath = file.path;
         if (fileName === "agent_AL_schema.json" || fileName === "schema") continue;
-        
+
         const content = fs.readFileSync(filePath, "utf8");
         const isMd = fileName.endsWith(".md");
 

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

@@ -1,5 +1,5 @@
-import * as schemas from "./schemas.js";
 import { zodToMcpSchema } from "../utils/zod-to-mcp.js";
+import * as schemas from "./schemas.js";
 /**
  * ─── SUPREME TOOL REGISTRY ─────────────────────────────────────────
  * Every tool is dynamically generated from its Zod schema.
@@ -172,5 +172,27 @@ export const TOOLS = [
         description: "Pause execution and ask the human developer a clarifying question via the terminal.",
         inputSchema: zodToMcpSchema(schemas.AskHumanSchema),
     },
+    // ─── Code Quality ─────────────────────────────────────────────
+    {
+        name: "analyze_code_quality",
+        description: "Analyze code quality in a given path. Checks TypeScript types, lint rules, and code complexity.",
+        inputSchema: zodToMcpSchema(schemas.AnalyzeCodeQualitySchema),
+    },
+    {
+        name: "check_architecture_compliance",
+        description: "Check architecture compliance in a given path. Verifies layer boundaries (Controller→Service→Repository), import direction rules, and strict mode.",
+        inputSchema: zodToMcpSchema(schemas.CheckArchitectureComplianceSchema),
+    },
+    // ─── LLM Gateway ─────────────────────────────────────────
+    {
+        name: "llm_gateway_query",
+        description: "Send a chat completion request through the ATABEY LLM Gateway. The gateway automatically load-balances across providers (OpenAI, Anthropic, Google, Grok, Ollama) using configurable strategies (failover, round-robin, cost-optimized). Allows any MCP-connected AI to route LLM requests through the gateway.",
+        inputSchema: zodToMcpSchema(schemas.LLMGatewayQuerySchema),
+    },
+    {
+        name: "llm_gateway_status",
+        description: "Get the current status of the LLM Gateway including provider health, load balancing strategy, usage statistics, and budget information.",
+        inputSchema: zodToMcpSchema(schemas.LLMGatewayStatusSchema),
+    },
 ];
 //# sourceMappingURL=definitions.js.map

package/dist/framework-mcp/src/tools/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../framework-mcp/src/tools/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../framework-mcp/src/tools/definitions.ts"],"names":[],"mappings":"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"}

package/dist/framework-mcp/src/tools/gateway/llm_gateway_query.d.ts

@@ -0,0 +1,19 @@
+import type { ToolResult } from "../types.js";
+export interface LLMGatewayQueryArgs {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    system?: string;
+    model?: string;
+    provider?: string;
+    strategy?: string;
+    temperature?: number;
+    maxTokens?: number;
+    traceId?: string;
+}
+/**
+ * Handle llm_gateway_query tool call.
+ * Routes the request through the LLM Gateway with load balancing.
+ */
+export declare function handleLLMGatewayQuery(projectRoot: string, args: LLMGatewayQueryArgs): Promise<ToolResult>;