@spec commit_ingestion(
  Mnemosyne.GraphBackend.ingestion_record(),
  Mnemosyne.Graph.Changeset.t(),
  map()
) :: :ok | {:error, term()}

Persists a new ingestion with its graph and metadata changes.

The ingestion row is written last as the commit marker and the table is then synchronized. DETS has no transactions, so a write failure before the marker may leave partial graph or metadata rows for a later load.

@spec delete([String.t()], map()) :: :ok | {:error, term()}

Removes nodes by ID from DETS and strips any back-references to those IDs from every surviving node's link sets. Without the strip pass, surviving rows retain dangling references that re-materialize on reload.

@spec delete_metadata([String.t()], map()) :: :ok | {:error, term()}

Removes metadata entries by node ID from DETS.

@spec init(keyword()) :: {:ok, map()} | {:error, term()}

Opens the DETS file at the configured path, returning a handle map.

@spec load(map()) :: {:ok, Mnemosyne.Graph.t(), map(), map()} | {:error, term()}

Reads all records from DETS and rebuilds a graph, metadata map, and ingestion map.

Node records are stored as {id, node} tuples, metadata records as {{:meta, id}, metadata} tuples, and ingestion records as {{:ingestion, source_id}, record} tuples.

@spec save(Mnemosyne.Graph.Changeset.t(), map()) :: :ok | {:error, term()}

Persists changeset additions and links to DETS.

@spec save_metadata(%{required(String.t()) => struct()}, map()) ::
  :ok | {:error, term()}

Persists metadata entries as {{:meta, id}, metadata} records.