Struct IndexRegistry 

pub struct IndexRegistry<I: Index> { /* private fields */ }

Generic registry for index entries.

Provides:

• Named lookup with priority-based overrides
• Lazy content loading with caching
• Summary generation for system prompts

Example

let registry = IndexRegistry::new();
registry.register(skill_index);

// Get metadata (always fast)
let idx = registry.get("commit").unwrap();

// Load full content (lazy, cached)
let content = registry.load_content("commit").await?;

// Generate summary for system prompt
let summary = registry.build_summary();

Implementations

impl<I: Index> IndexRegistry<I>

pub fn new() -> Self

Create a new empty registry.

pub fn register(&mut self, index: I)

Register an index entry.

If an entry with the same name exists, it’s replaced only if the new entry has equal or higher priority.

pub fn register_all(&mut self, indices: impl IntoIterator<Item = I>)

Register multiple index entries.

pub fn get(&self, name: &str) -> Option<&I>

Get an index entry by name.

pub fn list(&self) -> Vec<&str>

List all registered names.

pub fn iter(&self) -> impl Iterator<Item = &I>

Iterate over all index entries.

pub fn len(&self) -> usize

Get the number of registered entries.

pub fn is_empty(&self) -> bool

Check if the registry is empty.

pub fn contains(&self, name: &str) -> bool

Check if an entry with the given name exists.

pub async fn remove(&mut self, name: &str) -> Option<I>

Remove an entry by name.

Also clears the cached content for this entry.

pub async fn clear(&mut self)

Clear all entries.

Also clears all cached content.

pub async fn load_content(&self, name: &str) -> Result<String>

Load content for an index entry with caching.

Returns cached content if available, otherwise loads from source.

pub async fn invalidate_cache(&self, name: &str)

Invalidate cached content for an entry.

pub async fn clear_cache(&self)

Clear all cached content.

pub fn build_summary(&self) -> String

Build a summary of all entries for system prompt injection.

Returns a formatted string with one summary line per entry.

pub fn build_summary_with<F>(&self, formatter: F) -> String

where F: Fn(&I) -> String,

Build a summary with a custom formatter.

pub fn sorted_by_priority(&self) -> Vec<&I>

Get entries sorted by priority (highest first).

pub fn filter<F>(&self, predicate: F) -> Vec<&I>

where F: Fn(&I) -> bool,

Filter entries by a predicate.

impl<I: Index + PathMatched> IndexRegistry<I>

pub fn find_matching(&self, path: &Path) -> Vec<&I>

Find all entries that match the given file path.

Returns entries sorted by priority (highest first).

Example

let matching = registry.find_matching(Path::new("src/lib.rs"));
for entry in matching {
    println!("Matched: {}", entry.name());
}

pub async fn load_matching(&self, path: &Path) -> Vec<LoadedEntry<I>>

Load content for all entries matching the given file path.

Returns loaded entries sorted by priority (highest first). Entries that fail to load are skipped.

pub fn has_matching(&self, path: &Path) -> bool

Check if any entry matches the given file path.

pub fn build_matching_summary(&self, path: &Path) -> String

Build summary for entries matching a specific path.

impl IndexRegistry<OutputStyle>

pub fn with_builtins() -> Self

Available on crate feature cli-integration only.

pub async fn load_from_directories( &mut self, working_dir: Option<&Path>, ) -> Result<()>

Available on crate feature cli-integration only.

Trait Implementations

impl<I: Index> Clone for IndexRegistry<I>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I: Index> Default for IndexRegistry<I>

fn default() -> Self

Returns the “default value” for a type.

impl<I: Index> FromIterator<I> for IndexRegistry<I>

fn from_iter<T: IntoIterator<Item = I>>(iter: T) -> Self

Creates a value from an iterator.