atabey 0.0.11 → 0.0.13

package/README.md

@@ -1,209 +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.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-223%20passed-brightgreen)](https://github.com/ysf-bkr/atabey)
+
+**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.
+
+> **Philosophy:** "Order from Chaos"
+> **How it works:** Install → Connect to your AI → Use `@agent` commands in chat
 
 ---
 
-## [TR] TÜRKÇE — Genel Bakış
+## 🚀 How It Works
 
-**Agent Atabey**, karmaşık, ölçeklenebilir ve yüksek denetim gerektiren kurumsal yazılım projeleri için tasarlanmış bir **"Üstün Yapay Zeka Yönetişimi ve Otonom Orkestrasyon Çerçevesidir"**. Kaotik yapay zeka kodlamasını disiplinli, yönetilebilir ve izlenebilir bir **"Otonom Ordu"** operasyonuna dönüştürür.
+Atabey connects to your AI interface as an **MCP tool server**. Once connected, you use `@agent` commands directly in your AI chat:
 
-### [GOAL] Çözdüğümüz Problemler
-Standart yapay zeka kod asistanları (Claude, Cursor, Aider vb.) bağımsız "kod yazıcılar" olarak çalışır. Sıkı bir yönetişim olmadan bu durum şunlara yol açar:
-- **Kontrolsüz Yapay Zeka (Rogue AI):** Dosyaların tamamının kontrolsüzce yeniden yazılması.
-- **Bağlam Kayması (Context Drift):** Oturumlar arasında ciddi hafıza kaybı.
-- **Token İsrafı:** Optimizasyon eksikliği nedeniyle yüksek API maliyetleri.
-- **Çoklu Ajan Kaosu:** Farklı ajanlar arasında çakışmalar ve yarış durumları.
-- **Kurumsal Kontrol Kaybı:** Denetimsiz CRUD işlemleri ve şema değişiklikleri.
+```
+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
+```
 
-### [START] Temel Özellikler
-- **Çok Dilli İletişim (TR/EN):** Ajan ordusuyla Türkçe veya İngilizce iletişim kurma seçeneği.
-- **Dil Bağımsız Backend Orkestrasyonu:** Go, Java, Python, .NET veya Node.js projeleri için özelleştirilmiş ajan yetenekleri.
-- **Sıkı Yönetişim:** Kritik işlemler için "Human-in-the-Loop" onayı ve Trace ID tabanlı izleme.
-- **Gelişmiş Hafıza Sistemi:** Bağlam kaymasını engelleyen 3 katmanlı hafıza mimarisi.
-- **Dinamik Görev Planlayıcı:** Karmaşık istekleri otonom olarak DAG (Directed Acyclic Graph) yapısında planlama.
-- **Görsel Kontrol Paneli (Hermes UI):** Ajan durumlarını ve bellek akışını anlık izleyen API ve Dashboard desteği.
-- **Token Ekonomisi:** %90'a varan tasarruf sağlayan "Cerrahi Müdahale" (Surgical Edits) mantığı.
-- **Hermes Mesaj Aracısı:** Ajan çakışmalarını engelleyen asenkron, olay tabanlı iletişim.
-- **Güvenli Yerel AI:** %100 veri gizliliği için **Yerel LLM** (Ollama, vLLM) desteği.
+**No separate terminal needed. No CLI commands for daily use.** Just chat with your AI and use `@agent` syntax.
 
 ---
 
-## [EN] ENGLISH — Overview
+## 📋 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)
 
-**Agent Atabey** is an advanced "Supreme AI Governance & Autonomous Orchestration Framework" designed for complex, scalable, and highly auditable enterprise software projects. It transforms chaotic AI coding into a disciplined, governed, and traceable "Autonomous Army" operation.
+---
 
-### [GOAL] The Problem We Solve
-Standard AI coding assistants act as independent "code writers". Without strict governance, this leads to:
-- **Rogue AI:** Uncontrolled rewrites of entire files.
-- **Context Drift:** Severe memory loss between development sessions.
-- **Token Waste:** High API costs due to lack of optimization.
-- **Multi-Agent Chaos:** Conflicts and race conditions between different agents.
-- **Loss of Corporate Control:** Unsupervised CRUD operations and schema changes.
+## Quick Start
 
-### [START] Core Features
-- **Multi-Language Communication (TR/EN):** Option to interact with your agent army in Turkish or English.
-- **Language-Agnostic Backend Orchestration:** Specialized agent capabilities for Go, Java, Python, .NET, or Node.js projects.
-- **Strict Governance:** "Human-in-the-Loop" for critical operations and Trace ID tracking.
-- **Advanced Memory System:** 3-tier architecture that prevents context drift.
-- **Token Economy:** Up to 90% savings via "Surgical Edits" instead of full rewrites.
-- **Hermes Message Broker:** Asynchronous communication preventing agent conflicts.
-- **Private & Secure AI:** Support for **Local LLMs** (Ollama, vLLM) ensuring 100% data privacy.
+### 1. Initialize Atabey in Your Project
 
----
+```bash
+npx atabey init gemini --profile freelancer --yes
+```
 
-## [ARMY] The 13-Agent Specialized Army / 13 Uzman Ajanlık Ordu
+### 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"
+      }
+    }
+  }
+}
+```
 
-| Agent | Tier | Role & Responsibility / Rol ve Sorumluluk |
-| :--- | :--- | :--- |
-| **@manager** | Supreme | **Orchestration & Governance:** Task delegation, memory pruning, compliance. |
-| **@architect**| Core | **System Design:** Core architecture, type contracts, governance locks. |
-| **@analyst** | Core | **Contract Audit:** Verifies requirements map to code; contract-first compliance. |
-| **@security** | Core | **Safety Guardian:** Manages auth, encryption, RLS, and secret protection. |
-| **@backend**  | Core | **Domain Logic:** API design, branded types, and layered architecture. |
-| **@database** | Core | **DB Management:** Schema migrations, query optimization, type-safe access. |
-| **@frontend** | Core | **UI Specialist:** Atomic, responsive-first interfaces, Zero-UI dependency. |
-| **@mobile**   | Core | **Mobile Engineer:** React Native/Expo specialist, offline-first focus. |
-| **@native**   | Core | **Native Division:** OS-level integrations, desktop (Tauri/Electron) layers. |
-| **@quality**  | Recon | **QA & Testing:** Enforces 80% coverage and zero-mock testing policies. |
-| **@explorer** | Recon | **Intel Explorer:** Codebase discovery, dependency mapping, recon reports. |
-| **@git**      | Recon | **Logistics Master:** Version control hygiene, Trace-ID commit enforcement. |
-| **@devops**   | Recon | **Infrastructure:** CI/CD pipelines, containers, immutable deployments. |
+**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
 
-## [SKILL] Core Agent Skills / Temel Ajan Yetenekleri
+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
+```
 
