Skip to content

Command registration architecture

The live Commander tree accepts CLI input, but the authoritative descriptor registry defines callable identity, inputs, capability, authorization, mutation posture, effects, preconditions, examples, and transitions for automation.

Command adapters validate input and call domain services. Shared output helpers produce text or protocol envelopes. Descriptor projections power commands search, commands describe, and native tool manifests. commands validate compares descriptors, live registration, and generated tool coverage so none becomes an independent source of truth.

A command addition is incomplete until adapter syntax, descriptor identity and inputs, capability/effects, structured failure behavior, tests, and public reference ownership agree. Write-capable commands also need destination scope, confirmation, idempotency, preconditions, expected postconditions, and partial-state recovery.

The generated command inventory is documentation evidence derived from compiled descriptors; it does not replace source registration. See the automation contract and contribution guide.