agdi 2.6.0 → 2.6.2

package/README.md

@@ -1,25 +1,24 @@
 <div align="center">
 
 ```
-    ___              __ _  
-   /   |  ____ _____/ /(_) 
-  / /| | / __ `/ __  // /  
- / ___ |/ /_/ / /_/ // /   
-/_/  |_|\_, /\__,_//_/    
-       /____/              
+      ___   __________  ____
+     /   | / ____/ __ \/  _/
+    / /| |/ / __/ / / // /  
+   / ___ / /_/ / /_/ // /   
+  /_/  |_\____/_____/___/   
+                            
 ```
 
 # agdi
 
-### The AI-Powered Coding Assistant for Your Terminal
+### The AI-Powered Terminal Architect
 
-[![npm version](https://img.shields.io/npm/v/agdi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/agdi)
-[![npm downloads](https://img.shields.io/npm/dw/agdi?style=for-the-badge&logo=npm&logoColor=white&color=4FC08D)](https://www.npmjs.com/package/agdi)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![npm](https://img.shields.io/npm/v/agdi?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/agdi)
+[![downloads](https://img.shields.io/npm/dw/agdi?style=for-the-badge&logo=npm&color=4FC08D)](https://www.npmjs.com/package/agdi)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js)](https://nodejs.org/)
 
-**Build full-stack apps from natural language • Multi-Agent AI • Codebase RAG • Enterprise Security**
+**Build apps from natural language • Multi-Agent AI • Cinematic Dark Mode**
 
 [Website](https://agdi-dev.vercel.app) · [npm](https://www.npmjs.com/package/agdi) · [GitHub](https://github.com/anassagd432/Agdi-dev)
 
@@ -27,27 +26,83 @@
 
 ---
 
-## 🚀 What's New in v2.6
+## 🎬 Cinematic Dark Mode (v2.6.1)
+
+<div align="center">
+  <img src="https://img.shields.io/badge/NEW-Premium_Terminal_UI-blueviolet?style=for-the-badge" alt="New">
+</div>
+
+### ✨ Visual Upgrade
+
+| Component | What It Looks Like |
+|-----------|-------------------|
+| **Neon Banner** | Cyan-to-Purple gradient ASCII art on startup |
+| **Glass Cards** | Rounded boxen panels for plans and status |
+| **Chat Bubbles** | `👤 YOU ›` and `⚡ AGDI ›` styled prompts |
+| **Security Alerts** | Red double-bordered warnings |
+| **Spinners** | Smooth cyan dots animation |
+
+### 🖥️ Startup Experience
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                                                              │
+│      ___   __________  ____                                  │
+│     /   | / ____/ __ \/  _/      ← Neon Gradient             │
+│    / /| |/ / __/ / / // /                                    │
+│   / ___ / /_/ / /_/ // /                                     │
+│  /_/  |_\____/_____/___/                                     │
+│                                                              │
+│           v2.6.1 [ARCHITECT ONLINE]                          │
+│                                                              │
+├──────────────────────────────────────────────────────────────┤
+│ ╭─ SESSION INFO ─────────────────────────────────────────╮   │
+│ │                                                        │   │
+│ │  Model:     gemini-2.5-flash                           │   │
+│ │  Workspace: ~/projects/my-app                          │   │
+│ │  Context:   Git Repository                             │   │
+│ │                                                        │   │
+│ ╰────────────────────────────────────────────────────────╯   │
+│                                                              │
+│ ──────────────────────────────────────────────────────────── │
+│                                                              │
+│ 👤 YOU › create a dashboard with charts                      │
+│                                                              │
+│ ⚡ AGDI ›                                                     │
+│ I'll create a modern dashboard with Recharts...              │
+│                                                              │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## ⚡ Quick Start
+
+```bash
+npm install -g agdi
+agdi
+```
+
+---
+
+## 🎯 What's New in v2.6
 
 <table>
 <tr>
 <td width="50%">
 
 ### 🤖 Multi-Agent System
-Planner → Coder → Reviewer pipeline. Your code is reviewed by AI before delivery.
-
 ```bash
 → /agent
 🤖 Multi-agent mode: ON
-  Planner → Coder → Reviewer pipeline enabled
+   Planner → Coder → Reviewer
 ```
+Your code is reviewed by AI before delivery.
 
 </td>
 <td width="50%">
 
 ### 🔍 Codebase RAG
-Index and search your entire project semantically. The AI understands your code.
-
 ```bash
 → /index
 ✓ Indexed 47 files, 312 chunks
