Struct CommandNameIndex 

pub struct CommandNameIndex { /* private fields */ }

Name-based command index for ex-command resolution.

Maps command names to their CommandId and the underlying Command trait object (for complete() delegation).

Lifecycle

1. Server builds this at bootstrap from CommandRegistry
2. Stored in ServiceRegistry as Arc<CommandNameIndex>
3. Modules query it for name→id resolution and tab-completion

Implementations

impl CommandNameIndex

pub fn new() -> Self

Create an empty index.

pub fn insert(&mut self, name: String, id: CommandId, cmd: Arc<dyn Command>)

Insert a command by name.

Each name (alias) maps to the same CommandId and Command. Last-wins if the same name is inserted twice.

pub fn resolve(&self, name: &str) -> Option<&CommandId>

Resolve a command name to its CommandId.

pub fn resolve_entry(&self, name: &str) -> Option<(&CommandId, &dyn Command)>

Resolve a command name to its CommandId and Command trait object.

Unlike resolve(), this returns the full entry so callers can access Command::args() for spec-driven argument binding.

pub fn resolve_prefix( &self, name: &str, ) -> Result<Option<(&CommandId, &dyn Command)>, AmbiguousPrefix>

Resolve a command by exact name or unambiguous prefix.

Resolution order:

1. Exact match — returned immediately (highest priority)
2. Prefix search — if exactly one distinct command matches, return it
3. Multiple aliases of the same command are deduplicated (not ambiguous)
4. Multiple distinct commands — return AmbiguousPrefix error

Returns Ok(None) for empty input or no matches.

Errors

Returns AmbiguousPrefix when the prefix matches two or more distinct commands (e.g., :s matching both :set and :split).

pub fn complete_args(&self, name: &str, partial: &str) -> Vec<String>

Get argument completions for a named command.

Delegates to the command’s complete() method.

pub fn search_by_prefix(&self, prefix: &str) -> Vec<(&CommandId, &dyn Command)>

Search for commands whose names start with prefix.

Returns deduplicated results (one entry per unique CommandId).

pub fn list_all(&self) -> Vec<(&CommandId, &dyn Command)>

List all unique commands in the index.

pub fn count(&self) -> usize

Get the number of unique commands (not aliases).

Trait Implementations

impl Debug for CommandNameIndex

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

Formats the value using the given formatter.

impl Default for CommandNameIndex

fn default() -> Self

Returns the “default value” for a type.

impl Service for CommandNameIndex