Enum TimeCommand 

pub enum TimeCommand {
    Add {
        issue: String,
        minutes: i64,
        date: Option<String>,
        author: String,
        note: Option<String>,
    },
    Edit {
        issue: String,
        entry: String,
        change: TimeEditArgs,
    },
    Delete {
        issue: String,
        entry: String,
        reason: Option<String>,
        confirm: bool,
    },
    Show {
        issue: String,
    },
    History {
        issue: String,
    },
    Total {
        selector: Option<String>,
        filter: TimeTotalArgs,
    },
}

The tix time subcommands (mission per-issue-time-tracking-01M3C9A4, WP04).

A thin adapter: the entry model and its validation, the mutation service and its append-only History, and every filter, total and finding live under crate::time_tracking. This enum owns only the spelling of the surface — the duration is whole minutes, a date is a calendar YYYY-MM-DD, and there is no flag here that could express a timer, a timezone, an overlap rule or a billing unit (C-002/C-009).

Variants

Add

Record effort against an issue, in whole minutes

The date is optional and is a calendar date, never an instant: an entry without one is real, and a period-bounded read reports it as undated rather than as zero.

Fields

issue: String

Issue number, filename fragment or unique title fragment

minutes: i64

The effort, in whole minutes at or above zero

A negative value is accepted by the parser and refused by the shared entry validator with its field name, which is a better message than clap’s “unexpected argument”.

date: Option<String>

The calendar date the effort belongs to, YYYY-MM-DD

author: String

Who did the work: a handle (ada, @ada) or a Name <email> identity

note: Option<String>

Free-text context, preserved verbatim

Edit

Correct one entry, naming only the fields that change

A field the command does not name is left exactly as it was, including the entry’s date, note and any metadata another build attached. --clear-date and --clear-note are how an optional value is removed (an empty --note "" would be a value, not an absence). A correction requires --reason: the prior value stays in History, and the reason is what makes the change attributable.

Fields

issue: String

Issue number, filename fragment or unique title fragment

entry: String

The stable id of the entry to correct (tix time show <ISSUE> lists them)

change: TimeEditArgs

Delete

Remove one entry from the issue’s current entries

The entry leaves the frontmatter; its value and its event stay in History, so a deletion is auditable rather than a rewrite. Requires --reason and --confirm.

Fields

issue: String

Issue number, filename fragment or unique title fragment

entry: String

The stable id of the entry to remove

reason: Option<String>

Why the entry is being removed; recorded in History

confirm: bool

Confirm the removal without prompting

Show

Show an issue’s current entries and its total

Fields

issue: String

Issue number, filename fragment or unique title fragment

History

Show what History retains for an issue: current entries beside its audit

Fields

issue: String

Issue number, filename fragment or unique title fragment

Total

Total recorded effort, by issue, assignee and calendar period

Every value comes from the shared calculation; a scope with nothing to total and a scope whose entries carry no usable duration print - with their state, never a zero. Deleted entries are excluded unless --audit asks for them.

Fields

selector: Option<String>

Issue number, filename fragment or unique title fragment (alternative to --issue)

filter: TimeTotalArgs

Trait Implementations

impl Clone for TimeCommand

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeCommand

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

Formats the value using the given formatter.

impl FromArgMatches for TimeCommand

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 TimeCommand

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