Struct HandlerDef 

pub struct HandlerDef {
    pub name: &'static str,
    pub description: &'static str,
    pub visibility: Visibility,
    pub category: VerbCategory,
    pub params: &'static [ParamDef],
}

Handler metadata for discovery and documentation (ADR-023, ADR-025).

Replaces the previous VerbDef. Every entry carries a visibility tag so the registry can separate the MCP-exposed surface from internal handlers, and a category that classifies the illocutionary force of the verb per the speech-act taxonomy in ADR-025.

The params slice is used by VerbRegistry::describe_verb to build the help=true schema envelope (issue #287). Packs that predate this field leave it empty (&[]) which is backward-compatible — callers receive a schema envelope with zero params rather than an error.

Fields

name: &'static str

description: &'static str

visibility: Visibility

category: VerbCategory

Illocutionary force classification (ADR-025). Use Assertive for Subhandler entries that have no external callers.

params: &'static [ParamDef]

Parameter schema for help=true introspection (issue #287).

Empty (&[]) is the correct default for handlers that predate this field or have no fixed parameter schema (e.g. free-form query verbs).

Implementations

impl HandlerDef

pub fn presentation_policy(&self) -> VerbPresentationPolicy

Resolve the presentation policy for this handler.

Returns VerbPresentationPolicy::AlwaysVerbose for verbs whose semantics demand full output (full UUIDs, complete timestamps) regardless of the caller’s requested presentation mode.

The set is derived from ADR-045 §6. New verbs that need this override must be added here; omission from the list means Standard applies.

Trait Implementations

impl Clone for HandlerDef

fn clone(&self) -> HandlerDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandlerDef

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

Formats the value using the given formatter.

impl PartialEq for HandlerDef

fn eq(&self, other: &HandlerDef) -> 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 Eq for HandlerDef

impl StructuralPartialEq for HandlerDef