Crate kvbm_logical 

Logical block lifecycle management for KVBM.

This crate provides the core block lifecycle system:

• Type-safe state transitions (Reset -> Complete -> Registered)
• Block registry with deduplication and attachments
• Active/inactive/reset pool management
• Event pipeline for distributed coordination
• Block manager orchestration

Re-exports

pub use blocks::BlockError;

pub use blocks::BlockMetadata;

pub use blocks::CompleteBlock;

pub use blocks::ImmutableBlock;

pub use blocks::LifecyclePin;

pub use blocks::LifecyclePinRef;

pub use blocks::MutableBlock;

pub use blocks::WeakBlock;

pub use integrations::ApplyError;

pub use integrations::DecodeOutcome;

pub use integrations::NoopDelegate;

pub use integrations::RequestSequence;

pub use integrations::SchedulableSequence;

pub use integrations::SchedulableSequenceBuilder;

pub use integrations::ScheduleError;

pub use integrations::SequenceDelegate;

pub use integrations::SequenceEvent;

pub use integrations::SequenceState;

pub use manager::BlockManager;

pub use registry::BlockRegistry;

pub use sequence::BlockSequence;

pub use sequence::BlockSequenceError;

pub use sequence::ExternalBlockAssignments;

pub use sequence::LogicalBlockAssignmentError;

pub use sequence::LogicalBlockAssignments;

pub use sequence::zip_assigned;

pub use sequence::zip_assigned_pending;

Modules

blocks

RAII guard types that enforce the block lifecycle state machine.

events

integrations

Composition layer wiring together BlockSequence, LogicalBlockAssignments, and BlockManager into higher-level request lifecycle types.

manager

Block lifecycle orchestration over the unified [BlockStore].

metrics

Prometheus metrics for block pool observability.

pools

Block pool bookkeeping for thread-safe block management.

pubsub

Publisher trait for distributed messaging.

registry

Global registry for block deduplication via weak references and sequence hash matching.

sequence

Sequence Module

tinylfu

Frequency tracking for block reuse policies using Count-Min Sketch.

Structs

ManagerId

Stable, process-unique identifier for a BlockManager’s underlying BlockStore.

Enums

LogicalLayoutHandle

Logical layout handle type encoding the layout ID.

Traits

KvbmSequenceHashProvider

Type Aliases

BlockId

SequenceHash