Struct WorkspaceId 

pub struct WorkspaceId(/* private fields */);

A workspace identifier.

Stable across sessions and across machines. Two mechanisms exist (per docs/concepts/workspace-model.md § 3):

• Git-backed — WorkspaceId::from_git_remote(origin_url) produces a deterministic hash of the normalised remote URL. Branch is not part of the ID by default; all branches of a repo share one workspace.
• Non-git — WorkspaceId::from_ulid(Ulid) creates an explicit identifier for workspaces not backed by a git repo.

Examples

use mimir_core::WorkspaceId;

let a = WorkspaceId::from_git_remote("git@github.com:buildepicshit/Mimir.git").unwrap();
let b = WorkspaceId::from_git_remote("https://github.com/buildepicshit/Mimir").unwrap();
// The normalisation collapses scheme and trailing `.git` so equivalent
// remotes resolve to equivalent workspace IDs where host+path match.
// (Exact normalisation rules live in §§ 3.1 of workspace-model.md.)
assert_ne!(a, b); // SSH and HTTPS remotes with different hosts do differ.

Implementations

impl WorkspaceId

pub fn from_git_remote(origin_url: &str) -> Result<Self, WorkspaceIdError>

Compute a workspace ID from a git origin remote URL.

Normalisation performed before hashing:

1. Trim surrounding whitespace.
2. Lowercase the whole URL.
3. Strip any trailing .git suffix.
4. Strip any trailing slash.

Branch is intentionally not included (see workspace-model.md § 3.1).

Errors

Returns WorkspaceIdError::EmptyRemote if the URL is empty after normalisation.

pub fn from_ulid(ulid: Ulid) -> Self

Construct from an explicit ULID — for non-git workspaces created via mimir init --workspace <name> (see workspace-model.md § 3.2).

pub const fn as_bytes(&self) -> &[u8; 32]

The raw 32-byte hash.

pub fn detect_from_path(start: &Path) -> Result<Self, WorkspaceError>

Walk up from start looking for a .git/ directory and, on finding one, read origin remote URL from .git/config and hash it per WorkspaceId::from_git_remote.

Implements workspace-model.md § 3.3 step 1 (git-backed workspaces). Returns WorkspaceError::NoActiveWorkspace if the walk reaches the filesystem root without finding .git/.

Errors

• WorkspaceError::Io on filesystem read failure.
• WorkspaceError::NoActiveWorkspace if no .git/ is found.
• WorkspaceError::NoOriginRemote if the config has no [remote "origin"] url = ... entry.
• WorkspaceError::InvalidRemote if the origin URL normalises to an empty string.

Trait Implementations

impl Clone for WorkspaceId

fn clone(&self) -> WorkspaceId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceId

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

Formats the value using the given formatter.

impl Display for WorkspaceId

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

Formats the value using the given formatter.

impl Hash for WorkspaceId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WorkspaceId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for WorkspaceId

impl Eq for WorkspaceId

impl StructuralPartialEq for WorkspaceId