-1.  **[DIR] File System Mastery:** Token-verimli dosya okuma ve yazma.
-2.  **[EDIT] Surgical Modification:** `replace_text` ile milimetrik kod düzenleme.
-3.  **[MSG] Hermes Messaging:** Trace-ID takipli ajanlar arası iletişim.
-4.  **[GOV] Governance & Locking:** OS seviyesinde kaynak kilitleme (Race condition koruması).
-5.  **[SKILL] QA & Discipline:** AST tabanlı kod uyumluluk denetimi ve test kapıları.
-6.  **[DB] Database Excellence:** Tip-güvenli sorgular (Kysely) ve repository desenleri.
-7.  **[START] DevOps Automation:** Güvenli sır (secret) yönetimi ve otonom yayın hatları.
+**That's it.** Atabey handles routing, quality gates, memory, and governance automatically.
 
 ---
 
-## [CONFIG] Structural Modes / Yapısal Modlar
+## How Atabey Plugs Into Your AI
 
-- **Unified Mode (`--unified`):** Tüm AI yapılandırmalarını tek bir `.atabey/` klasöründe toplar. Temiz çalışma alanları için kurumsal standarttır.
-- **Native Mode:** Her AI asistanı için ayrı klasörler (örn: `.claude`, `.gemini`) kullanır.
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                   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)
 
 ---
 
