Struct ProjectScope 

pub struct ProjectScope { /* private fields */ }

Host-resolved project identity: the canonical workspace root, digested into a stable scope key. The HOST constructs this from trusted execution context — it is never accepted solely from model-authored arguments.

Implementations

impl ProjectScope

pub fn discover_repository( start: &Path, ) -> Result<RepositoryIdentity, MemoryError>

Opt-in repository discovery. The explicit SYNAPS_PROJECT_ROOT override wins and disables Git sharing; malformed Git/private state is an error, never a fallback to an unrelated or newly generated scope.

pub fn discover_repository_with_override( start: &Path, override_root: Option<&Path>, ) -> Result<RepositoryIdentity, MemoryError>

Environment-free counterpart; Some(root) preserves the legacy override semantics even if root is a subdirectory/worktree of a Git repository.

impl ProjectScope

pub fn for_root(root: &Path) -> Result<Self, MemoryError>

Resolve a scope from a workspace root. The path is canonicalized so every spelling of the same directory yields one project identity.

pub fn user_scope(root: &Path) -> Result<Self, MemoryError>

Construct an explicit user-wide scope at a canonical host base path. This is the ONLY constructor accepting the reserved all-zero key. Never derive this scope from model-authored project arguments.

pub fn from_key(root: &Path, key: &str) -> Result<Self, MemoryError>

Restore a host-verified key (e.g. an operator migration manifest). Syntax validation is NOT authorization: callers must establish the key’s trusted provenance, never accept a model-supplied key as a scope grant. Accepts exactly p[0-9a-f]{16}, excluding the user-wide reserved key.

pub fn key(&self) -> &str

Stable scope key (p<16 hex>).

pub fn discover(start: &Path) -> Result<Self, MemoryError>

Discover the stable project root for a starting directory (CP-13 fix1 I2): the SYNAPS_PROJECT_ROOT env override wins; otherwise a bounded upward walk finds the nearest directory containing a .git entry (DIRECTORY or FILE — worktree-safe, no process spawning, no gitdir parsing) or a .synaps-project marker; with no marker the start directory itself is the root.

pub fn discover_with_override( start: &Path, override_root: Option<&Path>, ) -> Result<Self, MemoryError>

Self::discover with an explicit override (env-free seam).

pub fn root(&self) -> &Path

The canonical workspace root.

pub fn namespace(&self) -> String

The JSONL namespace holding this project’s records.

Trait Implementations

impl Clone for ProjectScope

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 ProjectScope

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

Formats the value using the given formatter.

impl Eq for ProjectScope

impl PartialEq for ProjectScope

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProjectScope