Struct AciCommandContract 

pub struct AciCommandContract {

    pub app_id: String,
    pub name: String,
    pub cmd_path: String,
    pub node_type: NodeType,
    pub description: String,
    pub risk_level: RiskLevel,
    pub example_template: Option<String>,
    pub os_aliases: Option<OsAliases>,
    pub install_instructions: Option<InstallInstructions>,
    pub docker_image: Option<String>,
    pub script_url: Option<String>,
    pub source_url: Option<String>,
    pub popularity: f64,
    pub verified: bool,
    pub confidence: String,
}

The core ACI command contract returned by CmdHub search.

This is the primary data structure that AI Agents consume. It provides everything needed to discover, understand, and execute a CLI command.

Fields

app_id: String

Unique identifier (e.g., “org.github.mtoyoda.sl”)

name: String

Base command name (e.g., “sl”)

cmd_path: String

Materialized path (e.g., “sl.-l”, “gh.pr.create”)

node_type: NodeType

Hierarchical level

description: String

Agent-friendly description

risk_level: RiskLevel

Security risk rating

example_template: Option<String>

Ready-to-execute template (e.g., “sl -l”)

os_aliases: Option<OsAliases>

OS-specific aliases

install_instructions: Option<InstallInstructions>

Cross-platform install commands

docker_image: Option<String>

Docker container image for isolated execution

script_url: Option<String>

Direct URL to official install shell scripts

source_url: Option<String>

URL of the open-source code repository

popularity: f64

Popularity score (0.0 to 1.0) derived from distro package counts

verified: bool

True when this contract was parsed from the tool’s real --help output (provenance = ‘probe’); false for crawl+LLM-inferred contracts. Agents should prefer verified contracts and treat inferred examples with caution.

confidence: String

Search confidence rating: “high”, “low”, or “none”

Implementations

impl AciCommandContract

pub fn node_name(&self) -> &str

Extracts the node name from the cmd_path (the last component after ‘.’)

pub fn to_db_records(&self) -> Result<(DbApp, DbArgument), CmdHubError>

Converts this contract into offline SQLite database records.

Trait Implementations

impl Clone for AciCommandContract

fn clone(&self) -> AciCommandContract

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AciCommandContract

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AciCommandContract

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AciCommandContract

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<DbAciRecord> for AciCommandContract

type Error = CmdHubError

The type returned in the event of a conversion error.

fn try_from(record: DbAciRecord) -> Result<Self, Self::Error>

Performs the conversion.