Expand description
The clap command tree, the frozen exit-code scheme, and the process boundary that resolves config, opens the store and hands off to the per-command handlers.
The command tree and every long flag mirror contracts/cli.md exactly;
the exit-code table there is frozen: 0 success, 1 usage/config/
unknown-error, 2 target-not-found or selection-ambiguous, 3 external
tool missing (glab/linear-cli, reserved for WP05). Handlers return
Result<(), TixError>; exit_code_for maps the typed error surface
to the exit-code enum at the boundary. Human-readable errors go to
stderr; stdout stays clean for the parseability contract.
Structs§
- Analytics
Scope Args - The scope, period, mode and unit flags every
tix analyticsverb shares. - Bulk
Selection tix bulk <action>— four actions, and each carries its own flags.- Cli
- Cycle
Schedule Create Args - The flags that define a schedule (
tix cycle schedule create). - Cycle
Schedule Edit Args - What
tix cycle schedule editmay change. Every field is optional; only the named ones change, so a partial edit keeps the rest of the record. - Cycle
Schedule Extend Args tix cycle schedule extend’s flags: the reason plus the period count.- Cycle
Schedule Lifecycle Args - The flags every
tix cycle schedulelifecycle action shares. - Cycle
Schedule Reason Args - The lifecycle flags plus the reason the recording actions require.
- Recurring
Create Args - The fields of the definition issue plus its rule.
- Recurring
Edit Args - What
tix recurring editmay change. - Recurring
Lifecycle Args - The confirmation every mutating
tix recurringsubcommand takes. - Recurring
Rule Args - The rule flags
tix recurring createandeditshare. - Time
Edit Args - The fields an entry correction can name (T020).
- Time
Total Args - The read-only scope a
tix time totalis evaluated under (T021). - View
Plan Args - The plan-shaping flags shared by
create,update, andstatus. - View
Scope Args - The explicit scope flags shared by
createandshare.
Enums§
- Analytics
Command - The
tix analyticssubcommands (missionburndown-scope-analytics-01M3C9J1, WP05). - Beads
Action - The
tix capacitysubcommands (missioncycle-capacity-planning-01M3C85C, WP05). - Bulk
Action - Capacity
Command - Command
- Cycle
Command - Cycle
Schedule Command - The
tix cycle schedulesubcommands (missionrepeating-cycle-schedules-01M3C7W1, WP06). - Epic
Command - The
tix epicsubcommands (missionepics-work-items-01M3BYW4, WP05). - Exit
Code - Exit codes frozen by
contracts/cli.md. - Health
Action - The
tix triagetree (contracts/cli-surface.md, WP05 T023–T025). - Initiative
Command - The
tix initiativesubcommands (missionroadmap-initiatives-01M3C8SX, WP04). - Layout
Action tix layoutsubcommands.- Link
Action - The
tix linksubcommands. - Mentions
Action - The
tix mentionsverbs. - Migrate
Action tix migratesubcommands.- Milestone
Command - Parent
Action - The
tix parentsubcommands. - Project
Command - The
tix projectsubcommands (missionfirst-class-projects-01M3BYBW, WP05). - Recurring
Action - What
tix recurringdoes. - Roadmap
Command - The
tix roadmapsubcommands (missionroadmap-initiatives-01M3C8SX, WP04). - Template
Action - The
tix templatemanagement tree (contracts/cli-surface.md). - Time
Command - The
tix timesubcommands (missionper-issue-time-tracking-01M3C9A4, WP04). - Triage
Action - View
Action - The
tix viewsaved-view subcommands (#172; missionsaved-issue-views-01M3C926, WP04). - WipAction
tix wip’s subcommands (missionconfigurable-wip-limits-01M3C6WX, WP04).- Workflow
Action - The
tix workflowverbs, percontracts/cli-surface.md§1.
Functions§
- exit_
code_ for - Map a domain error to the frozen exit-code table.
- run
- Process entry: route a parsed
Clithrough config resolution, store opening and dispatch, then return the exit code formainto exit with.