@nxuss/lemma 1.18.2 → 1.19.0

package/bin/init.js

@@ -547,6 +547,106 @@ function configureKiro() {
 }
 
 // OpenCode: register MCP server in opencode.json
+const MUSE_SKILL_CONTENT = `---
+name: lemma
+description: Lemma — cache semántico, firewall de privacidad y memoria cross-sesión para Muse.
+---
+
+# Lemma para Muse
+
+Eres Muse Code (muse-spark). Tienes disponible **Lemma MCP** — gateway de caché semántica, firewall de privacidad y memoria persistente. Este skill te enseña a usarlo sin MCP nativo (Muse no habla MCP aún): todo es vía CLI + proxy local.
+
+## Qué es Lemma
+
+- **Proxy local** en \`http://localhost:8081\` — cachea respuestas LLM (BM25 + embeddings), ahorra tokens/dinero.
+- **Brain persistente** en \`~/.lemma-cache/lemma_brain.json\` + memoria por proyecto.
+- **MCP server** con 70+ tools — las mismas que usan Claude Code / Cursor / Codex, pero aquí las llamas vía \`npx @nxuss/lemma\` o \`node mcp-server.js\` por \`bash\`.
+
+## Cuándo usar Lemma (Muse)
+
+| Tarea | Qué hacer con Lemma |
+|---|---|
+| Pregunta que puede estar ya resuelta | \`search_memory\` antes de razonar |
+| Pregunta atada a archivos concretos (mismo prompt + mismos archivos) | \`state_hash_cache\` con \`action=lookup\` antes, \`store\` después |
+| Conocimiento que debe sobrevivir sesiones | \`search_memory\` / \`store_memory\` (con \`derivedFrom\`) |
+| Leer/listar/buscar workspace | Usa tus tools nativos (\`read_file\`, \`bash ls/grep\`) — Lemma añade scrubbing si lo llamas, pero no es obligatorio |
+| Tarea mecánica → decidir modelo barato | \`get_routing_advice\` |
+| Aplicar patch | \`validate_patch_sandbox\` primero |
+| "¿Cuánto ahorramos?" | \`token_receipt\` |
+
+Si Lemma no encaja, usa tu tool nativo. No fuerces Lemma donde no aporta.
+
+## Cómo llamar a Lemma desde Muse
+
+Muse no tiene \`mcp__lemma__*\` tools nativas. Llama al servidor MCP por **stdio** vía bash:
+
+\`\`\`bash
+# 1. Lookup en memoria antes de razonar
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_memory","arguments":{"query":"tu pregunta"}}}' | node ./mcp-server.js
+
+# 2. Tool genérico - busca en workspace (con scrubbing)
+echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_workspace","arguments":{"query":"texto"}}}' | node ./mcp-server.js
+
+# 3. Guarda solución verificada
+echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"store_memory","arguments":{"content":"solución verificada","tags":["bugfix"]}}}' | node ./mcp-server.js
+\`\`\`
+
+O usa el wrapper más simple si está instalado:
+
+\`\`\`bash
+npx -y @nxuss/lemma mcp   # servidor MCP stdio
+lemma search "query"      # CLI directa si instalaste lemma global
+\`\`\`
+
+Para el proxy de cache (tráfico LLM real), asegúrate que el daemon corre:
+
+\`\`\`bash
+node ./lemma-proxy.cjs status
+node ./lemma-proxy.cjs start
+\`\`\`
+
+## Flujo obligatorio al iniciar sesión
+
+1. Llama \`search_memory\` con el tema de la tarea.
+2. Si hay hit, verifícalo contra el código actual antes de presentarlo.
+3. Al terminar con solución verificada (tests pasaron), llama \`store_memory\`.
+
+## Flujo para bugs
+
+1. \`get_telepathic_hints\` si necesitas contexto de runtime.
+2. \`search_memory\` con el mensaje de error.
+
+## Regla dura
+
+Si tu respuesta viene de un cache hit, dilo explícitamente: "esto viene de memoria cacheada". Nunca presentes un hit como razonamiento fresco. Y nunca guardes una solución no verificada.
+
+## Instalación / verificación
+
+\`\`\`bash
+# Re-configura todo (incluye Muse skill)
+node ./bin/init.js
+
+# Verifica que el proxy está arriba
+curl -s http://localhost:8081/health || echo "proxy down"
+
+# Verifica MCP responde
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node ./mcp-server.js | head -c 500
+\`\`\`
+
+> Generado por \`lemma init\` — @nxuss/lemma para Muse.
+`;
+
+function configureMuse() {
+  const cwd = process.cwd();
+  const skillDir = path.join(cwd, '.agents', 'skills', 'lemma');
+  try {
+    ensureDir(skillDir);
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    fs.writeFileSync(skillPath, MUSE_SKILL_CONTENT, 'utf8');
+    return true;
+  } catch { return false; }
+}
+
 function configureOpenCode() {
   const cwd = process.cwd();
   const opencodePath = path.join(cwd, 'opencode.json');
@@ -771,6 +871,10 @@ async function main() {
   configureOpenCode();
   ok('OpenCode configured (opencode.json MCP + instructions)');
 
+  const museOk = configureMuse();
+  if (museOk) ok('Muse configured (.agents/skills/lemma/SKILL.md)');
+  else warn('Muse skill could not be configured');
+
   const hasContinue = detectTool('Continue.dev', () => configureContinueDotDev());
   if (hasContinue) ok('Continue.dev configured');
   else skip('Continue.dev not detected');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxuss/lemma",
-  "version": "1.18.2",
+  "version": "1.19.0",
   "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",