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

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