Struct SourceDefinition 

pub struct SourceDefinition {
    pub name: String,
    pub source_type: SourceKind,
    pub host: Option<String>,
    pub paths: Vec<String>,
    pub sync_schedule: SyncSchedule,
    pub path_mappings: Vec<PathMapping>,
    pub platform: Option<Platform>,
}

Definition of a single source (local or remote).

Fields

name: String

Friendly name for this source (e.g., “laptop”, “workstation”). This becomes the source_id used throughout the system.

source_type: SourceKind

Connection type (local, ssh, etc.).

host: Option<String>

Remote host for SSH connections (e.g., “user@laptop.local”).

paths: Vec<String>

Paths to sync from this source. For SSH sources, these are remote paths. Supports ~ expansion.

sync_schedule: SyncSchedule

When to automatically sync this source.

path_mappings: Vec<PathMapping>

Path mappings for workspace rewriting. Maps remote paths to local equivalents. Example: “/home/user/projects” -> “/Users/me/projects”

platform: Option<Platform>

Platform hint for default paths (macos, linux).

Implementations

impl SourceDefinition

pub fn local(name: impl Into<String>) -> Self

Create a new local source definition.

pub fn ssh(name: impl Into<String>, host: impl Into<String>) -> Self

Create a new SSH source definition.

pub fn is_remote(&self) -> bool

Check if this source requires SSH connectivity.

pub fn validate(&self) -> Result<(), ConfigError>

Validate the source definition.

pub fn rewrite_path(&self, path: &str) -> String

Apply path mapping to rewrite a workspace path.

Uses longest-prefix matching. If an agent is specified, only mappings that apply to that agent are considered.

pub fn rewrite_path_for_agent(&self, path: &str, agent: Option<&str>) -> String

Apply path mapping for a specific agent.

Uses longest-prefix matching, filtering by agent.

Trait Implementations

impl Clone for SourceDefinition

fn clone(&self) -> SourceDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceDefinition

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

Formats the value using the given formatter.

impl Default for SourceDefinition

fn default() -> SourceDefinition

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SourceDefinition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SourceDefinition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.