Struct Repos 

pub struct Repos {
    pub roots: Vec<PathBuf>,
    pub scan_ttl: u64,
}

Where magi repos and GET /api/repos look for local checkouts.

roots is one of the array keys [array_merge_policy] marks as append-across-layers: which checkouts exist in general is a machine fact in the same way the agent roster is - a repository’s own magi.toml cannot state where its siblings live before magi has resolved which repository to read that file from in the first place - but a repository that genuinely has an extra root worth scanning is not forced to choose between an error and losing the machine’s roots outright. Both layers’ roots are scanned; see Config::refuse_split_arrays for the keys that are still refused.

Fields

roots: Vec<PathBuf>

Roots to scan for a ghq-layout checkout: <root>/<host>/<owner>/<repo> with a .git directory. Empty by default - nothing is scanned unless asked to be.

scan_ttl: u64

How long a scan is trusted before the next request re-scans it, seconds. 0 means never trust it: scan on every request. Defaults to a day, the same order of magnitude as Graph::answer_timeout for the same reason - a checkout does not usually appear or vanish inside a session, so there is little to gain from scanning more often than that, and an explicit refresh exists for the moment one does.

Trait Implementations

impl Clone for Repos

fn clone(&self) -> Repos

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Repos

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

Formats the value using the given formatter.

impl Default for Repos

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Repos

where Repos: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Repos

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

where __S: Serializer,

Serialize this value into the given Serde serializer.