Struct TopologyMigrationRoot 

pub struct TopologyMigrationRoot {
    pub format_version: u16,
    pub operation_id: TopologyOperationId,
    pub plan: TopologyPlanRef,
    pub compatibility: TopologyCompatibilityRef,
    pub cut: TopologyCutCommit,
    pub preserved_objects: Vec<TopologyPreservedObject>,
    pub future_only_objects: Vec<String>,
    pub subscriptions: Vec<TopologySubscriptionRoot>,
    pub source_initializations: Vec<TopologySourceInitialization>,
}

Immutable target restore/initialization requirements, retained by one authority append. All state ranges, source/snapshot/channel progress, sink decisions and replay segment references remain in the exact old checkpoint. No historical manifest or state payload is rewritten.

Fields

format_version: u16

Root encoding, separate from logical topology, catalog and checkpoint versions.

operation_id: TopologyOperationId

Exact admitted request.

plan: TopologyPlanRef

Immutable admission payload.

compatibility: TopologyCompatibilityRef

Complete participant-certified compatibility descriptor.

cut: TopologyCutCommit

Definitive old-topology checkpoint and its shared Commit append.

preserved_objects: Vec<TopologyPreservedObject>

Sorted exact identity mappings for every unchanged object.

future_only_objects: Vec<String>

Sorted new objects. Streams/sinks receive only target input; sources use their sealed cursors.

subscriptions: Vec<TopologySubscriptionRoot>

Sorted preserved subscription incarnations and publication frontiers.

source_initializations: Vec<TopologySourceInitialization>

Sorted new-source positions, sealed once for this exact operation and cut. Empty format-1 roots retain their original canonical bytes.

Implementations

impl TopologyMigrationRoot

pub fn validate_target_checkpoint_predecessor( &self, descriptor: &ClusterTopologyValidation, target: &CommittedCheckpointIndex, parent: &CommittedCheckpointIndex, ) -> Result<(), TopologyError>

Check the first target index against the exact retained parent index and sealed mapping. The authority must first audit this root’s durable Commit/Release. This pure check grants no writer or runtime permission and never changes either checkpoint’s historical identity.

Errors

Rejects a foreign cut, changed source inventory, ownership/ABI/deployment or regressed watermarks. Ordinary checkpoint continuity continues to require identical pipeline IDs.

impl TopologyMigrationRoot

pub fn validate_restore_cut( &self, operation: &TopologyAdmissionStatus, descriptor: &ClusterTopologyValidation, index: &CommittedCheckpointIndex, manifests: &[CheckpointManifest], ) -> Result<(), TopologyError>

Rebuild the exact requirements from checksummed historical manifests before target restore. This does not rewrite their parent identity or grant installation/output authority.

Errors

Rejects missing, divergent or reordered state/progress/subscription mappings.

pub fn encode_and_reference( &self, ) -> Result<(Vec<u8>, TopologyMigrationRootRef), TopologyError>

Canonical bounded body for durable storage. This encodes requirements, never authority.

Errors

Rejects malformed identities, unordered mappings or a body above 1 MiB.

Trait Implementations

impl Clone for TopologyMigrationRoot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TopologyMigrationRoot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TopologyMigrationRoot

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TopologyMigrationRoot

impl PartialEq for TopologyMigrationRoot

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TopologyMigrationRoot

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TopologyMigrationRoot