Struct SearchReport 

pub struct SearchReport {

    pub query: String,
    pub mode: String,
    pub retrieval_mode: String,
    pub source: String,
    pub strategy: String,
    pub start_index: usize,
    pub total: usize,
    pub observed_total: usize,
    pub total_is_complete: bool,
    pub returned: usize,
    pub searched_files: usize,
    pub searched_bytes: usize,
    pub candidate_files: usize,
    pub retained_bytes: usize,
    pub truncated: bool,
    pub truncation_reason: Option<String>,
    pub results: Vec<SearchMatch>,
}

Search report returned by CLI and MCP adapters.

Fields

query: String

Search pattern.

mode: String

Search mode: literal, regex, or fuzzy.

retrieval_mode: String

Retrieval family selected by the caller.

source: String

Source used for broad repository search.

strategy: String

Candidate strategy used while preserving exact lexical semantics.

start_index: usize

Pagination start index.

total: usize

Matches observed before pagination and bounded early stop.

observed_total: usize

Alias for total that makes bounded search semantics explicit.

total_is_complete: bool

Whether total/observed_total is known to be the exhaustive match count.

returned: usize

Returned matches after pagination.

searched_files: usize

Indexed files opened while serving the query.

searched_bytes: usize

Source bytes read while serving the query.

candidate_files: usize

Metadata-only FTS candidates considered before exact verification.

retained_bytes: usize

Approximate retained result bytes before adapter serialization.

truncated: bool

Whether the search stopped after satisfying the requested page.

truncation_reason: Option<String>

Stable first bound that stopped exhaustive search, when applicable.

results: Vec<SearchMatch>

Search matches.

Trait Implementations

impl Debug for SearchReport

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

Formats the value using the given formatter.

impl Serialize for SearchReport

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.