Struct StorageBlockCompactor 

pub struct StorageBlockCompactor {
    pub fragments: HashMap<u64, BlockFragment>,
    pub config: CompactorConfig,
    pub stats: CompactorStats,
    pub next_segment_id: u64,
}

Merges small fragmented blocks into larger compacted segments.

Fields

fragments: HashMap<u64, BlockFragment>

Registered fragments keyed by block_id.

config: CompactorConfig

Compactor configuration.

stats: CompactorStats

Accumulated statistics.

next_segment_id: u64

Counter for generating unique segment IDs.

Implementations

impl StorageBlockCompactor

pub fn new(config: CompactorConfig) -> Self

Creates a new StorageBlockCompactor with the given configuration.

pub fn register_block( &mut self, block_id: u64, cid: String, size_bytes: u64, tick: u64, )

Registers a block as a compaction candidate.

Only blocks with size_bytes < min_block_size_to_compact are registered; larger blocks are silently skipped.

pub fn touch(&mut self, block_id: u64, tick: u64) -> bool

Updates the last_accessed_tick for a registered block.

Returns true if the block was found and updated, false otherwise.

pub fn plan_compaction(&mut self) -> CompactionPlan

Produces a compaction plan by greedily grouping fragments into segments.

Fragments are sorted by size (ascending), then by block_id (ascending) for stable ordering. Segments with fewer than 2 blocks are excluded from the plan.

pub fn remove_block(&mut self, block_id: u64) -> bool

Removes a registered block fragment.

Returns true if the block was present and removed, false otherwise.

pub fn fragmentation_ratio(&self) -> f64

Returns the fragmentation ratio: blocks smaller than target_segment_bytes / 2 divided by total registered blocks.

Returns 0.0 if no fragments are registered.

pub fn stats(&self) -> &CompactorStats

Returns a reference to the accumulated statistics.