@lucasmella/mismem

misMEM — engine

Memoria persistente con consolidación biológica (3 capas) sobre SQLite + FTS5, expuesta como MCP server stdio.

Filosofía

"Uno no recuerda exactamente lo que pasó ayer o hace 3 años, pero sí parte de eso."

La pérdida es intencional y asimétrica, como la memoria humana:

• episodes — verbatim, efímero. Lo crudo. TTL ~14-30d post-consolidación.
• memories — destilación con salience que decae si no se accede. Núcleo operativo.
• traits — patrones cristalizados. El Soul Mirror de Bardon. Permanente salvo borrado explícito.

En corto: un episode conserva “lo que ocurrió”, una memory conserva “lo que aprendimos” y un trait conserva “el patrón estable que guía decisiones”.

Invocaciones (5)

Invocación	Capa de origen → destino	Quién decide
capture	→ episode	LLM (auto)
recall	episode + memory + trait → respuesta	LLM (auto)
consolidate	N episodes → 1 memory	LLM al cierre
crystallize	N memories → 1 trait	LLM o usuario
forget	episodes/memories → ∅	usuario

recall fusiona FTS5 y semántica mediante RRF para memories, y refuerza solo las memorias finalmente devueltas. La salience tiene una vida media de 90 días por defecto; forget aplica el decay antes de evaluar la purga. El viewer usa el mismo ranking sin refuerzo, por lo que es realmente read-only.

Scope

Un servidor por proyecto. Cada scope es un namespace lógico dentro del mismo .db. No hay cross-scope leakage en queries scoped.

Dev

cd engine
pnpm install
pnpm test
pnpm build

Uso vía MCP (VS Code / Claude Code)

mcp.json:

{
  "mcpServers": {
    "mismem": {
      "command": "node",
      "args": ["<ruta-al-repo>/misMEM/engine/dist/server.js"],
      "env": { "MISMEM_DB": "<home>/.mismem/mem.db" }
    }
  }
}

Default DB: ~/.mismem/mem.db (configurable con MISMEM_DB).

Roadmap

• Fase 0: schema + 5 invocaciones + tests + MCP stdio
• Fase 1: ingesta de exports (ChatGPT, transcripts VS Code) como semilla
• Fase 2: servidor Streamable HTTP + capa engram-compat + deploy en VPS
• Fase 3: consolidación LLM (episodes → memories vía OpenRouter) + pre-filtro Pareto
• Fase 4: viewer read-only (/viewer) + CLIs (mismem-stats, mismem-forget, mismem-migrate-engram)
• Fase 5: dedup por content-hash + embeddings opcionales (Ollama nomic-embed-text, coseno en JS, mismem-embed)
• Fase 6: decay idempotente + ranking híbrido consistente + reindexado seguro
• Fase 7: binario empaquetado (bun --compile) + onboarding