@@ -61,9 +116,7 @@ Index and search your entire project semantically. The AI understands your code.
 <tr>
 <td width="50%">
 
-### 🔧 MCP Tool Integration
-Model Context Protocol for standardized AI tool calls.
-
+### 🔧 MCP Tools
 ```bash
 → /tools
 🔧 Available Tools
@@ -76,8 +129,6 @@ Model Context Protocol for standardized AI tool calls.
 <td width="50%">
 
 ### 🧠 Persistent Memory
-AI remembers your preferences and project context across sessions.
-
 ```bash
 → /memory
 🧠 Memory Stats
@@ -92,433 +143,134 @@ AI remembers your preferences and project context across sessions.
 
 ---
 
-## ⚡ Quick Start
-
-```bash
-# Install globally
-npm install -g agdi
-
-# Start coding
-agdi
-```
-
-That's it. Agdi handles the rest.
-
----
-
-## 🎬 Demo
-
-```
-$ agdi
-
-⚡ Agdi dev
-
-Model: gemini-2.5-flash
-Workspace: ~/projects/my-app
-Commands: /status, /diff, /commit, /build, /index, /search, /agent, /help, /exit
-
-──────────────────────────────────────────────────
-
-→ /agent
-🤖 Multi-agent mode: ON
-
-→ create a todo app with dark mode and local storage
-
-📋 Phase 1: Planning...
-  ✓ Plan created
-
-💻 Phase 2: Coding...
-  ✓ Code generated
-
-🔍 Phase 3: Review (iteration 1)...
-  ✓ Code approved!
-
-✅ Multi-Agent Pipeline Complete
-
-📋 Action Plan - todo-app
-   ─────────────────────────
-   ✓ mkdir src
-   ✓ writeFile package.json
-   ✓ writeFile src/App.tsx
-   ✓ writeFile src/index.css
-   ✓ exec pnpm install
-
-✅ Project created! Run: cd todo-app && pnpm dev
-```
-
----
-
-## ✨ Features
-
-<table>
-<tr>
-<td width="50%">
-
-### 🤖 AI-Powered Development
-- **Natural language to code** — Describe what you want, get production-ready apps
-- **Conversation memory** — AI remembers context across messages
-- **Multi-agent mode** — Planner, Coder, Reviewer pipeline
-- **Codebase RAG** — AI understands your entire project
-
-</td>
-<td width="50%">
-
-### 🔧 Built-in Git Integration
-- `/status` — AI analysis of your repo state
-- `/diff` — Smart explanation of your changes
-- `/commit` — Auto-generated conventional commits
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 🛡️ Enterprise Security
-- **Permission Gate** — 4-tier command risk classification
-- **Workspace Trust** — Per-directory security boundaries
-- **Code Firewall** — Real-time secret/injection scanning
-- **Audit Logging** — OWASP-aligned decision logs
-
-</td>
-<td width="50%">
-
-### 🌐 Multi-Provider AI
-- **Gemini** — Free tier, fast responses
-- **OpenRouter** — 400+ models, one API
-- **OpenAI** — GPT-4o, o3 reasoning
-- **Anthropic** — Claude 4.5 Sonnet
-- **DeepSeek** — R1, V3 models
-- **Puter** — 100% free, no key needed
-
-</td>
-</tr>
-</table>
-
----
-
-## 📋 Commands Reference
-
-### Interactive Mode (Default)
-
-```bash
-agdi              # Start interactive coding session
-```
-
-Inside the session:
+## 📋 Commands
 
 | Command | Description |
 |---------|-------------|
-| `/build <prompt>` | Generate & execute an app from description |
+| `/build <prompt>` | Generate & execute an application |
 | `/edit <file>` | AI-powered surgical file editing |
-| `/index` | 🆕 Index current project for RAG search |
-| `/search <query>` | 🆕 Semantic code search |
-| `/tools` | 🆕 List available MCP tools |
-| `/agent` | 🆕 Toggle multi-agent mode |
-| `/memory` | 🆕 View persistent memory stats |
-| `/status` | AI analysis of git status |
-| `/diff` | AI explanation of current changes |
-| `/commit` | Auto-generate & run git commit |
-| `/clear` | Clear conversation history |
-| `/history` | Show recent conversation |
+| `/index` | Index project for semantic search |
+| `/search <query>` | Search codebase with AI |
+| `/agent` | Toggle multi-agent mode |
+| `/tools` | List MCP tools |
+| `/memory` | View persistent memory |
+| `/status` | AI git status analysis |
+| `/diff` | AI change explanation |
+| `/commit` | Auto-generate commit message |
+| `/clear` | Clear conversation |
+| `/history` | Show recent messages |
 | `/model` | Change AI model |
 | `/help` | Show all commands |
 | `/exit` | Exit Agdi |
 
