npm - atabey - Versions diffs - 0.0.11 → 0.0.13 - Mend

atabey 0.0.11 → 0.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (522) hide show

package/dist/ui/assets/index-CyXywq5G.css ADDED Viewed

@@ -0,0 +1 @@

+ :root{font-family:Inter,system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#0f172a;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}*{box-sizing:border-box}body{margin:0;display:flex;min-width:320px;min-height:100vh}#root{width:100%}.app-container{padding:1.5rem;max-width:1400px;margin:0 auto}header{margin-bottom:2rem;border-bottom:1px solid #334155;padding-bottom:1rem}.header-top{display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:1rem}h1{margin:0;font-size:1.5rem}.atabey-badge{color:#38bdf8;font-weight:700}.subtitle{color:#64748b;margin:.25rem 0 1rem;font-size:.9rem}.header-status{display:flex;align-items:center;gap:.5rem;font-size:.85rem;color:#22c55e}.status-dot{width:8px;height:8px;border-radius:50%;display:inline-block}.status-dot.live{background-color:#22c55e;box-shadow:0 0 6px #22c55e;animation:pulse 2s infinite}@keyframes pulse{0%,to{opacity:1}50%{opacity:.5}}.nav-tabs{display:flex;gap:.25rem;margin-top:1rem;border-bottom:1px solid #1e293b;padding-bottom:0}.nav-tab{padding:.5rem 1rem;color:#64748b;text-decoration:none;font-size:.9rem;border-radius:6px 6px 0 0;transition:all .2s}.nav-tab:hover{color:#e2e8f0;background:#1e293b}.nav-tab.active{color:#38bdf8;border-bottom:2px solid #38bdf8}main{display:flex;flex-direction:column;gap:1.5rem}section{scroll-margin-top:1rem}.card{background:#1e293b;padding:1.5rem;border-radius:8px;border:1px solid #334155}.card-header{display:flex;justify-content:space-between;align-items:center;margin-bottom:.5rem}.card h2{margin:0;font-size:1.15rem;color:#e2e8f0}.badge{background:#334155;color:#94a3b8;padding:2px 10px;border-radius:12px;font-size:.8rem}footer{margin-top:3rem;padding-top:1.5rem;border-top:1px solid #334155;text-align:center;color:#64748b;font-size:.85rem}footer p{margin:.25rem 0}.footer-links{display:flex;justify-content:center;gap:.5rem;align-items:center}.footer-links a{color:#38bdf8;text-decoration:none}.footer-links a:hover{text-decoration:underline}.sep{color:#334155}@media(max-width:768px){.app-container{padding:1rem}.header-top{flex-direction:column;align-items:flex-start}.nav-tabs{overflow-x:auto;-webkit-overflow-scrolling:touch}.card{padding:1rem}}

package/dist/ui/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Hermes Control Center | Agent Atabey</title>
-    <script type="module" crossorigin src="/assets/index-CeX-06mI.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-Bkt7APzu.css">
+    <script type="module" crossorigin src="/assets/index-B-d2ejS8.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CyXywq5G.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/vitest.config.js CHANGED Viewed

@@ -7,12 +7,12 @@ export default defineConfig({
         cache: false,
         coverage: {
             provider: "v8",
-            reporter: ["text", "json", "html"],
+            reporter: ["text", "json", "html", "json-summary"],
             thresholds: {
-                lines: 80,
-                functions: 80,
-                branches: 80,
-                statements: 80,
+                lines: 40,
+                functions: 40,
+                branches: 40,
+                statements: 40,
             },
         },
     },

package/dist/vitest.config.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;QACnE,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;~~YAClC~~,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}
1	+ {"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IACxB,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,EAAE,kCAAkC,CAAC;QACnE,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC;YAClD,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACjB;SACJ;KACJ;CACJ,CAAC,CAAC"}

package/framework-mcp/README.md CHANGED Viewed

@@ -1,48 +1,362 @@
 # Agent Atabey — MCP Server (`atabey-mcp`)
-[![Version](https://img.shields.io/npm/v/atabey-mcp.svg)](https://npmjs.com/package/atabey-mcp)
+[![Version](https://img.shields.io/npm/v/atabey-mcp.svg)](https://www.npmjs.com/package/atabey-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm](https://img.shields.io/npm/dt/atabey-mcp)](https://www.npmjs.com/package/atabey-mcp)
-The **Model Context Protocol (MCP)** server for [Agent Atabey](https://npmjs.com/package/atabey).
+The **Model Context Protocol (MCP)** server for [Agent Atabey](https://www.npmjs.com/package/atabey).
-This package acts as the bridge between AI Assistants (like Claude Desktop, Cursor, or Antigravity CLI) and your local project environment. It provides a highly governed, type-safe set of tools that allow AI agents to interact with your codebase securely.
+This package bridges AI assistants (Claude Code, Gemini CLI, Cursor, Codex, Antigravity) with your local project environment. Provides **30+ secure, audited, type-safe tools** across 10 categories. Includes the **Hermes Control Center** dashboard with 8 live modules.
-## 🚀 Features
+> **Main Package:** [`atabey`](https://www.npmjs.com/package/atabey) (CLI + Framework)
-- **Strict Governance:** Enforces Zero Type Hole and Zero Console policies via AST parsing.
-- **Surgical Edits:** Uses `patch_file` and `replace_text` instead of full-file rewrites to save tokens and prevent context loss.
-- **Hermes Message Broker:** Facilitates asynchronous communication between specialized agents (`@manager`, `@architect`, `@security`, etc.).
-- **Memory Insights:** Provides agents with targeted, pruned context (last 5 actions, active trace) instead of dumping the entire project history.
-- **Risk Engine:** Automatically blocks or requires human approval for high-risk operations (e.g., deleting databases, touching `.env` files).
+---
+## 📋 Table of Contents
+- [Installation](#installation)
+- [How It Works](#how-it-works)
+- [Hermes Control Center Dashboard](#hermes-control-center-dashboard)
+- [Provided Tools (30+)](#provided-tools-30)
+- [MCP Configuration](#mcp-configuration)
+- [Development](#development)
+- [Testing](#testing)
-## 📦 Installation
+---
-Typically, you do not need to install this package manually. It is automatically installed and configured when you initialize an Atabey project:
+## Installation
 ```bash
-npx atabey init
+# Run with npx (no install needed)
+npx atabey-mcp
+# Global install
+npm install -g atabey-mcp
+# Add to project
+npm install atabey-mcp
+```
+---
+## How It Works
+Atabey MCP Server connects your AI assistant to your project via the **Model Context Protocol**:
+```
+AI Assistant (Claude/Gemini/Cursor)
+       │
+       ▼  MCP Protocol (stdio transport)
+       │
+Atabey MCP Server (30+ tools)
+       │
+       ▼
+Your Project (files, database, git, shell)
 ```
-However, you can install it globally or locally if needed:
+When you type `@backend Create login API` in your AI chat:
+1. The AI calls `send_agent_message` tool via MCP
+2. Atabey routes it through `RoutingEngine`
+3. The `@backend` agent executes the task
+4. `QualityGate` validates the output
+5. Result is stored in `Vector Memory`
+**No separate terminal needed. No CLI commands for daily use.**
+---
+## Hermes Control Center Dashboard
+The MCP package includes a real-time WebSocket dashboard with 8 live modules:
+| Module | Description | Update |
+|--------|-------------|--------|
+| 🤖 **Agent Monitor** | 13 AI agent status + live tasks | WS (5s) |
+| 📨 **Hermes Messages** | Agent message queue + filtering | WS (5s) |
+| 🔐 **Approval Center** | Human-in-the-Loop approvals | WS |
+| 📋 **Task Planner** | Task DAG + progress tracking | REST (5s) |
+| 📝 **Agent Logs** | Execution logs + agent filter | WS (5s) |
+| ⚠️ **Error Tracker** | Lint/compliance/security errors | WS |
+| 🧠 **Memory Insights** | Vector memory search | REST |
+| 🛡️ **Compliance** | Quality gate violations | REST (15s) |
 ```bash
-npm install atabey-mcp
+# Start dashboard (default port: 5858)
+npx atabey dashboard
+# Browser: http://localhost:5858
+```
+### Dashboard Components
 ```
+framework-mcp/dashboard/src/
+├── App.tsx                    # Main app, routing and WS management
+├── main.tsx                   # React entry point
+├── styles.ts                  # PandaCSS styles
+├── components/
+│   ├── AdapterSkillsPanel.tsx # Adapter skill mapping
+│   ├── AgentMonitor.tsx       # Agent status monitoring
+│   ├── ApprovalCenter.tsx     # Approval center
+│   ├── CompliancePanel.tsx    # Compliance control panel
+│   ├── ErrorTracker.tsx       # Error tracking
+│   ├── GatewayPanel.tsx       # LLM Gateway management
+│   ├── HermesBrokerView.tsx   # Hermes message queue
+│   ├── HermesStats.tsx        # Hermes statistics
+│   ├── LogViewer.tsx          # Log viewer
+│   ├── MemoryInsights.tsx     # Memory insights
+│   ├── PlanViewer.tsx         # Plan viewer
+│   └── QualityPanel.tsx       # Quality panel
+└── hooks/
+    ├── useApi.ts              # REST API hook
+    └── useWS.ts               # WebSocket hook
+```
+---
+## Provided Tools (30+)
+### File System
+| Tool | Description | Zod Validation |
+|------|-------------|----------------|
+| `read_file` | Read file content with line range | ✅ |
+| `write_file` | Atomic file write with directory creation | ✅ |
+| `replace_text` | Surgical text replacement | ✅ |
+| `patch_file` | Safe line-range update | ✅ |
+| `batch_surgical_edit` | Multi-file batch editing | ✅ |
+### Search & Exploration
+| Tool | Description |
+|------|-------------|
+| `list_dir` | List directory contents |
+| `grep_search` | Recursive regex search |
+| `get_project_map` | Project structure tree |
+| `get_project_gaps` | Find TODOs, FIXMEs, gaps |
+### Control Plane
+| Tool | Description |
+|------|-------------|
+| `acquire_lock` | Acquire resource lock |
+| `release_lock` | Release resource lock |
+| `register_agent` | Register agent instance |
+### Messaging (Hermes Protocol)
+| Tool | Description |
+|------|-------------|
+| `send_agent_message` | Hermes protocol messaging |
+| `log_agent_action` | Log agent actions |
+| `ask_human` | Wait for human input |
-## 🛠️ Provided Tools
+### Memory
-The `atabey-mcp` server exposes over 25 specialized tools grouped into the following domains:
+| Tool | Description |
+|------|-------------|
+| `read_project_memory` | Read central memory |
+| `update_project_memory` | Update memory section |
+| `get_memory_insights` | Memory summaries |
+| `store_knowledge` | Store vector knowledge |
+| `search_knowledge` | Search vector memory |
+| `delete_knowledge` | Delete knowledge entry |
-- **File System:** `read_file`, `write_file`, `replace_text`, `patch_file`, `batch_surgical_edit`
-- **Control Plane:** `acquire_lock`, `release_lock`, `register_agent`
-- **Framework & Orchestration:** `submit_plan`, `orchestrate_loop`, `update_project_memory`, `audit_dependencies`
-- **Search & Map:** `grep_search`, `list_dir`, `get_architectural_map`, `get_knowledge_gaps`
-- **Quality & Observability:** `check_lint`, `run_tests`, `get_system_health`, `check_ports`
-- **Messaging:** `send_agent_message`, `log_agent_action`
+### Framework & Quality
-## 📖 Learn More
+| Tool | Description |
+|------|-------------|
+| `get_framework_status` | Framework status |
+| `run_tests` | Run test suites |
+| `check_lint` | Run ESLint |
+| `update_contract_hash` | Sync contract hash |
+| `orchestrate_loop` | Process Hermes messages |
+| `submit_plan` | Submit DAG task plan |
+| `audit_dependencies` | Audit package.json |
+| `get_system_health` | CPU/RAM metrics |
+| `check_active_ports` | Port monitoring |
-For full documentation, architecture details, and enterprise inquiries, please visit the main [Agent Atabey Repository](https://github.com/ysf-bkr/atabey).
+### Quality
+| Tool | Description |
+|------|-------------|
+| `analyze_code_quality` | Code quality analysis |
+| `check_architecture_compliance` | Architecture compliance check |
+| `check_lint` | ESLint validation |
+### Observability
+| Tool | Description |
+|------|-------------|
+| `get_health` | System health |
+| `check_ports` | Port status |
+### Shell
+| Tool | Description |
+|------|-------------|
+| `run_shell_command` | Execute shell commands |
 ---
-*Developed by Yusuf BEKAR*
+## LLM Gateway Tools
+### `llm_gateway_query`
+Sends queries to LLM providers with load balancing, circuit breaker, and rate limiting.
+**Parameters:**
+- `provider` (string): LLM provider name (`openai`, `anthropic`, `google`, `groq`, `ollama`)
+- `model` (string): Model name
+- `messages` (array): Chat messages
+- `options` (object, optional): Temperature, max tokens, etc.
+### `llm_gateway_status`
+Returns gateway status and provider statistics.
+**Supported Providers:**
+| Provider | Models | Status |
+|----------|--------|--------|
+| OpenAI | GPT-4, GPT-4o, o3, o4-mini | ✅ |
+| Anthropic | Claude Opus 4.5, Sonnet 4.5, Haiku 3.5 | ✅ |
+| Google | Gemini 2.5 Pro, Flash, Flash-Lite | ✅ |
+| Groq | Llama, Mixtral | ✅ |
+| Ollama | Local models | ✅ |
+---
+## MCP Configuration
+### Claude Code
+Add to your `mcp.json`:
+```json
+{
+  "mcpServers": {
+    "atabey": {
+      "command": "npx",
+      "args": ["atabey-mcp"],
+      "env": {
+        "ATABEY_PROJECT_ROOT": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+### Environment Variables
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ATABEY_PROJECT_ROOT` | Project root directory | `process.cwd()` |
+| `PORT` or `DASHBOARD_PORT` | Dashboard port | `5858` |
+| `NODE_ENV` | Environment (production/development) | `development` |
+### 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"]
+    }
+  }
+}
+```
+---
+## Development
+```bash
+# Install dependencies
+npm install
+# Build
+npm run build
+# Build dashboard
+npm run build --prefix dashboard
+# Development mode
+npm run dev
+```
+### Project Structure
+```
+framework-mcp/
+├── src/
+│   ├── index.ts            # MCP Server (Stdio Transport)
+│   ├── constants.ts        # MCP-specific constants
+│   ├── declarations.d.ts   # Type declarations
+│   ├── resources/          # MCP Resources
+│   ├── tools/
+│   │   ├── definitions.ts  # Tool definitions
+│   │   ├── index.ts        # Tool handlers
+│   │   ├── schemas.ts      # Zod validation schemas
+│   │   ├── types.ts        # Tool types
+│   │   ├── control_plane/  # Lock, Registry
+│   │   ├── file_system/    # Read, Write, Edit, Patch
+│   │   ├── framework/      # Status, Test, Orchestrate
+│   │   ├── gateway/        # LLM Gateway
+│   │   ├── memory/         # Knowledge management
+│   │   ├── messaging/      # Hermes messaging
+│   │   ├── observability/  # Health, Port
+│   │   ├── quality/        # Code quality
+│   │   ├── search/         # Grep, Map, Gap
+│   │   └── shell/          # Command execution
+│   └── utils/              # Utilities
+├── dashboard/              # React Dashboard
+└── tests/                  # Tests
+```
+---
+## Testing
+```bash
+# Run all tests
+npm test
+# Run specific test
+npx vitest run tests/tools/file_system/file_system_tools.test.ts
+```
+### Current Test Files
+| Test File | Scope |
+|-----------|-------|
+| `file_system/file_system_tools.test.ts` | Basic file system tools |
+| `file_system/compliance-risk.test.ts` | Compliance risk analysis |
+| `file_system/permissions.test.ts` | Permission controls |
+| `messaging/send_message.test.ts` | Hermes messaging |
+| `quality/check_lint.test.ts` | ESLint validation |
+| `shell/run_command.test.ts` | Shell commands |
+> **Note:** Gateway module tests are in the main package: `tests/modules/gateway/`
+---
+## More Information
+- **Main Package:** [`atabey`](https://www.npmjs.com/package/atabey) (CLI + Framework)
+- **GitHub:** [github.com/ysf-bkr/atabey](https://github.com/ysf-bkr/atabey)
+- **Documentation:** [ARCHITECTURE.md](../ARCHITECTURE.md)
+- **Contributing:** [CONTRIBUTING.md](../CONTRIBUTING.md)
+- **Enterprise:** ybekar@msn.com
+---
+*Developer: **Yusuf BEKAR** — "Order from Chaos"*