Struct Repository 

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

A NAP repository.

Fields

root: PathBuf

Filesystem path to the repository root.

repository: String

The repository 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 with a VCS backend.

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

Open an existing NAP repository at the given path.

vcs may be None to operate in unversioned mode.

pub fn read_resolve_config(&self) -> ResolveConfig

Read the resolve configuration from repository.yaml (or repository.yaml) metadata.

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

Initialize a new NAP repository with a VCS backend.

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

Initialize a new NAP repository.

vcs may be None to initialize in unversioned mode — the repository structure is created and an initial filesystem state is written, but no version-control workspace or initial commit is created.

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

Bootstrap a VCS backend for an already-initialized repository that was created in unversioned mode.

Initializes the backend at the repository root and creates an initial commit capturing the current filesystem state. Used by nap backend configure when a backend is configured after the fact.

Errors if no backend is available (unversioned mode).

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 list_entity_types(&self) -> Result<Vec<EntityType>, NapError>

Discover all entity types in this repository.

Scans the repository root for directories containing a .entity-type marker file OR directories containing at least one .yaml file (implicit discovery for backward compatibility).

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 list_branches(&self) -> Result<Vec<String>, NapError>

List branches.

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.

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) -> Option<&dyn VcsBackend>

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

Returns None when no version-control backend is configured (unversioned mode).