# IdentityDB

IdentityDB is a TypeScript package for building structured AI memory on top of relational databases.

## What it is

IdentityDB stores memory as a graph made of:

- **Topics** — named nodes such as `TypeScript`, `programming language`, `2025`, or `I`
- **Facts** — statements that connect multiple topics
- **Fact-topic links** — the relationships that turn one fact into a bridge between many topics

A single fact like `I have worked with TypeScript since 2025.` can connect the topics `I`, `TypeScript`, and `2025` at the same time.

## Foundation scope

The first implementation pass focuses on:

- SQLite, PostgreSQL, MySQL, and MariaDB adapters
- Automatic schema initialization
- High-level APIs for topics and facts
- Pluggable ingestion so callers can use a small LLM to extract topics from free-form statements

## Current status

This repository is in active foundation development.

See `docs/plans/2026-05-11-identitydb-foundation.md` for the current implementation plan.