Struct IssueView 

pub struct IssueView<'a> {
    pub id: Option<&'a str>,
    pub filename: &'a str,
    pub number: u32,
    pub title: &'a str,
    pub status: &'a str,
    pub relationships: &'a [Relationship],
    pub has_retired_links_key: bool,
    pub parent: Option<IssueRef>,
}

The minimal projection of an issue that the relationship service needs.

This is deliberately not crate::model::Issue: the issue model gains its typed relationship field in a later work package, and keeping the service on a narrow view means the graph stays filesystem-free and testable with a plain in-memory list.

Fields

id: Option<&'a str>

The canonical id, when this issue has one.

filename: &'a str

The store-relative filename, used as an input alias.

number: u32

The stable issue number (Issue::number, never reused).

title: &'a str

The issue title, used to build display names.

status: &'a str

The board column the issue sits in, compared against done_column.

relationships: &'a [Relationship]

The issue’s stored relationships, in authored file order.

has_retired_links_key: bool

Whether the source frontmatter still carries a legacy links: key. The key is reported as a validation result and never read as typed data (C-001); this flag is how the storage layer signals it.

parent: Option<IssueRef>

The issue’s decomposition parent, as an issue number.

Present on the relationship service’s view so the hierarchy service (crate::hierarchy) reads the same in-memory projection rather than a parallel one built by each caller. Two projections of one issue type is how two services end up disagreeing about the same snapshot — the divergence contracts/surface-parity.md §3 exists to prevent.

Not read by the relationship graph. A parent is a decomposition and a blocks edge is a scheduling dependency; they are separate fields and are never combined (C-007).

Implementations

impl<'a> IssueView<'a>

pub fn new( number: u32, title: &'a str, status: &'a str, relationships: &'a [Relationship], ) -> Self

Build an issue view without the retired-key flag.

pub fn with_identity(self, id: Option<&'a str>, filename: &'a str) -> Self

Add the canonical identity and filename used by graph alias resolution.

pub fn with_retired_links_key(self, flagged: bool) -> Self

Build an issue view, flagging a legacy links: key.

pub fn with_parent(self, parent: Option<IssueRef>) -> Self

Build an issue view carrying a decomposition parent.

pub fn graph_ref(&self) -> IssueRef

The canonical graph reference for this issue.

Trait Implementations

impl<'a> Clone for IssueView<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for IssueView<'a>

impl<'a> Debug for IssueView<'a>

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

Formats the value using the given formatter.

impl HierarchyNode for IssueView<'_>

fn number(&self) -> u32

The issue’s number, which is its stable identity.

fn title(&self) -> &str

The issue’s title, used only for the derived display label.

fn status(&self) -> &str

The issue’s raw status, compared against the caller’s completion column.

fn canonical_id(&self) -> Option<&str>

The canonical issue id, when the record has one.

fn filename(&self) -> Option<&str>

The store-relative filename used by the shared alias index.

fn parent_ref(&self) -> Option<&IssueRef>

The stored canonical parent reference. None means no parent.

fn parent_number(&self) -> Option<u32>

Legacy numeric parent alias used by in-memory test nodes.

impl IdentityNode for IssueView<'_>

fn canonical_id(&self) -> Option<&str>

The canonical issue id, when this record has one.

fn issue_number(&self) -> u32

The human-facing number alias.

fn issue_filename(&self) -> &str

The store-relative filename.

fn issue_title(&self) -> &str

The current title.