-### Direct Commands
-
-```bash
-agdi build "todo app"     # Generate app directly
-agdi chat                 # Simple chat mode
-agdi auth                 # Configure API keys
-agdi model                # Change AI model
-agdi config               # Show configuration
-agdi run [dir]            # Run a generated project
-```
-
 ---
 
-## 🤖 Multi-Agent Architecture (v2.6)
-
-Enable with `/agent` for higher quality code:
+## 🤖 Multi-Agent Pipeline
 
 ```
-┌──────────────────────────────────────────────────────────┐
-│  User Request                                            │
-└─────────────────────────┬────────────────────────────────┘
-                          ▼
-┌──────────────────────────────────────────────────────────┐
-│  📋 PLANNER AGENT                                        │
-│  Analyzes request, creates step-by-step implementation   │
-│  plan, identifies files to create/modify                 │
-└─────────────────────────┬────────────────────────────────┘
-                          ▼
-┌──────────────────────────────────────────────────────────┐
-│  💻 CODER AGENT                                          │
-│  Writes production-ready TypeScript/React code           │
-│  following the plan                                      │
-└─────────────────────────┬────────────────────────────────┘
-                          ▼
-┌──────────────────────────────────────────────────────────┐
-│  🔍 REVIEWER AGENT                                       │
-│  Reviews for:                                            │
-│  • Correctness • Security • Performance • Completeness  │
-│                                                          │
-│  → APPROVED: Code delivered to user                      │
-│  → NEEDS_CHANGES: Sent back to CODER (max 3 loops)       │
-└─────────────────────────┬────────────────────────────────┘
-                          ▼
-┌──────────────────────────────────────────────────────────┐
-│  ✅ High-Quality, Reviewed Code                          │
-└──────────────────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────────────┐
+│  📋 PLANNER AGENT                                           │
+│  Analyzes request → Creates step-by-step plan               │
+└─────────────────────────────┬───────────────────────────────┘
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  💻 CODER AGENT                                             │
+│  Writes production-ready TypeScript/React code              │
+└─────────────────────────────┬───────────────────────────────┘
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  🔍 REVIEWER AGENT                                          │
+│  • Correctness  • Security  • Performance                   │
+│                                                             │
+│  ✅ APPROVED → Delivered to user                            │
+│  ⚠️ NEEDS_CHANGES → Back to CODER (max 3 loops)             │
+└─────────────────────────────────────────────────────────────┘
 ```
 
 ---
 
-## 🔍 Codebase RAG (v2.6)
+## 🛡️ Zero-Trust Security
 
-Index your project so AI can understand all your code:
+### Permission Tiers
 
-```bash
-# Index your project (creates searchable chunks)
-→ /index
-✓ Indexed 47 files, 312 chunks
+| Tier | Risk | Examples | Default |
+|------|------|----------|---------|
+| 0 | Read-only | `ls`, `cat`, `git status` | Auto-approve |
+| 1 | Workspace | `touch`, `mkdir`, `git commit` | Prompt once |
+| 2 | System | `npm install`, `docker run` | Always prompt |
+| 3 | Dangerous | `sudo`, `rm -rf`, `curl\|bash` | Block |
 
-# Semantic search
-→ /search user authentication
-🔍 Search Results
-  src/auth/login.ts:15 (0.87)
-    export async function authenticateUser...
-  src/middleware/auth.ts:1 (0.65)
-    import { verifyToken } from...
-  src/hooks/useAuth.ts:5 (0.52)
-    const AuthContext = createContext...
-```
+### Security Alert (v2.6.1 Style)
 
