dolphin-server-modules 2.9.4 → 2.9.6

package/README.md

@@ -1,13 +1,12 @@
-# 🐬 Dolphin Framework (v2.7.0)
+# 🐬 Dolphin Framework (v2.9.5)
 
 ![NPM Version](https://img.shields.io/npm/v/dolphin-server-modules?color=blue&style=flat-square)
-![Build Status](https://img.shields.io/github/actions/workflow/status/Phuyalshankar/dolphin-server-modules/main.yml?style=flat-square)
 ![License](https://img.shields.io/npm/l/dolphin-server-modules?style=flat-square)
 ![Downloads](https://img.shields.io/npm/dm/dolphin-server-modules?style=flat-square&color=green)
 
-**Dolphin** is a 2026-ready, ultra-lightweight, and 100% modular backend ecosystem built on native Node.js. Now featuring **Agentic AI**—Dolphin doesn't just run your code; it helps you write, architect, and modify it in real-time.
+**Dolphin** is a 2026-ready, ultra-lightweight, and 100% modular backend ecosystem built on native Node.js. Now featuring **Advanced Agentic AI (Cursor-Level)**—Dolphin doesn't just run your code; it understands your entire project, tracks symbols, and performs precision edits using semantic search.
 
-> "Native performance. Agentic AI integration. IoT-ready."
+> "Native performance. Agentic AI integration. Multi-model support."
 
 ---
 
@@ -18,97 +17,69 @@ Dolphin Framework को विस्तृत र आधिकारिक ग
 
 ---
 
-## 🤖 AI-Powered Development (New in v2.7.0)
+## 🤖 Cursor-Level AI Features (New in v2.9.5)
 
-Dolphin v2.7 introduces a revolutionary CLI that integrates with Google Gemini to provide an agentic development experience.
+Dolphin v2.9.5 introduces a complete overhaul of the AI Agent, bringing it closer to professional AI editors like Cursor.
 
-### 1. Agentic AI Project Scaffolding
-Generate a full production-ready project structure (Models, Routes, Controllers, Adapters) with a single prompt.
-```bash
-npx dolphin generate-full "An e-commerce backend with orders, products, and Mongoose auth"
-```
+### 1. Semantic Project Search
+The AI doesn't just look at one file; it indexes your entire project. When you ask a question, it uses semantic token overlap to find the 5 most relevant files automatically.
 
-### 2. Live File Modification
-Modify existing files using AI without leaving your terminal.
-```bash
-npx dolphin modify app.js "Add a request logger middleware and a new /status route"
-```
+### 2. Symbol & Reference Tracking
+Dolphin indexes every `function`, `class`, and `variable` across your project. The AI knows exactly where a symbol is defined and where it's used.
 
-### 3. Interactive AI Agent Chat
-Talk to the Dolphin AI Agent. It can answer questions, write code, and even create files for you directly.
+### 3. Precision Patching (No Full Re-writes)
+Using the new **Patch Tool**, Dolphin performs surgical edits to your code. No more slow, risky full-file overwrites for small changes.
+
+### 4. Multi-Model Support (Local & Cloud)
+Use any AI provider you want. Supports **Google Gemini**, **Groq (Llama 3)**, and **Local Ollama (Gemma 3/Llama 3)**.
 ```bash
-npx dolphin chat
+# To use Local Ollama, set this in .env:
+USE_OLLAMA=true
+OLLAMA_MODEL=gemma3:latest
 ```
 
----
-
-## 🌟 Why Dolphin in 2026?
-
-- **Agentic AI Core**: Built-in AI commands to architect and modify your system.
-- **Zero-Dependency Core**: Built on native `http` & `events`. No bloat.
-- **Universal Compatibility**: Works with Mongoose, Zod, WebSocket, and Express-compatible middleware.
-- **Reactive State Sync (DolphinStore)**: Automated frontend state synchronization with built-in loading/error tracking.
-- **Server-Served Client Library**: Zero-dependency frontend library directly from your server.
+### 5. Personalized Support (Roman Nepali)
+The agent understands and replies in **Roman Nepali** (e.g., "Sanchai hunuhunchha?"), making it more comfortable for Nepali developers.
 
 ---
 
-## 📦 Installation
-```bash
-npm install dolphin-server-modules
-```
+## 🛠️ CLI Usage
 
-### 🛠️ CLI Usage (v2.7.0)
 ```bash
-# AI: Architect a full project
-npx dolphin generate-full "prompt"
+# Start the Autonomous AI Agent (Cursor Mode)
+npx dolphin chat
 
-# AI: Modify an existing file
-npx dolphin modify <file> "instruction"
+# Architect a full production project
+npx dolphin generate-full "e-commerce backend"
 
-# AI: Open interactive agent chat
-npx dolphin chat
+# Scaffold standard components (No AI needed)
+npx dolphin add auth         # Add Auth System
+npx dolphin add crud Product # Add CRUD for Product
+npx dolphin add adapter mongoose # Setup DB
 
-# Standard: Initialize a new project
+# Initialize folders
 npx dolphin init-prod
 
-# Standard: Start a server instantly
-npx dolphin serve --port=8080
+# Start Dev Server
+npx dolphin serve --port=3000
 ```
 
 ---
 
-## 🚀 Quick Start (Modern ESM)
+## 🚀 Quick Start (Modern ESM Only)
+
+Dolphin strictly uses **ES Modules (import/export)**. The use of `require()` is discouraged as it causes compatibility issues in modern Node.js environments.
 
-### 1. High-Performance Web Server
-```typescript
+```javascript
 import { createDolphinServer } from 'dolphin-server-modules/server';
 
 const app = createDolphinServer();
 
 app.get('/ping', (ctx) => {
-  return { message: 'pong', version: '2.7.0' };
+  return { message: 'pong', status: 'swimming' };
 });
 
-app.listen(3000, () => console.log("🐬 Dolphin swimming on port 3000"));
-```
-
----
-
-## 🧩 Modular Ecosystem
-
-| Module | Path | Description |
-| :--- | :--- | :--- |
-| **Server** | `dolphin-server-modules/server` | Native HTTP server with `ctx` API & Auto-JSON. |
-| **Auth** | `dolphin-server-modules/auth` | Argon2/JWT based secure auth with 2FA (TOTP). |
-| **CRUD** | `dolphin-server-modules/curd` | Generic CRUD service with ownership & soft-delete. |
-| **Mongoose Adapter** | `dolphin-server-modules/adapters/mongoose` | Full Mongoose ↔ CRUD bridge with query mapping. |
-| **CLI Agent** | `npx dolphin` | Agentic AI for scaffolding and modification. |
-
----
-
-## 🧪 Testing
-```bash
-npm test          # Run all 200+ tests
+app.listen(3000, () => console.log("🐬 Dolphin v2.9.5 swimming on 3000"));
 ```
 
 ---
@@ -118,28 +89,19 @@ npm test          # Run all 200+ tests
 | Framework | RPS (Req/sec) | Cold Start | Realtime Throughput |
 | :--- | :--- | :--- | :--- |
 | Express.js | ~15,000 | 180ms | N/A |
-| **Dolphin V2.7** | **45,000+** | **< 10ms** | **35,000+ msgs/sec** |
+| **Dolphin V2.9** | **45,000+** | **< 10ms** | **35,000+ msgs/sec** |
 
 ---
 
 ## 🗺️ Roadmap
-- [x] Universal Plugin System (HL7/Modbus/Binary)
-- [x] Auto-Doc: Automatic Swagger/OpenAPI generation
-- [x] Real Mongoose adapter with query mapping
-- [x] **Dolphin CLI**: `npx dolphin init` and `init-prod`
-- [x] **Agentic AI Scaffolding**: Full project generation via Gemini
-- [x] **Live AI Modification**: `modify` and `chat` commands (v2.8.0)
-- [ ] **Multi-Model Support**: Integration with Groq (Llama 3), Claude, and local Ollama
-- [ ] **Cloud Deployment**: One-click deploy to Vercel/Cloudflare from CLI
-
----
-
-## 📄 License
-ISC © 2026 Shankar Phuyal & Dolphin Team.
-phin init` and `init-prod`
-- [ ] **AI-Driven Generation**: Advanced multi-file AI project scaffolding
+- [x] **Agentic AI Scaffolding**: Full project generation via Gemini/Groq
+- [x] **Semantic Search & Symbol Indexing**: Precision context building
+- [x] **Multi-Model Support**: Gemini, Groq, and Local Ollama
+- [x] **Precision Patching**: AST-style surgical code edits
+- [ ] **One-Click Deployment**: Deploy to Vercel/Cloudflare from CLI
+- [ ] **Visual Debugger**: Built-in web dashboard for monitoring
 
 ---
 
 ## 📄 License
-ISC © 2026 Shankar Phuyal & Dolphin Team.
+ISC © 2026 Shankar Phuyal & Dolphin Team.

package/TUTORIAL_NEPALI.md

@@ -1,43 +1,52 @@
-# Dolphin Framework: 0 to 100% Full Tutorial (Nepali) 🐬 [v2.2.5]
+# Dolphin Framework: 0 to 100% Full Tutorial (Nepali) 🐬 [v2.9.5]
 
-Dolphin Framework मा तपाईँलाई स्वागत छ! यो गाइडमा हामी Dolphin प्रयोग गरेर एउटा शक्तिशाली, छिटो र आधुनिक API कसरी बनाउने भनेर सुरुदेखि अन्त्यसम्म सिक्नेछौँ।
+Dolphin Framework मा तपाईँलाई स्वागत छ! यो गाइडमा हामी Dolphin प्रयोग गरेर एउटा शक्तिशाली, आधुनिक र एआई-संचालित (AI-Powered) ब्याकइन्ड कसरी बनाउने भनेर सिक्नेछौँ।
 
 ---
 
 ## १. Dolphin के हो? (Introduction)
 
-**Dolphin** एउटा "Zero-Dependency" ब्याकइन्ड फ्रेमवर्क हो। यो Node.js को नेटिभ `http` मोड्युलमा बनेको छ, जसले गर्दा यसको स्पिड एकदमै धेरै छ र यो २०२६ को आधुनिक आवश्यकताहरूका लागि तयार छ।
+**Dolphin** एउटा "Zero-Dependency" ब्याकइन्ड फ्रेमवर्क हो। यो २०२६ को आधुनिक आवश्यकताहरूका लागि तयार पारिएको छ। अहिले यसमा **Cursor-Level Agentic AI** थपिएको छ, जसले गर्दा तपाईँको कोडिङ अनुभव पूर्ण रूपमा बदलिनेछ।
 
 **मुख्य विशेषताहरू:**
+- **Advanced AI Agent**: प्रोजेक्ट बुझ्ने र आफैं कोड लेख्ने एजेन्ट।
 - **Ultra-Fast**: एक्सप्रेस (Express) भन्दा ५ गुणा सम्म छिटो।
-- **Reactive Sync**: फ्रन्टइन्ड र ब्याकइन्डको डेटा अटोमेटिक सिङ्क हुने।
-- **Offline Ready**: इन्टरनेट नहुँदा पनि डेटा सेभ गर्न मिल्ने (DolphinPersist)।
-- **Modern CLI**: एकै मिनेटमा प्रोजेक्ट तयार गर्न मिल्ने।
+- **Multi-Model Support**: Gemini, Groq (Llama 3), र Local Ollama सपोर्ट।
+- **ESM Ready**: आधुनिक `import/export` सिन्ट्याक्समा आधारित।
 
 ---
 
-## २. सुरुवाती सेटअप (Project Setup)
+## २. सुरुवाती सेटअप र एआई (Project Setup & AI)
 
-Dolphin v2.2.5 मा नयाँ CLI कमाण्डहरू थपिएका छन् जसले प्रोजेक्ट सुरु गर्न एकदमै सजिलो बनाउँछ:
+Dolphin v2.9.5 मा एआईको प्रयोग गरेर १ मिनेटमै प्रोजेक्ट तयार गर्न सकिन्छ:
 
 ```bash
 # १. नयाँ फोल्डर बनाउनुहोस्
 mkdir my-dolphin-app && cd my-dolphin-app
 
-# २. डल्फिन प्रोजेक्ट सुरु गर्नुहोस् (ESM support सहित)
-npx dolphin init
+# २. एआई एजेन्ट सुरु गर्नुहोस् (Cursor Mode)
+# यसले तपाईँको कुरा बुझ्छ र कोड लेख्न मद्दत गर्छ
+npx dolphin chat
 
-# ३. यदि तपाईंलाई 'Production' लेबलको फोल्डर स्ट्रक्चर चाहिन्छ भने:
-npx dolphin init-prod
+# ३. एआई मार्फत पूर्ण प्रोजेक्ट स्ट्रक्चर बनाउनुहोस्
+npx dolphin generate-full "e-commerce backend with orders and mongoose"
 ```
 
-यसले अटोमेटिकल्ली `package.json`, `app.js` र आवश्यक कन्फिगरेसन फाइलहरू बनाइदिन्छ।
+---
+
+## ३. एआई एजेन्टसँग कुरा गर्ने (Chatting with Agent)
+
+Dolphin Agent ले अहिले **Roman Nepali** बुझ्छ। तपाईँले यसरी सोध्न सक्नुहुन्छ:
+
+> "Hey Dolphin, `real-test` फोल्डरमा एउटा नयाँ `order.js` मोडल बनाइदेऊ र `app.js` मा त्यसको रुट थपिदेऊ।"
+
+एजेन्टले तपाईँको प्रोजेक्टका सबै फाइलहरू हेर्छ र सिधै कोड अपडेट गरिदिन्छ। यसका लागि कुनै पनि `require` प्रयोग नगर्नुहोस्, सधैँ **`import`** प्रयोग गर्नुहोस्।
 
 ---
 
-## ३. पहिलो सर्भर (Hello World)
+## ४. पहिलो सर्भर (Modern ESM Server)
 
-अब `app.js` फाइलमा यो कोड राख्नुहोस् (हामी आधुनिक `import` सिन्ट्याक्स प्रयोग गर्छौं):
+हामी आधुनिक `import` सिन्ट्याक्स मात्र प्रयोग गर्छौं, किनभने `require` ले पुराना समस्याहरू निम्त्याउन सक्छ।
 
 ```javascript
 import { createDolphinServer } from 'dolphin-server-modules/server';
@@ -46,34 +55,59 @@ const app = createDolphinServer();
 
 // एउटा सामान्य गेट (GET) रूट
 app.get('/', (ctx) => {
-  return { message: "Dolphin को संसारमा स्वागत छ! 🐬", version: "2.2.5" };
+  return { 
+    message: "Dolphin ko sansar ma swagat chha! 🐬", 
+    version: "2.9.5",
+    mode: "Agentic AI Ready"
+  };
 });
 
 // सर्भर सुन्न (Listen) सुरु गर्नुहोस्
 app.listen(3000, () => {
-  console.log("सर्भर http://localhost:3000 मा चलिरहेको छ!");
+  console.log("Server http://localhost:3000 ma chaliraheko chha!");
 });
 ```
 
 ---
 
-## ४. DolphinStore: शक्तिशाली र रिएक्टिभ स्टोर [NEW v2.2.5]
+## ५. एआई बिनाका शक्तिशाली कमाण्डहरू
 
-Dolphin को नयाँ स्टोरले फ्रन्टइन्डमा डेटा म्यानेजमेन्टलाई एकदमै सजिलो बनाउँछ। यसले डेटा लोड हुँदैछ कि छैन (loading), सफल भयो कि भएन (success) र एरर आयो कि (error) भनेर अटोमेटिक जानकारी दिन्छ।
+यदि तपाईँलाई एआई प्रयोग गर्न मन छैन भने, डल्फिनमा पहिले देखि नै बनेका टेम्पलेटहरू प्रयोग गर्न सक्नुहुन्छ:
 
-### क. स्टोर प्रयोग गर्ने तरिका
-```html
-<script src="/dolphin-client.js"></script>
-<script>
-  // १. स्टोरबाट कलेक्सन लिने
-  const products = dolphin.store.products;
+```bash
+# अथेन्टिकेसन सिस्टम थप्न
+npx dolphin add auth
 
-  // २. लोड स्टेट चेक गर्ने
-  if (products.loading) console.log("डेटा लोड हुँदैछ...");
-  
-  // ३. डेटा आएपछि देखाउने
-  if (products.success) {
-      console.log("डेटा आयो:", products.items);
+# कुनै मोडलको लागि CRUD थप्न
+npx dolphin add crud Product
+
+# मङ्गोस (Mongoose) सेटअप गर्न
+npx dolphin add adapter mongoose
+```
+
+---
+
+## ६. लोकल एआई (Ollama Support) [NEW]
+
+यदि तपाईँ आफ्नो डेटा क्लाउडमा पठाउन चाहनुहुन्न भने, आफ्नो कम्प्युटरमै **Ollama** चलाउन सक्नुहुन्छ। `.env` फाइलमा यो सेट गर्नुहोस्:
+
+```env
+USE_OLLAMA=true
+OLLAMA_MODEL=gemma3:latest
+```
+
+---
+
+## ७. अन्तिममा (Conclusion)
+
+Dolphin Framework अब एउटा सामान्य फ्रेमवर्क मात्र होइन, यो तपाईँको एउटा "एआई साथी" पनि हो। यसले तपाईँको कोडिङ स्पिड १० गुणा बढाउन मद्दत गर्छ।
+
+**थप जानकारीको लागि:**
+- [README.md](README.md) हेर्नुहोस्।
+- [Dolphin Master Guide](DOLPHIN_MASTER_GUIDE_NEPALI.md) पढ्नुहोस्।
+
+**Happy Coding in Nepali! 🇳🇵🐬**
+sole.log("डेटा आयो:", products.items);
   }
 </script>
 ```

package/dist/ai/dolphin-agent/agent.d.ts

@@ -0,0 +1,25 @@
+import { AIConfig } from './config.js';
+export declare class DolphinAgent {
+    private ai;
+    private config;
+    private currentDir;
+    private rl;
+    private projectIndex;
+    private symbolIndex;
+    private keywordIndex;
+    constructor(config: AIConfig);
+    private calculateHash;
+    private walkDir;
+    private updateSemanticIndex;
+    private semanticSearch;
+    buildProjectMemory(): Promise<void>;
+    generateEnv(): Promise<void>;
+    private askPermission;
+    private isCommandSafe;
+    private isSensitiveFile;
+    private parseAIResponse;
+    private normalizeToolCall;
+    private buildContextPrompt;
+    interactiveChat(): Promise<void>;
+    executeTask(prompt: string): Promise<void>;
+}