Struct ContractRegistry 

pub struct ContractRegistry { /* private fields */ }

In-memory contract metadata. Built once at startup; never mutated while atlas runs. Wrapped in Arc<ContractRegistry> so handlers can read it without locks.

Implementations

impl ContractRegistry

pub fn load_from_capabilities_dir(root: &Path) -> Result<Self>

Walk <root>/**/*.toml for one root and load it into the registry. Convenience wrapper around load_from_capability_roots(&[root]).

pub fn load_from_capability_roots(roots: &[&Path]) -> Result<Self>

Walk every <root>/**/*.toml across all roots (in order) and merge the parsed ContractDescriptors into one registry. Later roots override earlier ones on duplicate [contract].id, which matches the package-merge semantics: per-package <pkg>/capabilities/ can re-declare a contract from the global <robonix_source>/capabilities/. Symlinks are followed so msg/srv directories that live in interfaces/lib/... are reachable when they are linked under capabilities/.

After all TOMLs are loaded, this also indexes every .msg/.srv under <root>/lib/**/* and tries to attach top-level field schemas to each contract whose io_msg_type / io_srv_type points at a known IDL. Failures here are non-fatal (the contract is still served, just without field-level introspection).

Malformed TOMLs and *.toml files without a [contract].id are logged and skipped — one bad file must not take atlas down.

pub fn get(&self, contract_id: &str) -> Option<&ContractDescriptor>

pub fn list_with_prefix(&self, prefix: &str) -> Vec<ContractDescriptor>

Return all contracts whose id starts with prefix. Empty prefix returns every contract.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl Debug for ContractRegistry

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

Formats the value using the given formatter.

impl Default for ContractRegistry

fn default() -> ContractRegistry

Returns the “default value” for a type.