Module entry 

Structs

MemoryEntry

A scored memory record with confidence, trust, and graph links.

MemoryGraph

In-memory graph of memory entries keyed by ID.

Reinforcement

A single reinforcement event (positive or negative feedback).

Enums

MemoryCategory

Classifies the kind of information a memory entry represents.

TrustLevel

Indicates the trustworthiness of a memory entry’s source.

Functions

available_disk_bytes

Available bytes on the filesystem holding path (best-effort; None if it can’t be determined). Unix uses statvfs; other platforms return None.

disk_aware_max_entries

Disk-aware memory cap: never exceeds configured, but on a small/full disk it shrinks further (≤5% of free space, ~600 bytes/entry, ≤64 MB budget), while always keeping a useful floor so some user content is still remembered. Memory is cheap (a few MB) and must not be skimped — only a genuinely tiny disk shrinks it, and even then it keeps a healthy floor.