@fungi.computer/issues

Exports

Kind	Export	Description
Ttype alias	IssueStatus	Canonical triage state stored in ticket frontmatter.
Ttype alias	IssueFrontmatter	Ticket metadata accepted by the local issue frontmatter schema.
Ttype alias	IssueDiagnostic	A path, content or dependency rule violation in the supplied issue tree.
Ttype alias	IssueSummary	Ticket identity and dependency state used to assemble the ready frontier.
Ttype alias	IssueIndexRecord	The validated frontmatter fields Grove reads from the Team issue index.
Ttype alias	IssueTrackerReport	Validation result and index projections for one complete issue tree.
fnfunction	inspectIssueTree()	Validate one pushed issues/ tree as a schema and dependency graph.

IssueStatusTtype alias

Signature

type IssueStatus =
  | "needs-triage"
  | "needs-info"
  | "ready-for-agent"
  | "ready-for-human"
  | "in-progress"
  | "resolved"
  | "wontfix";

Canonical triage state stored in ticket frontmatter.

---

IssueFrontmatterTtype alias

Signature

type IssueFrontmatter = object;

Ticket metadata accepted by the local issue frontmatter schema.

Properties

id

Signature

readonly id: string;

Stable effort-and-number identifier, independent of the ticket slug.

title

Signature

readonly title: string;

Ticket title, which must match the body’s first Markdown heading.

type

Signature

readonly type: "bug" | "enhancement" | "task" | "research" | "prototype" | "decision";

Ticket kind selecting the required body sections.

status

Signature

readonly status: IssueStatus;

Triage state; blocking is derived separately from dependency edges.

priority

Signature

readonly priority: "p0" | "p1" | "p2" | "p3";

Priority code, independent of triage state and blocking.

created

Signature

readonly created: string;

Creation date written as YYYY-MM-DD.

assignee

Signature

readonly assignee: string | null;

Claimed owner, or null while the ticket is unassigned.

areas

Signature

readonly areas: readonly string[];

Searchable area slugs from the governing Wiki’s domain language.

blocked_by

Signature

readonly blocked_by: readonly string[];

Stable ticket IDs that must be resolved or wontfix to settle blockers.

---

IssueDiagnosticTtype alias

Signature

type IssueDiagnostic = object;

A path, content or dependency rule violation in the supplied issue tree.

Properties

path

Signature

readonly path: string;

Input file key identifying the ticket that needs correction.

code

Signature

readonly code:
  | "invalid-ticket-path"
  | "invalid-frontmatter"
  | "id-path-mismatch"
  | "duplicate-id"
  | "title-mismatch"
  | "missing-section"
  | "unknown-blocker"
  | "self-blocker"
  | "blocker-cycle";

Machine-readable rule violated by the ticket or its dependency graph.

detail

Signature

readonly detail: string;

Human-readable explanation of the failed rule.

---

IssueSummaryTtype alias

Signature

type IssueSummary = object;

Ticket identity and dependency state used to assemble the ready frontier.

Properties

id

Signature

readonly id: string;

Stable ticket identifier from its parsed frontmatter.

path

Signature

readonly path: string;

Ticket path relative to the supplied issue tree.

status

Signature

readonly status: IssueStatus;

Current triage state, without a synthetic blocked state.

blocked

Signature

readonly blocked: boolean;

Whether a declared blocker is absent or outside resolved and wontfix.

---

IssueIndexRecordTtype alias

Signature

type IssueIndexRecord = Readonly<
  Pick<
    IssueFrontmatter,
    "id" | "title" | "status" | "priority" | "assignee" | "areas" | "blocked_by"
  > &
    object
>;

The validated frontmatter fields Grove reads from the Team issue index.

---

IssueTrackerReportTtype alias

Signature

type IssueTrackerReport = object;

Validation result and index projections for one complete issue tree.

Properties

schemaVersion

Signature

readonly schemaVersion: 1;

Version of this report representation, currently 1.

status

Signature

readonly status: "pass" | "fail";

Pass only when the complete tree has no diagnostics.

issues

Signature

readonly issues: readonly IssueSummary[];

Parsed graph summaries, retained even when validation fails.

records

Signature

readonly records: readonly IssueIndexRecord[];

Validated index records; empty if any diagnostic exists.

frontier

Signature

readonly frontier: readonly string[];

Unassigned ready ticket IDs with all declared blockers settled.

diagnostics

Signature

readonly diagnostics: readonly IssueDiagnostic[];

Rule violations sorted by input path and diagnostic code.

inspectIssueTree()fnfunction

Signature

function inspectIssueTree(files): IssueTrackerReport;

Validate one pushed issues/ tree as a schema and dependency graph.

Parameters

Parameter	Type
files	Readonly<Record<string, string>>

Returns

IssueTrackerReport