Method canonical_dot_dir

atomic-repository/src/repository/mod.rs:538–543

Resolve the **canonical** `.atomic` directory for a working path without* opening the database. If `path` is inside an agent sandbox, follows the `.atomic-sandbox` pointer to the canonical repository; otherwise finds the enclosing repository root. Returns ` /.atomic`. Use this for lock-free filesystem access to the canonical graph — e.g. writing a provenance graph through [`Change

(path: P)

    /// sandbox `path/.atomic` is a throwaway local dir (or absent), so joining
    /// `.atomic` onto the working root would miss the real graph entirely.
    pub fn canonical_dot_dir<P: AsRef<Path>>(path: P) -> Result<PathBuf, RepositoryError> {
        if let Some((_working, canonical, _view)) = sandbox::detect_sandbox(path.as_ref()) {
            return Ok(Self::find_root(&canonical)?.join(DOT_DIR));
        }
        Ok(Self::find_root(path.as_ref())?.join(DOT_DIR))
    }

    /// Get the repository root path.
    #[inline]