Struct LoreBackend 

pub struct LoreBackend { /* private fields */ }

A VcsBackend implementation backed by the Lore VCS CLI (lore(1)).

LoreBackend requires a remote lore:// URL and a workspace identity so that it can call lore repository create / lore clone during init.

Use LoreBackend::new() for the default configuration (reads env-var overrides for the server URL, or falls back to a local-dev default).

Implementations

impl LoreBackend

pub fn from_nap_home(nap_home: &Path) -> Self

Construct a backend using a specific NAP home rather than whichever directory happens to be in NAP_DIR.

pub fn configured_server_url(nap_home: &Path) -> String

Resolve the configured Lore server for a NAP home. This is shared by remote readers so --base-dir is respected instead of silently consulting a different NAP_DIR.

pub fn new(remote_url: &str, workspace_id: &str) -> Self

Create a new Lore backend.

remote_url should be a lore://host/repository URL. workspace_id scopes the repository to a multi-tenant workspace.

pub fn remote_url(&self) -> &str

pub fn clone_repo(url: &str, dest: &Path) -> Result<(), NapError>

Clone a remote Lore repository to a local path.

Equivalent to lore clone <url> <dest>. Does NOT require an existing LoreBackend instance — use this when you just want to clone and don’t need a full backend.

pub fn clone_repo_with_root_files( url: &str, dest: &Path, root_files: &[String], ) -> Result<(), NapError>

Clone only the requested repository-root files and their dependencies. Lore keeps the resulting checkout sparse while still materialising the NAP manifests needed by an entity pull.

pub fn sync_root_files( dest: &Path, root_files: &[String], ) -> Result<(), NapError>

Synchronize selected root files in an existing Lore working tree.

pub fn from_env() -> Self

Convenience constructor that reads configuration from environment variables with sensible local-development defaults.

Precedence: env vars > provider config > defaults

Env var	Default
NAP_LORE_URL_BASE	provider-dependent; local uses lore://localhost:41337
NAP_WORKSPACE_ID	default

Note: For new code, prefer using the RepositoryApi with Provider architecture instead of this legacy environment-based constructor.

pub fn from_provider(url_base: &str, workspace_id: &str) -> Self

Create LoreBackend from provider configuration

This is the preferred constructor for new code using the Provider architecture.

Trait Implementations

impl Clone for LoreBackend

fn clone(&self) -> LoreBackend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoreBackend

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

Formats the value using the given formatter.

impl VcsBackend for LoreBackend

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

Get the remote URL base for constructing repository URLs.

fn init(&self, path: &Path) -> Result<(), NapError>

Initialize a new repository at the given path.

fn commit( &self, path: &Path, message: &str, author: &str, ) -> Result<String, NapError>

Stage all files and create a commit.

fn read_file_at_ref( &self, repo_path: &Path, file_path: &str, reference: Option<&str>, ) -> Result<String, NapError>

Read a file’s content at a specific ref (branch, tag, or commit hash). If reference is None, reads from the current working tree.

fn read_file_bytes_at_ref( &self, repo_path: &Path, file_path: &str, reference: Option<&str>, ) -> Result<Vec<u8>, NapError>

Read arbitrary file bytes at a specific ref.

fn repository_descriptor( &self, repo_path: &Path, ) -> Result<VcsRepositoryDescriptor, NapError>

Return the repository ID separately from any file-address context.

fn http_bearer_token( &self, repo_path: &Path, repository_id: &str, http_origin: &str, ) -> Result<Option<String>, NapError>

Reuse the active Lore login’s unexpired repository token for an authorized HTTP recipient. Implementations must not log tokens or return an unscoped authentication token.

fn file_content_address_at_ref( &self, repo_path: &Path, file_path: &str, reference: &str, ) -> Result<VcsContentAddress, NapError>

Return the immutable content address of a file at a pinned revision.

fn file_metadata_at_ref( &self, repo_path: &Path, file_path: &str, reference: &str, ) -> Result<Option<BTreeMap<String, String>>, NapError>

Read file metadata attached to a path at a specific revision.

fn read_provenance_blob( &self, repo_path: &Path, address: &str, ) -> Result<String, NapError>

Read a readable immutable provenance artifact by Lore address/hash.

fn log( &self, path: &Path, _file: Option<&str>, limit: usize, ) -> Result<Vec<CommitInfo>, NapError>

Get the commit log for the repository, optionally filtered to a specific file.

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

Create a new branch.

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

Switch to a branch.

fn current_branch(&self, path: &Path) -> Result<String, NapError>

Get the current branch name.

fn list_branches(&self, path: &Path) -> Result<Vec<String>, NapError>

List all branches.

fn head_hash(&self, path: &Path) -> Result<String, NapError>

Get the HEAD commit hash.

fn revert(&self, path: &Path, commit_hash: &str) -> Result<String, NapError>

Revert a commit by creating a new commit that undoes it.

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

Resolve the most recent commit hash on a given branch.

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

Add a remote.

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

Remove a remote.

fn list_remotes(&self, path: &Path) -> Result<Vec<(String, String)>, NapError>

List remotes as (name, url) pairs.

fn push( &self, path: &Path, _remote: Option<&str>, branch: Option<&str>, ) -> Result<(), NapError>

Push the current branch to its upstream / a named remote.

fn pull( &self, path: &Path, _remote: Option<&str>, _branch: Option<&str>, ) -> Result<(), NapError>

Pull the current branch from its upstream / a named remote.