Enum TicketCommand 

pub enum TicketCommand {
    List,
    Ready {
        include_deferred: bool,
    },
    Show {
        slug: String,
    },
    New {
        slug: String,
        title: String,
        goal: Option<String>,
    },
    ImportOpenspec {
        path: PathBuf,
        slug: Option<String>,
    },
    Note {
        slug: String,
        text: Vec<String>,
    },
    Notes {
        slug: String,
    },
    Queue {
        slug: String,
        mission: Option<String>,
        force: bool,
    },
    Approve {
        slug: String,
        mission: Option<String>,
        force: bool,
    },
    MigrateState {
        yes: bool,
    },
}

Subcommands under kranz ticket — the backlog surface.

Variants

List

List tickets with slug, priority, pipeline state, and title

Ready

List tickets ready to pick up now: actionable states whose defer-until (if any) has passed — deferred tickets stay hidden until their time (D-BW-3; the clock decides at listing time, no scheduler)

Fields

include_deferred: bool

Also list the not-yet-ready deferred tickets, with their defer times (operator visibility; the default listing stays clean)

Show

Show one ticket: parsed fields, its state, and any needs-context block

Fields

slug: String

The ticket slug (file stem under .kranz/tickets/)

New

Scaffold a new ticket at .kranz/tickets/<slug>.md (refuses to overwrite)

Fields

slug: String

The ticket slug (used as the file stem)

title: String

The ticket title (frontmatter title)

goal: Option<String>

An optional one-paragraph goal to pre-fill the ## Goal section

ImportOpenspec

Import an OpenSpec change folder (openspec/changes/<name>/) as a ticket. Carries the proposal and its requirements; deliberately drops tasks.md, and never passes SHALL scenarios off as acceptance criteria. One way only — the approved plan stays authoritative

Fields

path: PathBuf

Path to the OpenSpec change directory (must hold proposal.md)

slug: Option<String>

Ticket slug (defaults to the change directory’s name)

Note

Append a note to a ticket’s discussion (.kranz/tickets/<slug>.notes.jsonl — append-only, committed with the ticket; D-BW-3). Author is $KRANZ_NOTE_AUTHOR, else “operator”

Fields

slug: String

The ticket slug

text: Vec<String>

The note text (multiple words are joined with spaces)

Notes

Print a ticket’s discussion notes chronologically (append-only — there is no edit or delete, mirroring the event log’s honesty posture)

Fields

slug: String

The ticket slug

Queue

Queue a drafted (REVIEW) ticket: enqueue its mission and mark it QUEUED

Fields

slug: String

The ticket slug

mission: Option<String>

The drafted mission id (auto-detected from the ticket goal if omitted)

force: bool

Queue despite unsatisfied blocked-by dependencies (a blocked-by cycle is never overridable)

Approve

Deprecated alias for ticket queue (kept for one release; prints a deprecation note to stderr). Do not confuse with plan approval — see docs/scoping/pipeline-view.md decision D-A.

Fields

slug: String

The ticket slug

mission: Option<String>

The drafted mission id (auto-detected from the ticket goal if omitted)

force: bool

Approve despite unsatisfied blocked-by dependencies (a blocked-by cycle is never overridable)

MigrateState

Fold terminal .status sidecar states into committed frontmatter state: keys — the one-time migration from the ticket-state- frontmatter design, so done verdicts survive a fresh clone. Dry-run by default; tickets with uncommitted .md edits are skipped by name (never rewrite a file an in-flight editor or agent has open)

Fields

yes: bool

Apply the fold (without this flag it only reports what it would do)

Trait Implementations

impl Debug for TicketCommand

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

Formats the value using the given formatter.

impl FromArgMatches for TicketCommand

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 TicketCommand

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