@nxuss/lemma 0.4.4 → 0.4.6

package/README.md

@@ -1,51 +1,55 @@
-# Lemma v0.4.0
+# Lemma v0.4.5
 > **The Intelligent AI Gateway — Privacy, Performance, and Precision for the Agentic Era.**
 
-Lemma is a high-performance orchestration layer that sits between your development environment and LLM providers. It transforms the way you build with AI by providing **Shared Semantic Memory**, **Autonomous Cost Optimization**, and **Runtime Context Synchronization**.
+Lemma is a high-performance orchestration layer that sits between your development environment and LLM providers. It transforms the way you build with AI by providing **Shared Semantic Memory**, **Autonomous Cost Optimization**, and **Privacy Guardrails**.
 
 ---
 
 ## ⚡ Killer Features
 
 ### 🛡️ Privacy Firewall (Semantic Scrubber)
-**Zero-Trust Prompts.** Stop leaking sensitive data. Lemma automatically detects API keys, PII, and credentials in your prompts, masking them with secure tokens before they reach the cloud. Responses are seamlessly reconstructed locally, ensuring your secrets never leave your machine.
+**Zero-Trust Prompts.** Stop leaking sensitive data. Lemma automatically detects API keys, PII, and credentials in your prompts, masking them with secure tokens before they reach the cloud. Responses are seamlessly reconstructed locally.
 
 ### 🚦 Complexity Router (Cost-Optimizer)
-**Intelligence Where it Matters.** Lemma analyzes the semantic complexity of every request. It autonomously routes lightweight tasks (like JSON formatting or translations) to hyper-efficient models like `gpt-4o-mini`, reserving premium models for high-reasoning challenges. Save up to 90% on simple tasks without losing quality.
+**Intelligence Where it Matters.** Lemma analyzes the semantic complexity of every request. It autonomously routes lightweight tasks to hyper-efficient models like `gpt-4o-mini`, reserving premium models for high-reasoning challenges. Save up to 90% on simple tasks.
 
 ### 🧠 Telepathic Context Injector (Runtime Sync)
-**Bridge the Gap Between Code and Execution.** Lemma synchronizes your application's live runtime state, exceptions, and memory mutations directly with your IDE’s consciousness. Your AI assistant gains immediate "situational awareness" of crashes and state changes, allowing for instant, context-aware debugging without manual intervention.
+**Bridge the Gap Between Code and Execution.** Lemma synchronizes your application's live runtime state and exceptions directly with your IDE’s consciousness. Your AI assistant gains immediate "situational awareness" of crashes.
 
 ### ⚡ Shared Semantic Cache
-**Stop Paying for the Same Thought Twice.** Unlike traditional caches, Lemma understands meaning. It recognizes that *"Fix this CSS bug"* and *"Solve the styling error"* are functionally identical, returning instant (3ms) responses and saving 40-70% on total API expenditure.
+**Stop Paying for the Same Thought Twice.** Lemma understands meaning. It recognizes similar prompts and returns instant (3ms) responses, saving 40-70% on total API expenditure.
 
 ---
 
-## 🚀 Quick Start
+## 🚀 Smart CLI (Zero-Config)
 
-Launch the Lemma ecosystem in seconds:
+Lemma v0.4.5 introduces the **Smart CLI**, making it easier than ever to get started:
 
 ```bash
+# 1. Install
 npm install -g @nxuss/lemma
-lemma start --stack
+
+# 2. Initialize (Auto-configures .env and .lemma/)
+lemma init
+
+# 3. Start with Intelligence Report
+lemma start
 ```
 
-**Point your IDE or SDK to Lemma:**
-*   **Base URL:** `http://localhost:8085/v1` (OpenAI / Anthropic Compatible)
-*   **Gemini Base:** `http://localhost:8085/v1beta`
-*   **Dashboard:** `http://localhost:3000`
+### 🧠 Intelligence Report
+On startup, Lemma performs a **System Check** to detect dependencies like Ollama and ChromaDB, providing a real-time report of active features and optimizations.
 
 ---
 
 ## 💎 Tier Comparison
 
-| Feature | 🆓 Free (Open-Core) | 💎 Pro ($12/mo) |
+| Feature | 🆓 Free (Standard) | 💎 Pro ($12/mo) |
 | :--- | :--- | :--- |
