Enum PreparedWrite 

#[non_exhaustive]
pub enum PreparedWrite {
    Node {
        kind: String,
        body: String,
        source_id: Option<String>,
        logical_id: Option<String>,
    },
    Edge {
        kind: String,
        from: String,
        to: String,
        source_id: Option<String>,
        logical_id: Option<String>,
        body: Option<String>,
        t_valid: Option<String>,
        t_invalid: Option<String>,
        confidence: Option<f64>,
        extractor_model_id: Option<String>,
        temporal_fallback: Option<bool>,
    },
    OpStore {
        collection: String,
        record_key: String,
        schema_id: Option<String>,
        body: String,
    },
    AdminSchema {
        name: String,
        kind: String,
        schema_json: String,
        retention_json: String,
    },
}

Batch input shape for Engine::write.

Marked #[non_exhaustive] per ADR-0.6.0-prepared-write-shape; new entity variants land in 0.6.x without a major bump. Adding fields to existing variants remains a binding-coordination change.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Node

Fields

kind: String

body: String

source_id: Option<String>

REQ-026 / AC-028 / AC-042 recovery seam. None is the back-compat default and lands as NULL on disk; callers that participate in excise_source / trace_source_ref must supply a stable identifier.

logical_id: Option<String>

G0 (Slice 15) — stable cross-re-ingestion identity. Some(id) makes this write a transaction-time supersession of the prior active version of (logical_id, kind) (tombstone-then-insert). None is the legacy/own-identity default: a plain insert with a NULL logical_id (NULL-safe — never collides with other NULLs).

Edge

Fields

kind: String

from: String

to: String

source_id: Option<String>

REQ-026 / AC-028 / AC-042 recovery seam — see Node.

logical_id: Option<String>

G0 (Slice 15) — see Node. Supersession semantics are identical on edges (keyed by (logical_id, kind)).

body: Option<String>

G11 (Slice 15) — the fact/relationship text. When Some, triggers FTS projection into search_index_edges and vector projection via the projection scheduler (kind "edge_fact"). Also triggers invalidate-not-accumulate on (from_id, to_id, kind).

t_valid: Option<String>

G11 (Slice 15) — event valid-time (ISO-8601). NULL = unknown / still valid.

t_invalid: Option<String>

G11 (Slice 15) — event invalid-time (ISO-8601). NULL = still valid.

confidence: Option<f64>

G11 (Slice 15) — extraction confidence ∈ [0.0, 1.0]. NULL for non-BYO-LLM-ingested edges.

extractor_model_id: Option<String>

G11 (Slice 15) — opaque model/provider id from the BYO-LLM harness ready.model field. NULL for non-BYO-LLM edges.

temporal_fallback: Option<bool>

R3 (Slice 30, SCHEMA-GATE-1, HITL-SIGNED 2026-06-13) — set when the ELPS extractor defaulted this edge’s t_valid to created_at rather than deriving it from the document text. Such edges have untrustworthy event times and are excluded from graph-arm BFS temporal queries. None/false = not a fallback; Some(true) = fallback.

OpStore

Fields

collection: String

record_key: String

schema_id: Option<String>

body: String

AdminSchema

Fields

name: String

kind: String

schema_json: String

retention_json: String

Trait Implementations

impl Clone for PreparedWrite

fn clone(&self) -> PreparedWrite

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PreparedWrite

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for PreparedWrite

fn eq(&self, other: &PreparedWrite) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PreparedWrite