-## [COST] Open Core & Pricing Model / Fiyatlandırma Modeli
+## Installation
+
+### Requirements
 
-Agent Atabey **Open Core** modelini takip eder. Çekirdek çerçeve açık kaynaklıdır (MIT). Kurumsal uyumluluk ve sınırsız ölçeklendirme için **Enterprise Edition** sunulmaktadır.
+| Requirement | Version |
+|------------|---------|
+| **Node.js** | >= 18.0.0 |
+| **npm** | >= 9.0.0 |
+| **AI Interface** | Claude Code, Gemini CLI, Cursor, Codex CLI |
 
-| Feature / Özellik | Community (Free) | Pro ($49/user/month) | Enterprise (Custom) |
-| :--- | :--- | :--- | :--- |
-| **Agent Army** | 13 Standard Agents | 13 Standard + Custom Agents | Unlimited Custom Agents |
-| **Memory System** | Standard 3-Tier Memory | Extended Context & History | Infinite Archival & Vector DB |
-| **Governance** | Basic Rules | Advanced Team Policies | EU AI Act & Full Audit |
-| **Security & RBAC** | Basic Access | Role-Based Workflows | Advanced RLS & SSO |
-| **Support** | Community / GitHub | Standard Email Support | 24/7 SLA & Success Manager |
+### Quick Install
+
+```bash
+# Install globally (recommended)
+npm install -g atabey
+
+# 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
+```
 
 ---
 
-## [TOOLS] Kurulum ve Başlatma / Initializing Framework
+## Profile-Based Setup
 
-`atabey init` komutu, projenizi otonom ajan ordusu yönetimine hazır hale getirir. Kurulum esnasında anayasal kuralları (`ATABEY.md`), platform entegrasyon dosyalarını (shims), mesajlaşma kanallarını, bellek klasörlerini ve MCP (Model Context Protocol) sunucu yapılandırmasını otomatik olarak hazırlar.
+Choose the profile that matches your team size. Atabey automatically configures the right agents, directories, and governance rules.
 
-### [CONFIG] Kurulum Seçenekleri ve Parametreleri (Flags)
-*   **İnteraktif Kurulum:** `npx atabey init` komutuyla iletişim dilinizi ve backend teknolojinizi seçebilirsiniz.
-*   `--unified`: Tüm konfigürasyonu ve ajan tanımlarını tek bir `.atabey/` (veya `.agents/`) klasöründe toplar. Çalışma alanını temiz tutmak için kurumsal standarttır.
-*   `--yes` veya `-y`: Etkileşimli soruları atlayarak varsayılan değerlerle (TR dili, Node.js backend, Modern Mavi tema) hızlı kurulum yapar.
-*   `--dry-run`: Dosya yazmadan sadece kurulum adımlarını simüle eder.
+### `--profile freelancer` (1-3 people)
 
-### [CONN] Desteklenen Adaptör Kurulum Komutları
+```bash
+npx atabey init gemini --profile freelancer
+```
 
-Hangi yapay zeka asistanını veya IDE'yi kullanıyorsanız ona uygun adaptör komutunu çalıştırabilirsiniz:
+| 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 |
+
+### `--profile team` (5-15 people)
 
-#### [GEMINI] Gemini CLI Adaptörü (`gemini`)
-Gemini modelleri için stratejik komuta merkezi yapılandırması sunar.
 ```bash
-# Kurumsal Hızlı Kurulum
-npx atabey init gemini --unified --yes
+npx atabey init gemini --profile team --unified
 ```
-*   **Çalışma Dizini:** `.gemini/`
-*   **Entegrasyon (Shim) Dosyası:** `GEMINI.md`
 
-#### [START] Claude Code Adaptörü (`claude`)
-Anthropic Claude CLI/Code araçları için optimize edilmiş cerrahi müdahale yapılandırmasıdır.
+| 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 |
+
+### `--profile enterprise` (15+ people)
+
 ```bash
-npx atabey init claude --unified --yes
+npx atabey init gemini --profile enterprise
 ```
