Struct ProjectStore 

pub struct ProjectStore { /* private fields */ }

Implementations

impl ProjectStore

pub fn legacy_memory_source_root( &self, legacy_project_key: &str, ) -> ProjectStoreResult<PathBuf>

Physical legacy path-hash scope. This is always read-only.

pub fn migrate_legacy_memory( &self, project_id: &ProjectId, legacy_project_key: &str, ) -> ProjectStoreResult<LegacyMemoryMigrationReport>

Copy a declared legacy scope into ${BAMBOO_DATA_DIR}/projects/<id>/memory/v1.

pub fn legacy_memory_migration_status( &self, project_id: &ProjectId, legacy_project_key: &str, ) -> ProjectStoreResult<Option<LegacyMemoryMigrationReport>>

Return a durable in-progress/committed journal, if one exists.

pub fn legacy_memory_aliases( &self, project_id: &ProjectId, ) -> ProjectStoreResult<Vec<LegacyMemoryReadAlias>>

Alias metadata for every manifest-declared legacy key.

Aliases are active during and after migration. Runtime readers must search Project-home first and use available legacy roots only as read-only fallbacks.

pub fn project_memory_read_roots( &self, project_id: &ProjectId, ) -> ProjectStoreResult<ProjectMemoryReadRoots>

impl ProjectStore

pub fn open(data_dir: impl Into<PathBuf>) -> ProjectStoreResult<Self>

Open the registry and rebuild its derived index. Corrupt individual manifests are recovered from their last-known-good backup when possible; otherwise they are quarantined and skipped rather than blocking startup.

pub fn paths(&self) -> &ProjectPaths

pub fn create( &self, name: impl Into<String>, description: Option<String>, ) -> ProjectStoreResult<ProjectManifest>

pub fn create_with_bindings( &self, name: impl Into<String>, description: Option<String>, workspace_bindings: Vec<WorkspaceBinding>, ) -> ProjectStoreResult<ProjectManifest>

pub fn create_with_id( &self, project_id: ProjectId, name: impl Into<String>, description: Option<String>, ) -> ProjectStoreResult<ProjectManifest>

pub fn create_manifest( &self, manifest: ProjectManifest, ) -> ProjectStoreResult<ProjectManifest>

pub fn get(&self, project_id: &ProjectId) -> ProjectStoreResult<ProjectManifest>

pub fn list(&self) -> ProjectStoreResult<Vec<ProjectManifest>>

pub fn index(&self) -> ProjectStoreResult<ProjectIndex>

pub fn update<F>( &self, project_id: &ProjectId, expected_revision: u64, mutate: F, ) -> ProjectStoreResult<ProjectManifest>

where F: FnOnce(&mut ProjectManifest) -> ProjectStoreResult<()>,

CAS update under the per-Project cross-process lock.

pub fn archive( &self, project_id: &ProjectId, expected_revision: u64, ) -> ProjectStoreResult<ProjectManifest>

pub fn bind_workspace( &self, project_id: &ProjectId, expected_revision: u64, binding: WorkspaceBinding, ) -> ProjectStoreResult<ProjectManifest>

Register an exact canonical workspace path under a registry-wide lock. A path already owned by another Project is rejected.

pub fn unbind_workspace( &self, project_id: &ProjectId, expected_revision: u64, workspace_path: &str, ) -> ProjectStoreResult<ProjectManifest>

Remove only the exact binding; no session or Project resource is deleted or moved.

pub fn bump_resource_revision( &self, project_id: &ProjectId, expected_revision: u64, ) -> ProjectStoreResult<ProjectManifest>

pub fn find_workspace_owner( &self, workspace_path: &str, ) -> ProjectStoreResult<Option<ProjectManifest>>

Resolve an exact registered workspace owner. Multiple owners are a corrupt/ambiguous registry state and return a validation error.

pub fn find_workspace_owner_for_path( &self, candidate_path: &str, ) -> ProjectStoreResult<Option<ProjectManifest>>

Resolve the owner of an existing candidate path using component-aware containment below registered canonical workspace bindings.

A candidate that is equal to a binding or is a descendant of one matches. If nested bindings make more than one Project match, resolution fails closed instead of picking the longest prefix or registry order.

pub fn find_workspace_binding( &self, workspace_path: &str, ) -> ProjectStoreResult<Option<(ProjectManifest, WorkspaceBinding)>>

pub fn resource_summary( &self, project_id: &ProjectId, ) -> ProjectStoreResult<ProjectResourceSummary>

Return only counts/presence and revisions; never read resource contents.

pub fn rebuild_index(&self) -> ProjectStoreResult<ProjectIndex>

Rebuild the derived index from authoritative manifests.

Trait Implementations

impl Clone for ProjectStore

fn clone(&self) -> ProjectStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectStore

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

Formats the value using the given formatter.