Struct SharedGraphBuilder 

pub struct SharedGraphBuilder { /* private fields */ }

Builder for a SharedGraph and its fixed provider registry.

Implementations

impl SharedGraphBuilder

pub fn with_provider(self, provider: Arc<dyn IndexProvider>) -> Self

Register an index provider.

Providers are retained in registration order, which is the order used for committed mutation delivery.

pub fn with_wal( self, path: impl AsRef<Path>, config: WalConfig, ) -> GraphResult<Self>

Open a WAL file and route commits through the CORE durable provider.

The path is the WAL file path, not a directory. Callers using the conventional layout should pass dir.join(selene_persist::DEFAULT_WAL_FILE_NAME).

SyncPolicy is OVERRIDDEN (v1.2 BRIEF 2 — read this)

The single per-graph committer thread is the sole fsync caller for the committer-managed WAL: it appends a contiguous run of commits with fsync deferred, then issues exactly one WalWriter::flush per run (the R1 fsync-before-publish barrier). To make that the only fsync path, this method forces config.sync_policy to SyncPolicy::OnFlushOnly before opening the WAL — whatever policy you pass is discarded. The fsync cadence is instead controlled by Self::with_commit_batching: CommitBatching::Off (the default) fsyncs once per commit (behaviorally identical to the old EveryN(1)), and CommitBatching::On coalesces a contiguous run into one fsync. config.snapshot_seq is passed through verbatim. Durability is unchanged: the committer always flushes before it publishes or acks, so a commit is durable before it is ever visible.

Errors

Returns GraphError::Persist when the WAL cannot be opened, including when another writer already holds the file lock.

pub fn with_commit_batching(self, batching: CommitBatching) -> Self

Set the group-commit batching policy for the committer-managed WAL (v1.2 BRIEF 2). Default CommitBatching::Off.

With CommitBatching::Off the committer fsyncs once per commit (behaviorally identical to BRIEF 1). With CommitBatching::On it coalesces up to max_commits (capped by aggregate max_bytes) contiguous commits into one fsync — higher throughput + lower tail latency under fan-in, at the cost of grouping several commits behind one barrier (all still durable before any of them is acked or published). Has no effect without Self::with_wal (no durable provider to flush).

pub fn with_audit_log(self, path: impl AsRef<Path>) -> GraphResult<Self>

Attach a durable audit log at path (conventionally dir.join(selene_persist::DEFAULT_AUDIT_FILE_NAME)).

Engine-owned audit events committed through this graph are mirrored to the audit log so they survive WAL-archive pruning (Item 7 / Seam D, D24). Requires Self::with_wal: audit mirroring is part of the durable commit path, so Self::build errors if an audit log is configured without a WAL.

Errors

Returns GraphError::Persist when the audit log cannot be opened.

pub fn bound_to(self, type_def: GraphTypeDef) -> GraphResult<Self>

Bind this graph to type_def at construction time.

Errors

Returns GraphError::Inconsistent when the builder is already bound or when type_def fails self-consistency validation.

pub fn build(self) -> GraphResult<SharedGraph>

Build shared graph state and validate provider registration.

Errors

Returns GraphError::Provider when provider tags are duplicated.