Struct Workspace 

pub struct Workspace {
    pub root: PathBuf,
    pub canonical_root: PathBuf,
    pub repo_name: String,
}

Represents a bound workspace session.

Fields

root: PathBuf

canonical_root: PathBuf

repo_name: String

Implementations

impl Workspace

pub fn discover(start_path: Option<&Path>) -> Result<Self, WorkspaceError>

Discover and bind a workspace from an optional path, falling back to CWD and upward traversal.

pub fn new(root: PathBuf) -> Self

Create workspace binding directly for a known root directory.

pub fn find_workspace_root(start: &Path) -> Result<PathBuf, WorkspaceError>

Find root by searching upwards for .git, .code-kb, or workspace markers.

pub fn from_project_root(input: &str) -> Result<Workspace, WorkspaceError>

Resolves the project_root of a tool call: an absolute path or file:// URI of the project or git worktree, or of any folder or file inside it.

pub fn nested_project_root(&self, path: &Path) -> Option<PathBuf>

For an absolute path inside this workspace, returns the nearest folder from the path up to the root (the root excluded) that holds .git: a nested git worktree or submodule.

pub fn resolve_path( &self, input: &Path, ) -> Result<(PathBuf, String), WorkspaceError>

Resolves an input path (relative, absolute, or file:// URI) to a canonical absolute path and relative path.

pub fn relativize_filter(&self, filter: &str) -> String

Relativizes a path filter string (which may be absolute, file:// URI, or relative) against this workspace root into a forward-slash relative path suitable for SQLite queries.

pub fn candidate_db_paths(&self, explicit_db: Option<&Path>) -> Vec<PathBuf>

Resolve candidate database paths for this workspace:

1. Explicit override path (if provided)
2. In-tree .code-kb/artifact.db or .code-kb/store.db

pub fn locate_db( &self, explicit_db: Option<&Path>, ) -> Result<PathBuf, WorkspaceError>

Finds the first existing database file, or returns the default target location.

Trait Implementations

impl Clone for Workspace

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Workspace

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

Formats the value using the given formatter.