Enum CommandKind 

#[non_exhaustive]
pub enum CommandKind {
    Builtin,
    UserTool,
    Special,
    Dynamic,
    External,
}

The category the kernel resolves a command name into.

Returned by Kernel::classify_command. The classification mirrors the interpreter’s real resolution order (execute_command_depth), not the validator’s warning heuristics — it answers “what will run”, which is what a consent gate needs.

The safe direction of any imprecision is to over-report External: an embedder gating external commands should never see something classified as internal that in fact escapes to PATH.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Builtin

A built-in tool run in-process (e.g. cat, grep, jq).

UserTool

A user-defined function (fn name { … }) — shadows a builtin of the same name, matching the interpreter’s user-tools-first resolution.

Special

An interpreter special-form handled directly, never resolved through the registry or PATH: true, false, source, ..

Dynamic

The name can’t be resolved statically because it’s a variable or command-substitution expansion ($cmd, $(pick)). The embedder must treat it conservatively.

External

Not a builtin, user function, or special-form: kaish will look it up as a .kai script or external binary on PATH. This is the bucket a consent gate cares about.

Implementations

impl CommandKind

pub fn escapes_kernel(self) -> bool

True when the name escapes the kernel to a PATH lookup (External) or can’t be resolved statically (Dynamic) — the two cases an external-command consent gate must scrutinize.

Trait Implementations

impl Clone for CommandKind

fn clone(&self) -> CommandKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CommandKind

impl Debug for CommandKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CommandKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CommandKind

impl PartialEq for CommandKind

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CommandKind

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 CommandKind