@nxuss/lemma 1.3.2 → 1.3.3

package/README.md

@@ -1,4 +1,4 @@
-# 🧠 Lemma v1.3.2
+# 🧠 Lemma v1.3.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)

package/bin/init.js

@@ -257,49 +257,43 @@ function loadLemmaToolNames() {
 const LEMMA_TOOL_NAMES = loadLemmaToolNames();
 const LEMMA_MCP_TOOLS = LEMMA_TOOL_NAMES.map((name) => `mcp__lemma__${name}`);
 
-const CLAUDE_MD_CONTENT = `# Lemma MCP — Reglas de Comportamiento Obligatorio
+const CLAUDE_MD_CONTENT = `# Lemma MCP — Cómo usar las herramientas de este proyecto
 
-> ⚠️ ESTAS REGLAS SON ABSOLUTAS. Síguilas sin excepción.
+Tienes conectado el servidor MCP \`lemma\`. Úsalo cuando aporte algo real — caché verificable,
+scrubbing de secretos, contexto de proyecto ya indexado — no como sustituto automático de tus
+herramientas nativas en cada caso. Si una tool de Lemma no encaja con lo que necesitas hacer,
+usa la herramienta nativa; una regla que te obliga a usar la tool equivocada para ahorrar
+tokens sale más cara que los tokens que ahorra.
 
-## REGLA PRINCIPAL: Siempre usa las herramientas MCP de Lemma
+## Por defecto, para esto sí conviene usar Lemma
 
-Tienes conectado el servidor MCP \`lemma\`. **NUNCA** uses herramientas nativas cuando existe una alternativa Lemma equivalente.
+| Tarea | Tool de Lemma | Por qué |
+|---|---|---|
+| Leer/listar/buscar en el workspace | \`mcp__lemma__read_workspace_file\`, \`list_workspace_dir\`, \`search_workspace\` | Auto-scrubbing de secretos y compresión de contexto sin perder el archivo real |
+| Pregunta que depende de archivos específicos | \`mcp__lemma__state_hash_cache\` (action="lookup" antes de razonar, "store" después) | Hit solo si el hash del archivo no cambió — invalidación exacta, no una adivinanza por similitud |
+| Pregunta general, sin dependencia de archivos | \`mcp__lemma__search_memory\` / \`smarter_cache\` | Cache semántico; si hay hit, dilo explícitamente ("esto viene de una respuesta cacheada") en vez de presentarlo como recién razonado |
+| Tarea mecánica/trivial y quieres saber si conviene un modelo más barato | \`mcp__lemma__get_routing_advice\` | Evita gastar presupuesto de modelo grande en algo mecánico |
+| Agregar un método/función a un archivo existente | \`mcp__lemma__surgical_ast_insert\` | Patch quirúrgico en vez de reescribir el archivo completo |
+| Antes de aplicar un patch generado | \`mcp__lemma__validate_patch_sandbox\` | Valídalo antes de escribirlo, no después |
+| "¿Cuánto ahorramos de verdad?" | \`mcp__lemma__token_receipt\` | Bitácora auditable real, no una cifra inventada |
+| Guardar una solución para el futuro | \`mcp__lemma__store_memory\` | Solo después de verificarla (tests pasaron, el usuario confirmó) — una solución mala guardada se vuelve un cache hit falso más adelante |
 
-### Substituciones OBLIGATORIAS
+## Al iniciar en este proyecto
 
-| ❌ NUNCA usar | ✅ SIEMPRE usar |
-|---|---|
-| \`Read\` / \`cat\` / leer archivo | \`mcp__lemma__read_workspace_file\` |
-| \`Write\` / escribir archivo | \`mcp__lemma__write_workspace_file\` |
-| Crear archivo nuevo | \`mcp__lemma__create_workspace_file\` |
-| \`LS\` / listar directorio | \`mcp__lemma__list_workspace_dir\` |
-| \`Grep\` / buscar en archivos | \`mcp__lemma__search_workspace\` |
-| Buscar en memoria propia | \`mcp__lemma__search_memory\` |
-| Guardar soluciones | \`mcp__lemma__store_memory\` |
-| Contexto del proyecto | \`mcp__lemma__get_project_onboarding\` |
-| Contexto de runtime / bug | \`mcp__lemma__get_telepathic_hints\` |
-| Escribir un patch | \`mcp__lemma__validate_patch_sandbox\` primero |
-
-## Flujo obligatorio al iniciar
-
-1. Llama \`mcp__lemma__get_project_onboarding\` — lee el contexto del proyecto
-2. Llama \`mcp__lemma__search_memory\` con el tema del problema — recupera soluciones previas
-3. Al terminar: llama \`mcp__lemma__store_memory\` con la solución
-
-## Flujo obligatorio al examinar archivos
-
-- USA \`mcp__lemma__read_workspace_file\` para TODOS los archivos
-- USA \`mcp__lemma__list_workspace_dir\` para TODOS los directorios
-- USA \`mcp__lemma__search_workspace\` para TODAS las búsquedas de texto
+1. Llama \`mcp__lemma__get_project_onboarding\` para orientarte con el contexto ya indexado.
+2. Si el problema se parece a algo ya resuelto, llama \`mcp__lemma__search_memory\`.
+3. No lo trates como un hecho hasta verificarlo contra el estado actual del código.
 
-## Al reportar un bug
+## Al reportar o investigar un bug
 
-1. Llama \`mcp__lemma__get_telepathic_hints\` con el archivo relevante
-2. Llama \`mcp__lemma__search_memory\` con el mensaje de error
+1. \`mcp__lemma__get_telepathic_hints\` con el archivo relevante para contexto de runtime.
+2. \`mcp__lemma__search_memory\` con el mensaje de error, por si ya se resolvió algo parecido.
 
-## Antes de escribir patches
+## Una sola regla dura
 
-- SIEMPRE llama \`mcp__lemma__validate_patch_sandbox\` antes de aplicar cambios
+Cualquier respuesta que dependa de un cache hit, un fix auto-sugerido, o un archivo comprimido
+para tu propio contexto debe entregarse con la información real y sin ocultar que vino de ahí.
+Ahorrar tokens nunca debe costar que el usuario reciba algo incorrecto sin saberlo.
 
 ---
 *Auto-generado por \`lemma init\` — @nxuss/lemma*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Intelligent AI Gateway for IDEs & Agents — Semantic cache, Privacy Firewall, Infrastructure Command Center, and Autonomous Cost-Optimization.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",