vera-memory

A minimal structured memory layer for Vera.

Purpose

vera-memory stores and retrieves structured memories for Vera. It is intentionally small:

• active use only
• SQLite + FTS5
• structured records
• explicit CRUD tools
• no automatic retrieval injection
• no automatic writeback
• no maintenance / review / cleanup pipeline
• no vector database
• no embeddings

Registered surface

Tools

• memory_remember
• memory_search
• memory_update
• memory_forget
• memory_status

Command

• /memory_status

Hooks

• session_start
• session_shutdown

Data model

Core storage uses:

• meta
• memories
• memories_fts

See repository design docs for the exact V1 schema.

Config

Loaded from:

• agent/config/memory.json
• project .pi/config/memory.json

Minimal example:

{
  "enabled": true,
  "database": {
    "path": "../state/memory.sqlite"
  },
  "defaults": {
    "shortTtlDays": 14
  }
}

Notes:

• relative database.path values are resolved from the config file directory
• if no config file exists, built-in defaults are used
• memory_remember does not do upsert

Behavior

The memory system is manual, not default.

• search only when memory may materially improve continuity or correctness
• store only stable, reusable information
• update only when the same stable object changed
• forget only on explicit request, confirmed error, or clear replacement
• files, runtime state, and docs override memory

Smoke

Run:

npm run smoke

The smoke test covers the minimal V1 path:

• tool registration
• remember
• search by query
• search by identity
• update
• forget
• status

Loaded through agent/settings.json as ./packages/vera-memory.