Struct ResolvedProject 

pub struct ResolvedProject {
    pub project_root: PathBuf,
    pub git_root: Option<PathBuf>,
    pub project_name: String,
    pub db_path: PathBuf,
}

Resolved project information returned by the single shared resolver.

Used by every CLI command that needs to locate a project (scan, serve, review, status, decisions, uninstall, debug). Whether the DB file exists on disk is NOT checked here — the caller decides how to handle a missing database.

Worktree-stable identity. Self::project_name is derived from the git common-dir’s basename (when available), so all worktrees of one git repository resolve to the same Self::db_path. Self::project_root remains the working tree directory the caller is operating on, so file reads still happen in the worktree the user is sitting in.

Fields

project_root: PathBuf

Working tree directory — where source files are read from. For git worktrees, this is the worktree directory (NOT the main repo root). For non-git directories, this is the canonicalised input path.

git_root: Option<PathBuf>

Main repository root, where .git lives. Same for every worktree of a single repository. None for non-git directories.

project_name: String

Stable DB filename stem. Derived from git_root.file_name() when available, otherwise from project_root.file_name().

db_path: PathBuf

Full DB path: xdg_repos_dir / "{project_name}.db". May or may not exist on disk.

Implementations

impl ResolvedProject

pub fn sync_root(&self) -> &Path

Root used for git operations (gix open, tree-diff, ref resolution, branch GC). Falls back to Self::project_root for non-git directories so callers get a usable path either way.