elips/docs
Chapter II · first contact

add and delete

Two verbs. Everything else is a query.

writeadd / deleteWAL appendCRC32C framesrecord storein-memoryMetadataIndexequality setscheckpoint?thresholdsegmentsatomic renamesegments.new → segmentstruncate WAL ↻
add / delete append to the WAL first, then mutate the in-memory store.
python
key = notes.add(embedding=[0.1, 0.2, 0.3, 0.4], metadata={"tag": "a"})
notes.delete(ids=key)   # marks tombstone; checkpoint/compact reclaims space

From docs/storage.md: the WAL supports insert, erase, and insert_ex (for records carrying DocumentAttachment, ChunkInfo, or EmbeddingLineage). Crash recovery restores full record state, not only vectors.