Struct BondManager 

pub struct BondManager { /* private fields */ }

SQLite-backed manager for Bonds.

Keep this file as the module root and shared type definition. Concern-specific method implementations live in sibling modules.

Implementations

impl BondManager

Health-scan concerns.

pub fn scan_broken_bonds(&self) -> Result<Vec<Bond>, BondError>

Return broken bonds and emit BrokenDetected event for each.

impl BondManager

Hook registration and dispatch concerns.

pub fn register_hook<H>(&self, hook: H)

where H: BondEventHook + 'static,

Register closure/type-based hook.

pub fn register_hook_arc(&self, hook: Arc<dyn BondEventHook>)

Register Arc-wrapped hook implementation.

impl BondManager

Create/update/delete and metadata mutation flows.

pub fn create_bond<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, target: Q, name: Option<String>, ) -> Result<Bond, BondError>

Create a symlink bond and persist it (no metadata).

pub fn create_bond_with_metadata<P: AsRef<Path>, Q: AsRef<Path>>( &self, source: P, target: Q, name: Option<String>, metadata: Option<HashMap<String, String>>, ) -> Result<Bond, BondError>

Create a symlink bond with metadata and persist it.

pub fn update_bond( &self, id: &str, new_source: Option<PathBuf>, new_target: Option<PathBuf>, new_name: Option<String>, ) -> Result<Bond, BondError>

Update source and/or target and/or name.

pub fn update_bond_metadata( &self, identifier: &str, metadata: Option<HashMap<String, String>>, ) -> Result<Bond, BondError>

Replace full metadata map. Use None to clear.

pub fn delete_bond( &self, id: &str, remove_target: bool, ) -> Result<Bond, BondError>

Delete bond and optionally remove non-symlink target.

impl BondManager

Query and filtering concerns.

pub fn query_bonds(&self, query: &BondQuery) -> Result<Vec<Bond>, BondError>

Query bonds using optional source/target/metadata filters (AND semantics).

pub fn query_by_source<P: AsRef<Path>>( &self, source: P, ) -> Result<Vec<Bond>, BondError>

pub fn query_by_target<P: AsRef<Path>>( &self, target: P, ) -> Result<Vec<Bond>, BondError>

pub fn query_by_metadata_key(&self, key: &str) -> Result<Vec<Bond>, BondError>

pub fn query_by_metadata( &self, key: &str, value: &str, ) -> Result<Vec<Bond>, BondError>

impl BondManager

Storage/open/read/schema concerns for BondManager.

pub fn new(db_path: Option<PathBuf>) -> Result<Self, BondError>

Open (or create) the DB at db_path. If None, defaults to $HOME/.bonds/bonds.db.

pub fn list_bonds(&self) -> Result<Vec<Bond>, BondError>

List all bonds (most-recent first).

pub fn get_bond(&self, identifier: &str) -> Result<Bond, BondError>

Get a single bond by ID or name. ID can be a unique prefix.