Spectre.Experience (Spectre v0.3.0)

Copy Markdown View Source

Opt-in boundary for recording and querying redacted operational evidence.

Recording is disabled unless trusted host code passes enabled?: true. Experience remains observational: it never mutates an Instance, grants authority, completes a continuation, or replaces the Journal.

Summary

Functions

Fetches verified evidence by Ref.

Lists verified evidence for one Definition.

Purges expired non-retained evidence after explicit confirmation.

Redacts, validates and publishes one evidence item when explicitly enabled.

Returns the exact evidence snapshot used by Reflection and Forge.

Functions

fetch(store, ref)

Fetches verified evidence by Ref.

list(store, definition_ref, opts \\ [])

Lists verified evidence for one Definition.

purge_expired(store, now, opts \\ [])

Purges expired non-retained evidence after explicit confirmation.

record(store, attrs, opts \\ [])

@spec record(Spectre.Experience.Store.config(), map() | keyword(), keyword()) ::
  {:ok, Spectre.Experience.Evidence.Ref.t()} | {:error, term()}

Redacts, validates and publishes one evidence item when explicitly enabled.

snapshot(store, definition_ref, opts \\ [])

Returns the exact evidence snapshot used by Reflection and Forge.