Spectre.Router.SemanticCache.Learned.Snapshot (Spectre v0.3.0)

Copy Markdown View Source

Portable snapshot export and import for the learned semantic cache.

Encodes review rows and their stored embeddings as JSON-compatible maps or an atomically written JSONL file, and restores online rows from snapshot maps or paths while re-validating labels against the agent's current cacheable routes.

Summary

Functions

entries(opts)

Resolves snapshot input (path, rows, or keyword) into entry maps.

load(agent, entries, opts)

Loads snapshot entries as online rows, summarizing skips and errors.

write(rows, path)

Encodes rows as snapshot maps, or writes them to a JSONL path.

Functions

entries(opts)

@spec entries(term()) :: {:ok, [map()]} | {:error, term()}

Resolves snapshot input (path, rows, or keyword) into entry maps.

load(agent, entries, opts)

@spec load(module(), [map()], keyword()) :: {:ok, map()} | {:error, term()}

Loads snapshot entries as online rows, summarizing skips and errors.

write(rows, path)

@spec write([Spectre.Router.SemanticCache.Learned.row()], String.t() | nil | term()) ::
  {:ok, String.t() | [map()]} | {:error, term()}

Encodes rows as snapshot maps, or writes them to a JSONL path.