Enum PurposeCommand 

pub(crate) enum PurposeCommand {
    Set {
        path: String,
        purpose: String,
    },
    Review {
        from_file: PathBuf,
        apply: bool,
    },
    Queue {
        task: Option<String>,
        start_index: usize,
        limit: usize,
        category: Option<String>,
        severity: Option<HealthSeverityArg>,
        path_prefix: Option<String>,
        summary_only: bool,
        include_assets: bool,
        include_low_priority_files: bool,
    },
}

Purpose metadata subcommands.

Variants

Set

Set an agent-approved purpose for an indexed path.

Fields

path: String

Indexed repository-relative path.

purpose: String

Agent-approved purpose one-liner.

Review

Batch review existing purpose records from a JSON file.

Fields

from_file: PathBuf

JSON file containing review items or an object with an items array.

apply: bool

Apply reviewed purposes. Without this flag the command previews only.

Queue

Return a bounded queue of paths that need purpose curation.

Fields

task: Option<String>

Host-owned task label for deterministic curator work identity.

start_index: usize

Pagination start index after filters are applied.

limit: usize

Maximum findings to return.

category: Option<String>

Optional finding category filter.

severity: Option<HealthSeverityArg>

Optional severity filter.

path_prefix: Option<String>

Optional repository-relative primary or related path prefix.

summary_only: bool

Return counts and paging metadata without queue rows.

include_assets: bool

Include non-source files and asset-only folders in the queue.

include_low_priority_files: bool

Include low-priority files instead of the default folder-first queue.

Trait Implementations

impl Debug for PurposeCommand

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

Formats the value using the given formatter.

impl FromArgMatches for PurposeCommand

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

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, 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 PurposeCommand

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