Struct IndexManager 

pub struct IndexManager { /* private fields */ }

Index manager for atomic updates with file locking

Implementations

impl IndexManager

pub fn new(registry_path: PathBuf) -> Self

Create a new IndexManager instance

Arguments

• registry_path - Base path to the registry index directory

Returns

Configured IndexManager instance with default 30-second lock timeout

pub fn atomic_update( &self, skill_id: &str, version: &str, entry: &VersionEntry, ) -> Result<(), ServiceError>

Atomically update the index file for a skill version

This method:

1. Normalizes the skill_id using ScopedSkillName::normalize()
2. Checks for duplicate versions
3. Acquires an exclusive file lock with timeout
4. Reads existing entries
5. Appends new entry
6. Writes to temporary file
7. Atomically renames temporary file to target
8. Releases lock

Arguments

• skill_id - The skill identifier (may be scoped, e.g., @org/package)
• version - The version string (e.g., 1.0.0)
• entry - The version entry to add to the index

Returns

Ok(()) if successful, Err(ServiceError) if operation fails

Errors

• Returns ServiceError::Custom if duplicate version is detected
• Returns ServiceError::Custom if lock timeout is exceeded
• Returns ServiceError::Io for filesystem errors