Struct RepoService 

pub struct RepoService {
    pub permission_gate: PermissionGate,
    pub context_docs: ContextDocsManager,
    /* private fields */
}

High-level interface for all VCS operations in NAP.

Thread safety

RepoService is Send + Sync and safe to share across threads. Internal state (e.g., the permission gate cache, context-doc graph) uses interior mutability.

Fields

permission_gate: PermissionGate

Permission gate.

context_docs: ContextDocsManager

Context-document manager.

Implementations

impl RepoService

pub fn new( backend: Box<dyn VcsBackend>, workspace_root: &Path, ) -> Result<Self, NapError>

Create a new RepoService with the given backend and workspace path.

The permission gate is loaded from context/nap-gate.toml if it exists, otherwise a permissive gate is used. Use RepoService::with_gate for custom gate behaviour.

pub fn with_gate( backend: Box<dyn VcsBackend>, workspace_root: &Path, permission_gate: PermissionGate, ) -> Self

Create a RepoService with an explicit permission gate.

pub fn from_env(workspace_root: &Path) -> Result<Self, NapError>

Create a RepoService from environment variables (for the common local-dev case).

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

The underlying VCS backend (for advanced use).

pub fn workspace_root(&self) -> &Path

Workspace root path.

pub fn create_repository( &self, workspace_id: &str, repo_id: &str, _opts: RepoOptions, ) -> Result<Repository, NapError>

Create a repository on the lore server and clone it locally.

This is the primary way to bootstrap a NAP workspace.

pub fn open_workspace(&self) -> Result<Workspace, NapError>

Open an existing local workspace (assumes lore clone already happened, or the workspace directory already exists).

pub fn write_file( &self, path: &str, content: &str, principal: &str, ) -> Result<(), NapError>

Write a file, checking permissions first.

pub fn read_file(&self, path: &str, principal: &str) -> Result<String, NapError>

Read a file, checking permissions first.

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

Commit staged changes.

pub fn log( &self, file: Option<&str>, limit: usize, ) -> Result<Vec<CommitInfo>, NapError>

Get commit history.

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

Create a branch.

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

Switch to a branch.

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

Get current branch.

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

List branches.

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

Create a tag.

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

List tags.

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

Push to the lore server.

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

Pull from the lore server.

pub fn register_context_doc( &self, path: &str, metadata: &[(&str, &str)], ) -> Result<(), NapError>

Register a context document. See ContextDocsManager::register.

pub fn add_context_dep( &self, source: &str, target: &str, ) -> Result<(), NapError>

Add a dependency between context documents.

pub fn all_context_docs(&self) -> Result<Vec<ContextDocument>, NapError>

Get all context documents.

pub fn start_autopublish( &self, config: AutopublishConfig, ) -> Result<AutopublishHandle, NapError>

Start the autopublish worker.

The worker takes ownership of a new backend instance (created from env variables) so the shared RepoService backend is not consumed. If you need a worker with a specific backend, construct AutopublishWorker directly.