Enum SemanticCommands 

pub enum SemanticCommands {
    Hot {
        from: Option<String>,
        limit: usize,
        by: HotSpotKeyArg,
        kinds: Vec<HotEventKindArg>,
        include_paths: Vec<String>,
        exclude_paths: Vec<String>,
        top: usize,
        include_actors: bool,
    },
    Index {
        all: bool,
    },
}

Variants

Hot

Aggregate semantic-change events across recent history and surface the files or functions with the most activity.

Use this to find: review-worthy hot spots (“which files are churning”), API stability signals (--kind signature_changed for a list of “your unstable surface area”), and annotation candidates (--by function --include-actors for “functions many people touched recently — context would help”).

Fields

from: Option<String>

State to start the walk from. Defaults to HEAD.

limit: usize

Walk at most this many state pairs. Higher = more signal, linearly more compute. Default tuned for sub-10s runs on typical project history.

by: HotSpotKeyArg

What to bucket on.

kinds: Vec<HotEventKindArg>

Restrict to specific event kinds. Repeat the flag for multiple kinds. No flag = all kinds.

include_paths: Vec<String>

Substring path filter — include only events whose path contains any of these substrings. Repeatable.

exclude_paths: Vec<String>

Substring path filter — exclude events whose path contains any of these substrings. Repeatable.

top: usize

Number of slots to print. Default 20.

include_actors: bool

Include the per-actor histogram for each hot-spot. Slower (string allocation per event) but turns the output into “and here’s who’s been touching it.”

Index

Backfill the content-addressed merkle semantic index over history.

Native captures already index eagerly; this backfills states that predate the index (notably git-lane imports). Runs oldest-first and is restartable — rerun after an interruption and it resumes.

Fields

all: bool

Recompute every state’s index, superseding any existing one (e.g. after a grammar or extractor upgrade). Without this, only states missing an index are computed.

Trait Implementations

impl Clone for SemanticCommands

fn clone(&self) -> SemanticCommands

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl FromArgMatches for SemanticCommands

fn from_arg_matches( __clap_arg_matches: &ArgMatches, ) -> Result<SemanticCommands, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<SemanticCommands, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for SemanticCommands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand