Struct Index 

pub struct Index {
    pub units: Vec<IndexEntry>,
}

The in-memory and on-disk unit index.

Holds a flat list of IndexEntry values for all active (non-archived) units in the project. Archived units are stored separately in .mana/archive/ and are not included here.

Obtain an index via Index::load_or_rebuild (lazy, cached) or Index::build (always scans unit files from disk).

Fields

units: Vec<IndexEntry>

All active units, sorted by ID in natural order.

Implementations

impl Index

pub fn build(mana_dir: &Path) -> Result<Index, Error>

Build the index by reading all unit files from the units directory. Supports both new format ({id}-{slug}.md) and legacy format ({id}.yaml). Excludes config.yaml, index.yaml, and unit.yaml. Sorts entries by ID using natural ordering. Returns an error if duplicate unit IDs are detected.

pub fn is_stale(mana_dir: &Path) -> Result<bool, Error>

Check whether the cached index is stale. Returns true if the index file is missing or if any unit file (.md or .yaml) in the units directory has been modified after the index was last written.

pub fn load_or_rebuild(mana_dir: &Path) -> Result<Index, Error>

Load the cached index or rebuild it if stale. This is the main entry point for read-heavy commands.

pub fn load(mana_dir: &Path) -> Result<Index, Error>

Load the index from the cached index.yaml file.

pub fn save(&self, mana_dir: &Path) -> Result<(), Error>

Save the index to .mana/index.yaml.

pub fn collect_archived(mana_dir: &Path) -> Result<Vec<IndexEntry>, Error>

Collect all archived units from .mana/archive/ directory. Walks through year/month subdirectories and loads all unit files. Returns IndexEntry items for archived units.

Trait Implementations

impl Clone for Index

fn clone(&self) -> Index

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Index

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Index

fn deserialize<__D>( __deserializer: __D, ) -> Result<Index, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Index

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Index

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Index