-*   **Çalışma Dizini:** `.claude/`
-*   **Entegrasyon (Shim) Dosyası:** `CLAUDE.md`
 
-#### [AI] Grok Adaptörü (`grok`)
-xAI Grok arayüzü ve CLI araçları için otonom keşif yapılandırmasıdır.
+| 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 |
+
+### Custom Setup
+
 ```bash
-npx atabey init grok --unified --yes
+npx atabey init gemini
+# Interactive menu: choose agents, directories, colors manually
 ```
-*   **Çalışma Dizini:** `.grok/`
-*   **Entegrasyon (Shim) Dosyası:** `GROK.md`
 
-#### [CURSOR] Cursor IDE Adaptörü (`cursor`)
-Cursor IDE'de otomatik uygulanan kurallar (`.cursor/rules/*.mdc`) oluşturur.
+---
+
+## 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).
+
+### 7. LLM Gateway & Load Balancer
+Load balancing across multiple LLM providers (OpenAI, Anthropic, Google, Groq, Ollama) with circuit breaker, rate limiting, and cost tracking.
+
+### 8. Multi-Platform Support
+Claude Code, Gemini CLI, Cursor, Codex CLI, Antigravity CLI — automatic agent configuration for all platforms.
+
+### 9. Polyglot Backend Support
+Node.js, Go, Java, Python, .NET — automatic scaffolding based on backend language selection.
+
+---
+
+## Dashboard
+
 ```bash
-npx atabey init cursor --yes
+npx atabey dashboard  # Opens at http://localhost:5858
 ```
-*   **Çalışma Dizini:** `.cursor/rules/`
-*   **Ajan Dosya Uzantısı:** `.mdc`
 
-#### [TIP] GitHub Copilot / Codex Adaptörü (`codex`)
-VS Code ve Copilot entegrasyonu için yapılandırılmıştır.
+| 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) |
+
+---
+
+## CLI Reference
+
 ```bash
-npx atabey init codex --yes
+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
 ```
-*   **Çalışma Dizini:** `.agents/`
-*   **Entegrasyon (Shim) Dosyası:** `copilot-instructions.md`
 
-#### [LOCAL] Yerel LLM / Ollama Adaptörü (`local`)
-%100 veri gizliliği sağlamak amacıyla Ollama veya vLLM gibi yerel çalışan LLM'ler için yapılandırılmıştır.
+Full command list: see `atabey help` or [ARCHITECTURE.md](ARCHITECTURE.md)
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                      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)    │  │                              │  │
+│  └──────────────────────────┘  └──────────────────────────────┘  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## LLM Gateway
+
+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
-npx atabey init local --yes
+npx atabey gateway status
+npx atabey gateway configure
 ```
-*   **Çalışma Dizini:** `.atabey/`
-*   **Entegrasyon (Shim) Dosyası:** `LOCAL_AI.md`
 
-#### [ANTIGRAVITY] Antigravity CLI Adaptörü (`antigravity-cli`)
-Atabey'in kendi otonom CLI motoru ve plugin'leri için iç disiplin yapılandırmasıdır.
+---
+
+## 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
-npx atabey init antigravity-cli --yes
+npm test                    # Run all tests (223 passing)
+npm run test:watch          # Watch mode
+npm run test:coverage       # Coverage report
 ```
-*   **Çalışma Dizini:** `.antigravity/`
-*   **Entegrasyon (Shim) Dosyası:** `AGENTS.md`
 
-### [DIR] Kurulum Sonrası Oluşan Klasör ve Dosya Yapısı
+---
 
-Başarılı bir `init` kurulumundan sonra projenizin kök dizininde şu yapı oluşturulur:
+## Contributing
 
-*   **ATABEY.md:** Proje Anayasası (Disiplin Kuralları).
-*   **mcp.json:** Root MCP Sunucu Entegrasyonu.
-*   **.atabey/config.json:** Atabey tema, adaptör ve profil ayarları.
-*   **.atabey/STATUS.md:** Ajan durumlarını gösteren canlı tablo.
-*   **.atabey/messages/:** Ajanlar arası asenkron kuyruk klasörü (.lock dahil).
-*   **.atabey/logs/:** Ajanların işlem logları.
-*   **.atabey/memory/PROJECT_MEMORY.md:** Aktif geliştirme bağlamı ve bellek dosyası.
-*   **.atabey/memory-graph/shared-facts.json:** Proje teknoloji yığını ve temel gerçekleri.
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on the code of conduct and pull request process.
 
