Struct PublicCapability 

pub struct PublicCapability {
    pub id: String,
    pub kind: String,
    pub mcp_tool: Option<String>,
    pub mcp_resource: Option<String>,
    pub http: Option<HttpBinding>,
    pub cli: Option<String>,
    pub input: Option<Value>,
    pub output: Option<Value>,
}

One public capability, reduced to what a caller outside this repository can depend on.

Everything here is a promise; nothing here is an implementation detail. The title and the description are deliberately absent — they are how the contract is explained, not what it is, and a reworded description that forced a release would make the gate a thing to route around within a week.

use majordomus_cli::release::surface::{public_capabilities, PublicCapability};
use serde_json::json;
let caps = public_capabilities(&json!({"capabilities": [{
    "id": "a.one", "kind": "query", "visibility": "public",
    "exposure": {"cli": {"path": ["a", "one"]}},
    "output": {"schema": {"type": "object", "description": "prose"}}
}]}));
let capability: &PublicCapability = &caps["a.one"];
assert_eq!(capability.cli.as_deref(), Some("a one"));
// Prose is normalised away: a reworded description is not a contract change.
assert!(capability.output.as_ref().unwrap().get("description").is_none());

Fields

id: String

release.analysis.

kind: String

query or command: whether calling it changes anything.

mcp_tool: Option<String>

The MCP tool name, when it answers to one.

mcp_resource: Option<String>

The MCP resource URI, when it is readable as one.

http: Option<HttpBinding>

The HTTP method and path, when it is bound to one.

cli: Option<String>

The command-line path that dispatches it, when one does.

input: Option<Value>

The normalised input contract: what a caller may send.

output: Option<Value>

The normalised output contract: what a caller is promised back.

Trait Implementations

impl Clone for PublicCapability

fn clone(&self) -> PublicCapability

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicCapability

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PublicCapability

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PublicCapability

impl JsonSchema for PublicCapability

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for PublicCapability

fn eq(&self, other: &PublicCapability) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PublicCapability

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PublicCapability