-**How it works:**
-1. **Indexer** walks your project, chunks code by functions/classes
-2. **Retriever** uses TF-IDF semantic search (no external vector DB)
-3. **Context** is automatically injected into AI prompts
-
----
-
-## 🛡️ Security Architecture
-
-Agdi includes **zero-trust security** designed for safe AI-assisted development:
-
-### 🚦 Permission Gate
-
-Every command is classified by risk level:
-
-```
-┌─────────┬──────────────┬────────────────────────────┬──────────────┐
-│  Tier   │  Risk Level  │         Examples           │   Default    │
-├─────────┼──────────────┼────────────────────────────┼──────────────┤
-│    0    │  Read-only   │  ls, cat, git status       │ Auto-approve │
-│    1    │  Workspace   │  touch, mkdir, git commit  │ Prompt once  │
-│    2    │  System      │  npm install, docker run   │ Always prompt│
-│    3    │  Dangerous   │  sudo, rm -rf, curl|bash   │ Block        │
-└─────────┴──────────────┴────────────────────────────┴──────────────┘
 ```
-
-### 🔐 Approval Options
-
-When prompted:
-- **[A]** Approve once
-- **[S]** Approve for session  
-- **[+]** Always allow (saved rule)
-- **[?]** Always prompt (saved rule)
-- **[-]** Always forbid (saved rule)
-- **[D]** Deny
-
-### 🏢 Workspace Trust
-
-First run in any directory triggers trust verification:
-- Trust for session only
-- Trust and remember permanently
-- Exit without trust (read-only mode)
-
-### 🔥 Code Firewall
-
-Real-time scanning detects:
-- **22+ secret patterns** — AWS, GitHub, OpenAI, Anthropic, Stripe, etc.
-- **Shell injection** — Dangerous command patterns
-- **Prompt injection** — LLM manipulation attempts
-- **Network exfiltration** — Suspicious external requests
-
-### 📊 Audit Logging
-
-All decisions logged to `~/.agdi/audit.jsonl`:
-
-```json
-{"ts":"2026-01-22T00:30:00Z","action":"approve","tier":1,"cmd":"git commit","reason":"session"}
+╔══════════════════════════════════════════════════════════════╗
+║ 🛡️  UNTRUSTED WORKSPACE                                      ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║   The agent wants to execute 5 actions in this folder.       ║
+║   This includes writing files and/or running commands.       ║
+║                                                              ║
+║   Target: /Users/dev/projects/my-app                         ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+
+? Trust this workspace?
+❯ Trust for this session
+  Trust and remember
+  Cancel
 ```
 
 ---
 
-## 🤖 Supported Models
+## 🌐 AI Providers
 
-### Free Models (OpenRouter - No Credits Needed)
+### Free Models (No API Key)
 
 | Model | ID | Best For |
 |-------|-----|----------|
-| GPT-OSS 120B | `openai/gpt-oss-120b:free` | General coding |
-| GPT-OSS 20B | `openai/gpt-oss-20b:free` | Fast responses |
-| Qwen3 Coder | `qwen/qwen3-coder:free` | Code generation |
-| Qwen3 Next 80B | `qwen/qwen3-next-80b-a3b-instruct:free` | Complex tasks |
-| Kimi K2 | `moonshotai/kimi-k2:free` | General purpose |
-| Gemma 3N E2B | `google/gemma-3n-e2b-it:free` | Lightweight |
-| LFM Thinking | `liquid/lfm-2.5-1.2b-thinking:free` | Agentic tasks |
-
-### Image Generation
-
-| Model | ID | Description |
-|-------|-----|-------------|
-| Seedream 4.5 | `bytedance-seed/seedream-4.5` | Auto-generates project images |
+| GPT-OSS 120B | `openai/gpt-oss-120b:free` | General |
+| Qwen3 Coder | `qwen/qwen3-coder:free` | Code |
+| Kimi K2 | `moonshotai/kimi-k2:free` | General |
 
 ### Bring Your Own Key
 
