Struct Issue 

pub struct Issue {

    pub number: u32,
    pub title: String,
    pub status: Status,
    pub labels: Labels,
    pub priority: Priority,
    pub assignee: Option<String>,
    pub estimate: Option<String>,
    pub commit: Option<String>,
    pub gitlab_id: Option<String>,
    pub linear_id: Option<String>,
    pub mission: Option<String>,
    pub task: Option<String>,
    pub links: Vec<String>,
    pub files: Vec<String>,
    pub created: String,
    pub updated: String,
    pub filename: String,
    pub body: String,
}

An issue: one markdown file with YAML frontmatter.

Field order and names are frozen by contracts/file-format.md FR-012. number is a stored frontmatter key assigned by the storage layer at create time by scanning the live issue set (issue #52; previously from tix.toml [state].next_number, which is no longer persisted); this module models and validates it but never allocates. filename and body are memory-only (#[serde(skip)]).

Fields

number: u32

Internal sequential id, never reused (C-007).

title: String

Human title; drives the slug in the filename.

status: Status

Column (board workflow stage) the issue sits in.

labels: Labels

Free-form labels.

priority: Priority

Priority; defaults to medium.

assignee: Option<String>

Assignee. In memory: bare handle (alice) or full Name <email> identity, verbatim. Files serialize per the rule documented on [de_assignee]/[se_assignee] (legacy @alice tolerated on read).

estimate: Option<String>

Free-form estimate (e.g. 2, S, 3d); default null.

commit: Option<String>

Git commit recorded when moved to done (FR-026).

gitlab_id: Option<String>

Remote GitLab issue id after export/import.

linear_id: Option<String>

Remote Linear issue id after export/import.

mission: Option<String>

Spec Kitty mission slug (e.g. v3-archive-review) this issue belongs to, if any.

task: Option<String>

Spec Kitty work package id (e.g. WP01) this issue links to, if any.

links: Vec<String>

Related issue numbers, as authored (tolerant like labels); symmetric links maintained by tix link/--links writes. Default [].

files: Vec<String>

Repo-relative file paths of the governing specification (e.g. openspec/changes/<name>/specs/<cap>/spec.md). Default [].

created: String

Creation date, YYYY-MM-DD, equals the filename date prefix.

updated: String

Last-mutation date, YYYY-MM-DD.

filename: String

Issue file name — path relative to the issues dir (e.g. alice/2026-05-10-fix-login.md for grouped layout, or 2026-05-10-fix-login.md for legacy flat files per C-010).

body: String

Raw markdown body; memory-only, preserved verbatim.

Implementations

impl Issue

pub fn parse(contents: &str) -> Result<Self>

Parse a full issue file (frontmatter + body) from its text.

The first line must be ---; the closing --- terminates the frontmatter. The body after it is preserved verbatim (the single structural separator blank line is consumed).

pub fn frontmatter(&self) -> String

Serialize just the frontmatter YAML (no delimiters), with None fields omitted except created/updated which are always present.

pub fn to_file_contents(&self) -> String

Render the full issue file: ---, frontmatter, closing ---, blank separator and the raw body.

pub fn filename_stem(&self) -> String

The date-prefixed filename stem: {created}-{slug} (C-008).

pub fn bump_updated(&mut self)

Record a mutation by stamping today’s date into updated.

pub fn description(&self) -> &str

The description: everything above the first top-level ## Comments heading, trimmed of trailing whitespace. With no section, the whole body is the description.

pub fn comments(&self) -> Vec<Comment>

The comments parsed from the ## Comments section, in file order (NFR-005). With no section — or a section with no ### heads — returns an empty vec.

pub fn add_comment(&mut self, author: &str, text: &str)

Append a comment to the ## Comments section.

Whitespace-only text is discarded and the body is left untouched (FR-004 case 4). Otherwise the section is created if absent and the comment block is appended after the last existing comment. The description and any existing comments are never rewritten.

Trait Implementations

impl Clone for Issue

fn clone(&self) -> Issue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Issue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Issue

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Issue

impl PartialEq for Issue

fn eq(&self, other: &Issue) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Issue

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Issue