Struct Repository 

pub struct Repository {
    pub root: PathBuf,
    pub universe: String,
    /* private fields */
}

A NAP universe repository.

Fields

root: PathBuf

Filesystem path to the repository root.

universe: String

The universe name (derived from directory name).

Implementations

impl Repository

pub fn open(path: &Path, vcs: Box<dyn VcsBackend>) -> Result<Self, NapError>

Open an existing NAP repository at the given path.

pub fn init( path: &Path, universe: &str, vcs: Box<dyn VcsBackend>, ) -> Result<Self, NapError>

Initialize a new NAP repository.

pub fn manifest_path(&self, entity_type: EntityType, entity_id: &str) -> PathBuf

Get the full filesystem path to an entity’s manifest file.

pub fn read_manifest( &self, entity_type: EntityType, entity_id: &str, ) -> Result<Manifest, NapError>

Read a manifest from the repository.

pub fn read_manifest_at_ref( &self, entity_type: EntityType, entity_id: &str, reference: &str, ) -> Result<Manifest, NapError>

Read a manifest at a specific VCS ref (commit, branch, tag).

pub fn write_manifest(&self, manifest: &Manifest) -> Result<PathBuf, NapError>

Write a manifest to the repository (does NOT commit).

pub fn create_entity( &self, entity_type: EntityType, entity_id: &str, name: &str, author: &str, ) -> Result<(Manifest, String), NapError>

Create a new entity manifest and commit it.

pub fn commit_manifest( &self, manifest: &mut Manifest, message: &str, author: &str, changes: Vec<Change>, ) -> Result<Commit, NapError>

Update an existing manifest and commit the changes.

pub fn history( &self, entity_type: EntityType, entity_id: &str, limit: usize, ) -> Result<Vec<CommitInfo>, NapError>

Get the commit history for a specific entity.

pub fn list_entities( &self, entity_type: EntityType, ) -> Result<Vec<String>, NapError>

List all entity IDs of a given type in the repository.

pub fn delete_entity( &self, entity_type: EntityType, entity_id: &str, author: &str, ) -> Result<String, NapError>

Delete an entity manifest and commit the deletion.

pub fn create_branch(&self, name: &str) -> Result<(), NapError>

Create a branch in the underlying VCS.

pub fn switch_branch(&self, name: &str) -> Result<(), NapError>

Switch to a branch.

pub fn create_tag(&self, name: &str) -> Result<(), NapError>

Create a tag.

pub fn list_branches(&self) -> Result<Vec<String>, NapError>

List branches.

pub fn list_tags(&self) -> Result<Vec<String>, NapError>

List tags.

pub fn revert_commit( &self, commit_hash: &str, author: &str, ) -> Result<String, NapError>

Revert a commit by creating a new VCS commit that undoes the specified one.

The revert is a universe-level operation (not entity-scoped) — a single Git commit can touch multiple files across multiple entity types. After reverting, working-tree files are restored to their pre-commit content and a new revert commit is created in VCS history.

pub fn head_hash(&self) -> Result<String, NapError>

Get current HEAD hash.

pub fn resolve_branch_head(&self, branch: &str) -> Result<String, NapError>

Resolve the most recent commit hash on a given branch.

pub fn add_remote(&self, name: &str, url: &str) -> Result<(), NapError>

Add a remote to the repository.

pub fn remove_remote(&self, name: &str) -> Result<(), NapError>

Remove a remote from the repository.

pub fn list_remotes(&self) -> Result<Vec<(String, String)>, NapError>

List remotes as (name, url) pairs.

pub fn push( &self, remote: Option<&str>, branch: Option<&str>, ) -> Result<(), NapError>

Push the current branch to a remote.

pub fn pull( &self, remote: Option<&str>, branch: Option<&str>, ) -> Result<(), NapError>

Pull the current branch from a remote.

pub fn vcs(&self) -> &dyn VcsBackend

Access the VCS backend (for the resolver to read files at specific refs).