Struct LintCommand 

pub struct LintCommand {
    pub commit_range: Option<String>,
    pub context_dir: Option<PathBuf>,
    pub guidelines: Option<PathBuf>,
    pub output: OutputFormat,
    pub strict: bool,
    pub quiet: bool,
    pub verbose: bool,
    pub show_passing: bool,
    pub stdin: bool,
    pub suggest: bool,
    pub fix: bool,
    pub allow_pushed: bool,
}

Lint command options - deterministically validates commit messages against guidelines (no AI, no network).

Fields

commit_range: Option<String>

Commit range to lint (e.g., HEAD~3..HEAD, abc123..def456). Defaults to commits ahead of the default base branch (origin/main, origin/master, main, or master).

context_dir: Option<PathBuf>

Path to custom context directory (defaults to .omni-dev/).

guidelines: Option<PathBuf>

Accepted for CLI parity with check; unused by lint (there is no AI prose guidelines file to load — deterministic rules come from .omni-dev/commit-rules.yaml and .omni-dev/scopes.yaml instead).

output: OutputFormat

Output format.

strict: bool

Exits with error code if any issues found (including warnings).

quiet: bool

Only shows errors/warnings, suppresses info-level output.

verbose: bool

Shows the resolved rules/scopes configuration sources.

show_passing: bool

Includes passing commits in output (hidden by default).

stdin: bool

Reads a single commit message from standard input instead of a commit range (for a commit-msg git hook call site).

suggest: bool

Populates a deterministic corrected-scope suggestion for each commit with an unknown-scope/missing-scope issue, resolved from the commit’s changed files against .omni-dev/scopes.yaml + ecosystem defaults — no AI, no network. Report-only; use --fix to apply. Requires a commit range (incompatible with --stdin, which has no changed-files list to resolve a scope from).

fix: bool

Applies --suggest’s deterministic scope corrections directly to the repository, via the same AmendmentHandler path git commit message amend uses. No AI, no confirmation prompt — only ever touches a commit with a resolvable unknown-scope/missing-scope issue. Implies --suggest. Requires a commit range (incompatible with --stdin).

allow_pushed: bool

Permits --fix to amend commits already present in a detected remote main branch (rewrites published history). Mirrors git commit message amend --allow-pushed / twiddle --allow-pushed. Ignored without --fix.

Implementations

impl LintCommand

pub async fn execute(self, repo: Option<&Path>) -> Result<()>

Executes the lint command, validating commit messages against deterministic rules.

Trait Implementations

impl Args for LintCommand

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

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

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

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

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

impl CommandFactory for LintCommand

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl FromArgMatches for LintCommand

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( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for LintCommand

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.