+| **Privacy Firewall** | ✅ Included | ✅ Advanced Masking |
+| **Complexity Router** | ✅ Included | ✅ Custom Routing Policies |
 | **Caching** | Exact Match | **Semantic Memory (ChromaDB)** |
-| **Security** | Basic Logging | **Privacy Firewall (Auto-Masking)** |
-| **Optimization** | Manual Routing | **Autonomous Complexity Router** |
-| **IDE Sync** | Raw Log Stream | **Telepathic Context Injector** |
-| **Continuity** | Local Only | **Cloud Sync (Team Memory)** |
+| **Hive Mind** | Local Only | **Cloud Sync (Team Memory)** |
+| **Telepathy** | Basic Sync | **Advanced State Injection** |
 | **Limits** | 300 requests/mo | **Unlimited Agentic Power** |
 
 ---
@@ -53,26 +57,16 @@ lemma start --stack
 ## 🛠️ Developer Integration
 
 ### Use as an Intelligent Proxy
-Simply swap your OpenAI/Anthropic base URL in your favorite tools (Cursor, Copilot, AutoGPT). Lemma handles the caching, scrubbing, and routing transparently.
+Simply swap your OpenAI/Anthropic base URL in your favorite tools (Cursor, Copilot, AutoGPT).
+
+*   **Base URL:** `http://localhost:8081/v1`
+*   **Dashboard:** `http://localhost:8081/dashboard/`
 
 ```bash
 # Point your configuration to:
-http://localhost:8085/v1
-```
-
-### Use as a Multi-Agent Hub
-For complex agent swarms that need a "Hive Mind":
-```typescript
-import { SubconsciousHub } from '@nxuss/lemma';
-const hub = new SubconsciousHub({ server: { port: 8080 } });
-await hub.start();
+http://localhost:8081/v1
 ```
 
 ---
 
