Struct WorkspaceGraph 

pub struct WorkspaceGraph<S> { /* private fields */ }

Core recursive-workspace graph over one durable lineage adapter.

Implementations

impl<S> WorkspaceGraph<S>

pub const fn new(store: S) -> Self

Creates a graph over a durable state adapter.

pub const fn store(&self) -> &S

Borrows the underlying adapter.

impl<S: WorkspaceLineageStore> WorkspaceGraph<S>

pub async fn register_root<A: AsyncAuthorityStore, O: AsyncObjectStore>( &self, workspace: &Workspace<A, O>, ) -> Result<WorkspaceLineageRecord, WorkspaceLineageError<S::Error>>

Registers a root workspace with no publication parent.

pub async fn fork<A: AsyncAuthorityStore, O: AsyncObjectStore>( &self, parent: &Workspace<A, O>, destination: impl AsRef<str>, idempotency_key: IdempotencyKey, ) -> Result<Workspace<A, O>, WorkspaceLineageError<S::Error>>

Forks a real SDK workspace and durably records its direct parent.

pub async fn register_existing_child<A: AsyncAuthorityStore, O: AsyncObjectStore>( &self, parent: &Workspace<A, O>, child: &Workspace<A, O>, fork_generation: GenerationId, ) -> Result<WorkspaceLineageRecord, WorkspaceLineageError<S::Error>>

Registers a child created by another SDK-owned fork façade.

Lazy workspaces use this after their source-overlay binding and physical workspace fork have both become durable. Repeating the exact lineage is idempotent; a competing parent or fork point is rejected.

pub async fn register_existing_child_at_generation<A: AsyncAuthorityStore, O: AsyncObjectStore>( &self, parent: &Workspace<A, O>, child: &Workspace<A, O>, fork_generation: GenerationId, initial_generation: GenerationId, ) -> Result<WorkspaceLineageRecord, WorkspaceLineageError<S::Error>>

Registers an existing child after it has advanced beyond its initial fork generation, while still authenticating that exact fork point.

pub async fn authorize_join( &self, child: WorkspaceId, parent: WorkspaceId, ) -> Result<WorkspaceLineageRecord, WorkspaceLineageError<S::Error>>

Verifies that parent is the child’s exact direct publication target.

pub async fn resolve( &self, workspace: WorkspaceId, ) -> Result<WorkspaceLineageRecord, WorkspaceLineageError<S::Error>>

Resolves one durable workspace identity to its canonical lineage record.

This is the restart-safe lookup used by thin adapters that retain only workspace IDs in compatibility state.

pub async fn ancestors( &self, workspace: WorkspaceId, maximum: u32, ) -> Result<Vec<WorkspaceLineageRecord>, WorkspaceLineageError<S::Error>>

Returns the direct-parent chain, nearest parent first.