14.2 Database schema reference

The full schema lives in sql/001_init.sql. Migrations after that point are Java classes under src/main/precompiled/ai/ownsona/migrations/.

14.2.1 The memories table

Documented per-column in The memories table.

14.2.2 Indexes (current shape)

IndexTypePurpose
memories_user_id_idxB-treePer-user filter.
memories_created_at_idxB-treeListing newest first.
memories_deleted_at_idxB-treeTombstone filter.
memories_tags_idxGINTag filter on tags.
memories_text_trgm_idxGINTrigram for text_search.
memories_embedding_idxHNSWCosine-similarity recall.
memories_unique_normalized_activeUnique partialExact-duplicate prevention.

14.2.3 The db_version table

Created by DbMigrator on first startup.

ColumnTypePurpose
versionINT PRIMARY KEYMigration’s target version.
applied_atTIMESTAMPTZ NOT NULL DEFAULT now()When it ran.
noteTEXTMigration’s name().