-## 📊 Dashboard
-Monitor your savings, visualize agent connections, and inspect your semantic memory through the integrated real-time dashboard.
-
----
-
-MIT © Nxus Studio | [Get Lemma Pro](https://lemma.nxus.studio/upgrade)
+MIT © Nxus Studio | [Upgrade to Lemma Pro](https://lemma.nxus.studio/upgrade)

package/lemma-proxy.cjs

@@ -93,6 +93,31 @@ function getPidByPort(port) {
   return null;
 }
 
+async function checkDependency(url) {
+  try {
+    const res = await axios.get(url, { timeout: 1000, validateStatus: () => true });
+    return res.status >= 200 && res.status < 500;
+  } catch { return false; }
+}
+
+function ensureGitIgnore() {
+  const gi = path.join(process.cwd(), '.gitignore');
+  const line = '.lemma/';
+  try {
+    if (fs.existsSync(gi)) {
+      const content = fs.readFileSync(gi, 'utf8');
+      if (!content.includes(line)) {
+        fs.appendFileSync(gi, `\n# Lemma Context Logs\n${line}\n`);
+        return true;
+      }
+    } else {
+      fs.writeFileSync(gi, `# Lemma Context Logs\n${line}\n`);
+      return true;
+    }
+  } catch {}
+  return false;
+}
+
 // ── License helpers ────────────────────────────────────────────────────────────
 function loadLicense() {
   return readJson(LICENSE_FILE, { isPro: false });
@@ -489,10 +514,38 @@ class LemmaServer {
       }
       throw e;
     });
-    server.listen(this.port, () => {
+    server.listen(this.port, async () => {
       fs.writeFileSync(PID_FILE, String(process.pid));
       fs.writeFileSync(PORT_FILE, String(this.port));
-      console.log(`\n🚀 Lemma Proxy v${VERSION}\n📁 Project : ${this.projectName}\n🔌 Port    : ${this.port}\n`);
+      
+      const pro = isPro();
+      console.log(`\n🚀 Lemma Proxy v${VERSION} — ${pro ? 'PRO' : 'STANDARD'}`);
+      console.log(`📁 Project : ${this.projectName}\n🔌 Port    : ${this.port}`);
+      
+      console.log('\n🧠 Intelligence Report');
+      console.log('────────────────────────────────────────────────');
+      console.log(`🔒 Privacy Firewall      : \x1b[32m[ACTIVE]\x1b[0m`);
+      console.log(`🔀 Complexity Router     : \x1b[32m[ACTIVE]\x1b[0m`);
+      console.log(`💾 Exact Cache           : \x1b[32m[ACTIVE]\x1b[0m`);
+      
+      const ollamaOk = await checkDependency('http://localhost:11434/api/tags');
+      const chromaOk = await checkDependency('http://localhost:8000/'); // Basic check for Chroma
+      
+      if (pro) {
+        console.log(`🎯 Semantic Cache        : ${ollamaOk && chromaOk ? '\x1b[32m[ACTIVE]\x1b[0m' : '\x1b[33m[OFFLINE - Check Ollama/Chroma]\x1b[0m'}`);
+        console.log(`🌐 Hive Mind (Cloud)     : \x1b[32m[ACTIVE]\x1b[0m`);
+      } else {
+        console.log(`🎯 Semantic Cache        : \x1b[90m[PRO ONLY]\x1b[0m -> https://lemma.nxus.studio/upgrade`);
+        console.log(`🌐 Hive Mind (Cloud)     : \x1b[90m[PRO ONLY]\x1b[0m -> https://lemma.nxus.studio/upgrade`);
+      }
+      
+      const hasStackDir = fs.existsSync(path.join(process.cwd(), '.lemma'));
+      console.log(`📡 Telepathic Sync       : ${hasStackDir ? '\x1b[32m[READY]\x1b[0m' : '\x1b[90m[DISABLED - Run "lemma init"]\x1b[0m'}`);
+      console.log('────────────────────────────────────────────────\n');
+      
+      if (!pro) {
+        console.log('\x1b[36m💡 Unlock Semantic Search & Team Caching at https://lemma.nxus.studio/upgrade\x1b[0m\n');
+      }
     });
     process.on('SIGTERM', () => server.close());
   }
@@ -657,15 +710,28 @@ program.command('init')
   .description('Initialize Lemma in the current project (auto-discovery)')
   .action(() => {
     const project = detectProject();
-    console.log(`🛠️  Initializing Lemma for [${project}]...`);
+    console.log(`\n🛠️  Initializing Lemma for [${project}]...`);
     
+    // 1. Create .lemma directory
+    const lemmaDir = path.join(process.cwd(), '.lemma');
+    if (!fs.existsSync(lemmaDir)) {
+      fs.mkdirSync(lemmaDir, { recursive: true });
+      console.log('✅ Created .lemma directory (Telepathic Sync enabled)');
+    }
+
+    // 2. Update .gitignore
+    if (ensureGitIgnore()) {
+      console.log('✅ Added .lemma/ to .gitignore');
+    }
+
+    // 3. Update .env
     const envFile = path.join(process.cwd(), '.env');
     const lemmaConfig = `\n# Lemma AI Gateway Configuration\nOPENAI_BASE_URL=http://localhost:8081/v1\nLEMMA_PROJECT=${project}\n`;
     
     if (fs.existsSync(envFile)) {
       const content = fs.readFileSync(envFile, 'utf8');
       if (content.includes('OPENAI_BASE_URL')) {
-        console.log('⚠️  OPENAI_BASE_URL already exists in .env. Please update it manually to: http://localhost:8081/v1');
+        console.log('⚠️  OPENAI_BASE_URL already exists in .env. Update it to: http://localhost:8081/v1');
       } else {
         fs.appendFileSync(envFile, lemmaConfig);
         console.log('✅ Added Lemma configuration to .env');
@@ -675,7 +741,8 @@ program.command('init')
       console.log('✅ Created .env with Lemma configuration');
     }
     
-    console.log('\n🚀 Done! Run "lemma start" to begin.');
+    console.log('\n✨ Project initialized for the Agentic Era!');
+    console.log('🚀 Run "lemma start" to begin.\n');
   });
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Intelligent AI Gateway — Semantic cache, Privacy Firewall, and Autonomous Cost-Optimization for AI Agents.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -161,7 +161,7 @@
   "homepage": "https://github.com/Nxusbets/lemma#readme",
   "dependencies": {
     "@chroma-core/default-embed": "^0.1.9",
-    "@nxuss/lemma": "^0.4.3",
+    "@nxuss/lemma": "^0.4.5",
     "@types/cors": "^2.8.19",
     "axios": "^1.6.0",
     "commander": "^14.0.3",