-<table>
-<tr>
-<td>
-
-**Google Gemini** 🔥
-- Gemini 2.5 Flash ⚡
-- Gemini 2.5 Pro 🚀
-- Gemini 2.0 Flash
-
-</td>
-<td>
-
-**OpenRouter** 🌐
-- Claude 4.5 Sonnet
-- GPT-5 / GPT-4o
-- Llama 4 Maverick
-- DeepSeek R1
-- 400+ more
-
-</td>
-<td>
-
-**OpenAI** 🧠
-- GPT-5
-- GPT-4o
-- o3
-- o1
-
-</td>
-</tr>
-<tr>
-<td>
-
-**Anthropic** 💜
-- Claude 4.5 Sonnet
-- Claude 4.5 Opus
-- Claude 3.5 Sonnet
-
-</td>
-<td>
-
-**DeepSeek** 🌊
-- DeepSeek V3.2
-- DeepSeek R1 (Reasoning)
-
-</td>
-<td>
-
-**Get Keys** 🔑
-- [Gemini](https://aistudio.google.com/apikey)
-- [OpenRouter](https://openrouter.ai/keys)
-- [OpenAI](https://platform.openai.com/api-keys)
-- [Anthropic](https://console.anthropic.com/)
-- [DeepSeek](https://platform.deepseek.com/)
-
-</td>
-</tr>
-</table>
+| Provider | Models | Get Key |
+|----------|--------|---------|
+| **Gemini** 🔥 | 2.5 Flash, 2.5 Pro | [aistudio.google.com](https://aistudio.google.com/apikey) |
+| **OpenRouter** | Claude, GPT-4o, Llama | [openrouter.ai](https://openrouter.ai/keys) |
+| **OpenAI** | GPT-5, o3 | [platform.openai.com](https://platform.openai.com/api-keys) |
+| **Anthropic** | Claude 4.5 Sonnet | [console.anthropic.com](https://console.anthropic.com/) |
 
 ---
 
 ## ⚙️ Configuration
 
-Config stored in `~/.agdi/`:
-
 ```
 ~/.agdi/
 ├── config.json              # API keys & settings
 ├── rules.json               # Permission rules
 ├── trusted-workspaces.json  # Trusted directories
-├── memory/                  # 🆕 Persistent memory
+├── memory/                  # Persistent memory
 │   └── store.json
-├── indexes/                 # 🆕 RAG indexes
+├── indexes/                 # RAG indexes
 └── audit.jsonl              # Audit log
 ```
 
-```bash
-# Interactive setup
-agdi auth
-
-# Show config
-agdi config
-
-# Check auth status
-agdi auth --status
-```
-
 ---
 
 ## 📊 Quality Metrics
 
-<table>
-<tr>
-<td align="center">
-<h3>0</h3>
-<p>TypeScript Errors</p>
-</td>
-<td align="center">
-<h3>60</h3>
-<p>Tests Passing</p>
-</td>
-<td align="center">
-<h3>148 KB</h3>
-<p>Build Size</p>
-</td>
-<td align="center">
-<h3>22+</h3>
-<p>Security Patterns</p>
-</td>
-<td align="center">
-<h3>900+</h3>
-<p>Weekly Downloads</p>
-</td>
-</tr>
-</table>
-
----
-
-## 🚀 Examples
-
-```bash
-# Create a full-stack app (multi-agent recommended)
-agdi
-→ /agent
-→ Create a blog with authentication and markdown support
-
-# Semantic search your codebase
-agdi
-→ /index
-→ /search payment processing
+<div align="center">
 
-# AI-powered file editing
-agdi
-→ /edit src/components/Header.tsx
-"Add a dark mode toggle button"
+| Metric | Value |
+|--------|-------|
+| TypeScript Errors | **0** |
+| Tests Passing | **60** |
+| Build Size | **150 KB** |
+| Security Patterns | **22+** |
+| Weekly Downloads | **900+** |
 
-# Interactive development
-agdi
-→ Help me debug this React component
-→ Add dark mode to my app
-→ Explain this TypeScript error
-```
+</div>
 
 ---
 
@@ -526,20 +278,18 @@ agdi
 
 - **Runtime**: Node.js 18+
 - **Language**: TypeScript 5.4
-- **CLI Framework**: Commander.js
-- **Prompts**: Inquirer
-- **Styling**: Chalk, Ora
+- **CLI**: Commander, Inquirer
+- **UI**: Chalk, Ora, Boxen, Gradient-string, Figlet
 - **Build**: tsup
 - **Testing**: Vitest
-- **AI**: Multi-agent, RAG, Token Optimization
 
 ---
 
 ## 🔗 Links
 
-- 🌐 **Website**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
-- 📦 **npm**: [npmjs.com/package/agdi](https://www.npmjs.com/package/agdi)
-- 🐙 **GitHub**: [github.com/anassagd432/Agdi-dev](https://github.com/anassagd432/Agdi-dev)
+- 🌐 [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
+- 📦 [npmjs.com/package/agdi](https://www.npmjs.com/package/agdi)
+- 🐙 [github.com/anassagd432/Agdi-dev](https://github.com/anassagd432/Agdi-dev)
 
 ---