Skip to content

Memory Engine MCP v1.6.0

Choose a tag to compare

@SimoneB79 SimoneB79 released this 29 Jul 08:46

What's New

Contradiction Management & 3-Tier Memory

This release introduces explicit contradiction/supersession handling and a 3-tier memory classification system, plus a new impact analysis tool and an optional web UI for graph exploration.

New Tools

  • memory_contradict — Supersede an old atom with a newer contradictory one. Old atom is kept with status='superseded', linked via contradicts and supersedes bonds.
  • list_contradictions — List explicit contradiction/supersession records.
  • classify_memory_tier — Infer the 3-tier class (episodic/semantic/procedural) without creating an atom.
  • memory_impact — Impact analysis: traverses bonds up to N hops, returns connected nodes, edges, dependents, and contradiction chains.

3-Tier Memory Model

Every atom is now classified as:

  • episodic — logs, events, session messages, daily entries
  • semantic — facts, decisions, consolidated knowledge
  • procedural — preferences, procedures, standing rules

Inferred automatically from type/domain. Migration backfills existing atoms idempotently.

Web UI (web_ui.py)

Optional HTTP server with:

  • Interactive graph visualization (circle layout, status/tier colors)
  • Atom detail panel with impact analysis
  • Contradiction browser
  • Stats dashboard (atoms, bonds, tiers, domains)
  • Full-text search

Ranking Improvements

  • tier_boosts and status_penalties in ranking config
  • Superseded atoms receive a -0.25 score penalty
  • Semantic tier gets +0.04, procedural +0.03 boost

Infrastructure

  • Pin mcp>=1.3.0,<2.0.0 (MCP 2.x removes fastmcp)
  • FTS trigger fix: fire only on title/body/tags changes
  • Dockerfile supports dual process (MCP server + optional UI)

Full Changelog: https://github.com/SimoneB79/memory-engine-mcp/blob/main/CHANGELOG.md