-## [NEW] Changelog / Güncellemeler (v0.0.11)
+```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
+```
 
-### [TR] Türkçe
-*   **Taşınabilir MCP Yolları:** `atabey init` esnasında üretilen `mcp.json` ayarlarında yerel `npx` cache veya mutlak kullanıcı yolları yerine, projenin kendi `node_modules/atabey/framework-mcp/dist/index.js` altındaki taşınabilir göreli yollar kullanılmaya başlandı.
-*   **Güvenlik & AST Denetim Açığı Kapatıldı:** `patch_file` aracı da artık anayasal denetim (`verifyCorporateCompliance`) kapsamına alındı. Böylece ajanların `patch_file` ile `any` veya `console.log` yasaklarını delmesi engellendi.
+---
 
-### [EN] English
-*   **Portable MCP Server Paths:** During `atabey init`, generated `mcp.json` configs now use portable relative paths (`node_modules/atabey/...`) instead of local absolute or temporary `npx` cache paths.
-*   **Security & AST compliance hole patched:** Added `verifyCorporateCompliance` check to the `patch_file` tool. Agents can no longer bypass zero-any and zero-console checks via line-range patching.
+## License
 
-## [MAP] Agent Army Visualization / Ajan Ordusu Görseli
+MIT License — [Yusuf BEKAR](mailto:ybekar@msn.com)
 
-![Agent Atabey Army](docs/assets/agent_army_visual.jpg)
+Enterprise inquiries: **ybekar@msn.com**
 
 ---
 
-Developed by **Yusuf BEKAR** | [Enterprise Inquiries](mailto:ybekar@msn.com)
+*Developer: **Yusuf BEKAR** — "Order from Chaos"*

package/bin/completion.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Atabey CLI Bash/Zsh Completion
+# To enable, add this to your .bashrc or .zshrc:
+# source /path/to/atabey/bin/completion.sh
+
+_atabey_completion() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    opts="init check status trace:new trace:replay update_project_memory plan plan:submit orchestrate loop verify-contract update-contract dashboard validate validate-al-registry check:al version help git:commit git:sync check:compliance explorer:graph explorer:audit knowledge:update knowledge:search log:action run-script security:audit check:lint approve create-agent mcp index quickstart"
+
+    if [[ ${cur} == @* ]] ; then
+        local agents="@manager @security @architect @backend @frontend @mobile @quality @database @devops @analyst @native @explorer @git"
+        COMPREPLY=( $(compgen -W "${agents}" -- ${cur}) )
+        return 0
+    fi
+
+    case "${prev}" in
+        atabey)
+            COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+            return 0
+            ;;
+        *)
+            ;;
+    esac
+}
+
+complete -F _atabey_completion atabey

package/bin/{validate-agent-army.js → 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) {
@@ -94,7 +94,7 @@ try {
 
     let totalFailed = 0;
 
-    process.stderr.write(`\n[SECURITY]  STARTING AGENT ARMY AL VALIDATION (${detected.frameworkDir})...\n`);
+    process.stderr.write(`\n[SECURITY]  STARTING AL REGISTRY VALIDATION (${detected.frameworkDir})...\n`);
     process.stderr.write("--------------------------------------------------\n");
     process.stderr.write("| Agent ID  | Format | Status    | Category       |\n");
     process.stderr.write("--------------------------------------------------\n");
@@ -102,8 +102,8 @@ try {
     for (const file of files) {
         const fileName = file.name;
         const filePath = file.path;
-        if (fileName === "agent_army_schema.json" || fileName === "schema") continue;
-        
+        if (fileName === "agent_AL_schema.json" || fileName === "schema") continue;
+
         const content = fs.readFileSync(filePath, "utf8");
         const isMd = fileName.endsWith(".md");