@nxuss/lemma 0.9.2 → 0.9.3

package/README.md

@@ -1,8 +1,8 @@
-# 🧠 Lemma v0.9.2
+# 🧠 Lemma v0.9.3
 
 [![npm version](https://img.shields.io/npm/v/@nxuss/lemma.svg?color=orange&style=flat-square)](https://www.npmjs.com/package/@nxuss/lemma)
 [![License](https://img.shields.io/npm/l/@nxuss/lemma.svg?color=blue&style=flat-square)](https://github.com/Nxusbets/lemma/blob/main/LICENSE)
-[![MCP Tools](https://img.shields.io/badge/MCP%20tools-36-ff69b4?style=flat-square)](https://github.com/Nxusbets/lemma)
+[![MCP Tools](https://img.shields.io/badge/MCP%20tools-38-ff69b4?style=flat-square)](https://github.com/Nxusbets/lemma)
 [![Security](https://img.shields.io/badge/privacy-firewall%20active-blueviolet?style=flat-square)](https://github.com/Nxusbets/lemma)
 [![Caching](https://img.shields.io/badge/semantic%20memory-enabled-success?style=flat-square)](https://github.com/Nxusbets/lemma)
 
@@ -16,7 +16,7 @@
 
 > **The Intelligent local-first AI Gateway — Privacy, Performance, and Static Code Intelligence 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**, **Privacy Guardrails**, and a suite of **36 MCP tools** — including zero-token static code intelligence that runs entirely on your machine with no LLM calls required.
+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**, **Privacy Guardrails**, and a suite of **38 MCP tools** — including zero-token static code intelligence that runs entirely on your machine with no LLM calls required.
 
 ---
 
@@ -31,19 +31,20 @@ Lemma is a high-performance orchestration layer that sits between your developme
 | **Complexity Router** | ✅ | ✅ |
 | **Dashboard** | Basic stats | ✅ Full time-travel |
 | **Proxy requests/month** | 300 | ✅ Unlimited |
-| **MCP Server (all 32 tools)** | ❌ | ✅ |
+| **MCP Server (all 38 tools)** | ❌ | ✅ |
 | **The Brain — Semantic Memory** | ❌ | ✅ |
 | **Zero-Token Static Analysis** | ❌ | ✅ |
 | **Cross-Project Telepathy** | ❌ | ✅ |
 | **AutoPilot & Auto-Heal** | ❌ | ✅ |
+| **`depgraph` — Dependency Graph** | ❌ | ✅ |
+| **`refactor` — Codemod Engine** | ❌ | ✅ |
 
-> **The MCP is Pro.** All 32 tools — The Brain, PreCrime predictor, AST Hologram, Entropy Score, Coupling Radar, workspace control, and every optimization tool — require a Pro license. Activate with `lemma activate <key>` → [Get Pro](https://lemma.nxus.studio/upgrade)
+> **The MCP is Pro.** All 38 tools — The Brain, PreCrime predictor, AST Hologram, Entropy Score, Coupling Radar, `depgraph`, `refactor`, and every optimization tool — require a Pro license. Activate with `lemma activate <key>` → [Get Pro](https://lemma.nxus.studio/upgrade)
 
 ---
 
 ## ⚡ What's in the Pro MCP
 
-
 ### 🧠 Shared Semantic Memory — The Brain
 Lemma maintains a persistent vector database (ChromaDB) that accumulates knowledge across all your projects. Every solution, bug fix, and architecture decision you work through gets stored and semantically indexed. Future sessions can retrieve this knowledge in milliseconds — no cloud, no tokens, no re-explaining.
 
@@ -62,6 +63,48 @@ Mathematical chaos score (0-100) per file using the TS Compiler API. Measures cy
 ### 🗺️ AST Hologram — Zero Tokens
 Scans the entire workspace and returns a dense JSON index of all exported symbols (classes, functions, interfaces, types, consts) with file paths and line numbers. Use this instead of reading individual files — saves up to 90% tokens when navigating large codebases.
 
+### 📡 `depgraph` — Real-Time Dependency Graph *(NEW in v0.9.3)*
+**Architecture-aware blast radius analysis.** Builds a real-time, bidirectional dependency graph for any file in the workspace using the TypeScript Compiler API — zero LLM calls, zero tokens. Shows exactly what a file imports, what imports it (reverse dependencies), and what symbols it exports.
+
+```
+📦 src/services/pantry.ts
+├── importa:
+│   ├── src/lib/utils/ingredient-parser.ts  → parseIngredientString, normalizeUnit
+│   └── src/db/prisma.ts                    → PrismaClient
+├── es importado por:
+│   ├── src/app/actions/generate-recipe.ts
+│   └── src/components/PantryWidget.tsx
+└── exporta:
+    ├── applyRecipeDeductions
+    └── getPantryBalance
+```
+
+Supports `--depth` (1-5), `--format text|mermaid|json`, `--reverse`, `--circular` (cycle detection), and `--external` (include node_modules).
+
+### 🔧 `refactor` — Declarative Codemod Engine *(NEW in v0.9.3)*
+**Multi-file refactoring with surgical precision.** Rename any symbol across the entire workspace or move files updating all importers — using the TypeScript Compiler API for accurate AST-based reference detection. Zero LLM calls.
+
+**`rename`** — Finds every reference to a symbol (via AST, not text search) and renames it everywhere:
+```bash
+# Preview first
+lemma refactor --operation rename --from "applyRecipeDeductions" --to "deductPantryIngredients" \
+  --file src/services/pantry.ts --dryRun
+
+# Apply with TypeScript verification
+lemma refactor --operation rename --from "applyRecipeDeductions" --to "deductPantryIngredients" \
+  --file src/services/pantry.ts --tscCheck
+```
+
+**`move`** — Moves a file physically and rewires every import path in the workspace:
+```bash
+lemma refactor --operation move \
+  --from src/lib/validation/recipe.schema.ts \
+  --to src/lib/schemas/recipe.ts \
+  --tscCheck
+```
+
+Supports `--dryRun` (unified diff preview), `--tscCheck` (post-refactor type verification), and `--backup` (`.bak` files).
+
 ### 🚦 Complexity Router
 Intelligently evaluates each prompt and routes it to the most cost-effective model. Reserves premium models for complex reasoning, uses smaller models for simple tasks. Slashes your AI bill without sacrificing quality.
 
@@ -142,11 +185,11 @@ Just run `lemma init`. Lemma automatically registers its MCP server in your `~/.
 }
 ```
 
-Once connected, your IDE gains access to all **32 MCP tools** and Lemma auto-injects the TurboMode system prompt on handshake.
+Once connected, your IDE gains access to all **38 MCP tools** and Lemma auto-injects the TurboMode system prompt on handshake.
 
 ---
 
-## 🛠️ MCP Tools Reference (v0.9.2 — 36 Tools)
+## 🛠️ MCP Tools Reference (v0.9.3 — 38 Tools)
 
 ### 🗂️ Workspace Tools
 
@@ -193,7 +236,7 @@ Once connected, your IDE gains access to all **32 MCP tools** and Lemma auto-inj
 | `auto_heal` | Diagnose and auto-heal the latest crash from Lemma's live context logs. |
 | `batch_tool_calls` | Execute multiple tool calls in parallel via `Promise.all`. High-throughput operations in a single MCP round-trip. |
 
-### 🔮 Zero-Token Static Intelligence Tools (NEW in v0.9.0)
+### 🔮 Zero-Token Static Intelligence Tools
 
 > All tools in this section use **zero LLM tokens, zero Ollama, zero cloud**. Pure local computation via TypeScript Compiler API, git, and math.
 
@@ -207,7 +250,16 @@ Once connected, your IDE gains access to all **32 MCP tools** and Lemma auto-inj
 | `semantic_dedup_guard` | **Brain dedup firewall.** Before calling `store_memory`, pass content through here. If similarity ≥ 92% → rejects as duplicate. If 75–91% → warns and shows the similar entry. Keeps The Brain lean and dense. |
 | `dead_export_necromancer` | **Dead code auditor.** Maps every `export` in the workspace against every `import`. Symbols exported but never imported anywhere = zombie code inflating your context. Reports dead exports by file with estimated token waste. |
 
-### 🔍 PR Review Agent Tools (NEW in v0.9.2)
+### 🏗️ Architecture & Refactoring Tools *(NEW in v0.9.3)*
+
+> Architecture-aware tools that combine dependency analysis with surgical code transformation. **Zero LLM calls.**
+
+| Tool | Description |
+| :--- | :--- |
+| `depgraph` | **Real-time dependency graph.** Builds a bidirectional import/export map for any file. Shows what a file imports, what imports it (reverse deps with `--reverse`), and what symbols it exports. Supports `--depth` 1-5, `--format text\|mermaid\|json`, `--circular` (cycle detection), and `--external` (include node_modules). Use before any refactor to measure blast radius. |
+| `refactor` | **Declarative codemod engine.** `rename` renames a symbol across all files using AST-based reference detection (no false positives from string search). `move` relocates a file and rewires every import path in the workspace. Both support `--dryRun` (unified diff preview), `--tscCheck` (post-apply type verification), and `--backup` (`.bak` files). |
+
+### 🔍 PR Review Agent Tools
 
 | Tool | Description |
 | :--- | :--- |

package/dist/cjs/mcp/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA0iBnE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,IAAI,CA2DN"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA6kBnE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,IAAI,CA2DN"}