Struct Findings 

pub struct Findings {
    pub resolved_keys: Vec<String>,
    pub unresolved_keys: Vec<String>,
    pub key_suggestions: Vec<String>,
    pub vocabulary_partial: bool,
}

What resolution learned, for the agent_surface record.

Fields

resolved_keys: Vec<String>

Keys asked for by --select that the shaped payload can actually carry.

unresolved_keys: Vec<String>

Keys asked for by --select that nothing in scope carries.

Non-empty here means the projection succeeded PARTIALLY. A caller that gets fewer fields than it asked for learns why from this list instead of concluding the records were incomplete.

key_suggestions: Vec<String>

Names the caller might have meant, for the keys that failed.

Carried as DATA rather than folded into a sentence: a refusal message is localized, so parsing the suggestion out of it would mean parsing prose in one of two languages. rules-rust-cli-com-clap-io-exitcodes-erros asks a refusal to carry a corrective action, and the agent-native contract asks the action to be machine-readable.

vocabulary_partial: bool

Whether the suggestion vocabulary was sampled rather than exhaustive.

Never weakens a verdict — Scope::classify always scans every element. It qualifies the ADVICE: a short list under a partial vocabulary means “the sampler stopped”, not “nothing resembles your key”.

Implementations

impl Findings

pub fn is_partial(&self) -> bool

true when at least one requested key failed to resolve.

Trait Implementations

impl Debug for Findings

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

Formats the value using the given formatter.

impl Default for Findings

fn default() -> Findings

Returns the “default value” for a type.