Struct FileLifecycleManager 

pub struct FileLifecycleManager;

File lifecycle management utilities for GraphFile

Implementations

impl FileLifecycleManager

pub fn create<P: AsRef<Path>>(path: P) -> NativeResult<GraphFile>

Create a new graph file with initial header

Creates a new graph file with V2 format, initializes the header, writes initial state to disk, and sets up file structures.

pub fn open<P: AsRef<Path>>(path: P) -> NativeResult<GraphFile>

Open an existing graph file

Opens an existing graph file, validates the V2 format, reads the header, and initializes file structures. Automatically migrates V2 format files to V3 format.

pub fn read_header(graph_file: &mut GraphFile) -> NativeResult<()>

Read header from file

Reads and validates the persistent header from disk.

pub fn write_header(graph_file: &mut GraphFile) -> NativeResult<()>

Write header to file with durable persistence

This is the ONLY authorized way to write to header region [0, HEADER_SIZE)

pub fn sync(graph_file: &GraphFile) -> NativeResult<()>

Sync file to disk

Ensures all buffered data is written to persistent storage.