# Development graph: an Omnigraph use case

Issues, epics, specs, decisions, pull requests, releases and incidents as one graph, with the Git host still the record for code.

| | |
|---|---|
| Category | Engineering |
| Graph ID | dev |
| Sample data | Meridian, a fictional collaborative-document product: 102 nodes, 239 edges |
| Schema | 22 node types, 92 edge types |
| Stored queries | 57 reads, 23 writes |
| Source | https://github.com/ModernRelay/omnigraph-cookbooks/tree/main/dev-graph |

## Node types

### Epic

Multi-issue scope of work. Owner and target release are edges.

- `slug: String` (key)
- `title: String`
- `summary: String?`
- `status: enum(shaping, active, done, abandoned)`
- `businessValue: String?`
- `legacyRef: String?` Id from a prior tracker, e.g. LIN-482
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### SpecFile

Design doc / RFC. Mutable until approved; edits bump version.

- `slug: String` (key)
- `title: String`
- `body: String?`
- `status: enum(draft, under_review, approved, superseded, retired)`
- `version: String?`
- `url: String?` Link to the canonical doc, if it lives outside the graph
- `legacyRef: String?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Component

Logical unit of code (service, module, top-level package). Owner is an edge; repo via RepoHasComponent.

- `slug: String` (key)
- `name: String`
- `summary: String?`
- `criticality: enum(low, medium, high, critical)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Repo

VCS unit.

- `slug: String` (key)
- `name: String`
- `defaultBranch: String?`
- `host: enum(github, gitlab, other)?`
- `visibility: enum(public, private)?`
- `githubRef: String?` owner/name on GitHub
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### PR

Proposed change set. GitHub-authoritative. Branches are strings; commits via PrIncludesCommit.

- `slug: String` (key)
- `title: String`
- `body: String?`
- `status: enum(draft, open, merged, closed)`
- `sourceBranch: String?`
- `targetBranch: String?`
- `invariantReviewDone: Bool?` Whether the PR was reviewed against the invariant/principle set
- `githubRef: String` PR number or URL, e.g. meridian#128
- `legacyRef: String?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Release

Versioned bundle. GitHub-authoritative. Coherence checklist + breaking changes as JSON strings.

- `slug: String` (key)
- `versionTag: String` e.g. v0.5.0
- `status: enum(planned, cut, released, yanked)`
- `releaseNotes: String?`
- `releaseNotesDoc: String?` Link to docs/releases/<version>.md (a SpecFile)
- `breakingChanges: String?` Markdown list of behavior changes
- `artifactsChecklist: String?` JSON array of {path, done} — artifacts that must move atomically on the bump
- `githubRef: String?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Incident

Production issue. Commander is an edge.

- `slug: String` (key)
- `title: String`
- `summary: String?`
- `status: enum(open, mitigated, resolved)`
- `severity: enum(s1, s2, s3, s4)?`
- `env: enum(dev, staging, prod)?`
- `startedAt: Date`
- `mitigatedAt: Date?`
- `resolvedAt: Date?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Issue

Work item. Replaces a tracker issue. Owner is an edge. Terminal states: done, canceled, duplicate.

- `slug: String` (key)
- `title: String`
- `description: String?`
- `status: enum(backlog, todo, in_progress, needs_review, hold, done, canceled, duplicate)`
- `priority: I32?` 0=none, 1=urgent, 2=high, 3=medium, 4=low (tracker convention)
- `issueType: enum(bug, feature, task, chore, question, risk)`
- `acceptanceCriteria: String?`
- `designNotes: String?`
- `legacyRef: String?` Id from a prior tracker, e.g. LIN-903
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Actor

Person or agent that creates, owns, reviews, or authors. agent slugs use 'agent:<name>'.

- `slug: String` (key)
- `name: String`
- `actorKind: enum(human, agent, service)`
- `handle: String?`
- `email: String?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Gate

External waitable. kind is a closed enum (queryable); externalRef is the free-form handle.

- `slug: String` (key)
- `kind: enum(pr_merge, ci_green, timer, manual_approval, feature_flag)`
- `status: enum(pending, passed, failed, expired)`
- `externalRef: String?` URL, CI run id, PR number, or flag name
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Label

Cross-cutting tag.

- `slug: String` (key)
- `name: String`
- `color: String?`
- `scope: String?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Invariant

Checkable property the system maintains. Violation = bug. Internal twin of Assumption.

- `slug: String` (key)
- `statement: String`
- `status: enum(holds, violated)`
- `guardRef: String?` Path to the test/check that enforces it; null = unguarded
- `specRef: String?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Principle

Prescriptive design rule reviewed against on every PR. Violation = rejected PR. polarity prescribes|forbids.

- `slug: String` (key)
- `statement: String`
- `rationale: String?`
- `polarity: enum(prescribes, forbids)`
- `correctAlternative: String?` For forbids: the right thing to do instead
- `status: enum(proposed, active, relaxed, retired)`
- `specRef: String?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Gap

Tracked architectural debt — a desired Invariant not yet held. Can be widened by a PR.

- `slug: String` (key)
- `title: String`
- `currentBehavior: String?`
- `targetBehavior: String?`
- `state: enum(narrowing, widened, closed)`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### ExternalBlocker

External issue/PR/release gating internal work (e.g. an upstream library fix). Durable cousin of Gate.

- `slug: String` (key)
- `system: String` the upstream system we depend on, e.g. a library, service, or platform
- `upstreamUrl: String?`
- `status: enum(open, closed, shipped)`
- `pinnedVersion: String?`
- `shippedInVersion: String?`
- `residualWorkaround: String?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Assumption

Checkable belief about an EXTERNAL system's API/behavior, optionally guard-backed. External twin of Invariant.

- `slug: String` (key)
- `statement: String`
- `status: enum(holds, violated)`
- `guardRef: String?` Compile/runtime test pinning the assumption; null = silent dependency
- `assumptionKind: enum(compile, runtime, manual)`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Capability

Functional capability of the product, tagged by provenance. Different axis from Component; mapped M:N via CapabilityImplementedBy.

- `slug: String` (key)
- `name: String`
- `summary: String?`
- `tier: enum(owned, inherited)` owned = we build it (L2); inherited = from substrate (L1)
- `status: enum(planned, shipped, deprecated)`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record
- `updatedAt: Date`
- `updatedBy: String?` Actor slug of the last editor

### Decision

Architecture Decision Record. Immutable once accepted; corrected via DecisionSupersedes.

- `slug: String` (key)
- `title: String`
- `context: String?`
- `decision: String`
- `consequences: String?`
- `status: enum(proposed, accepted, rejected, superseded)`
- `legacyRef: String?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record

### Commit

Immutable VCS point, modeled only when referenced by a PR or incident (no full commit DAG).

- `slug: String` (key)
- `sha: String`
- `message: String?`
- `githubRef: String?`
- `authoredAt: Date`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record

### Deployment

Act of deploying a Release to an environment. env carries where; current-release-per-env is derived.

- `slug: String` (key)
- `env: enum(dev, staging, prod, preview)`
- `outcome: enum(success, rolled_back, failed)`
- `startedAt: Date`
- `finishedAt: Date?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record

### Learning

Captured lesson: incident analysis, retro takeaway, discovered gotcha, or design hindsight.

- `slug: String` (key)
- `title: String`
- `body: String?`
- `learningKind: enum(incident_review, retro, gotcha, hindsight)?`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record

### Comment

Thread message on an artifact. Never edited; corrections are new Comments. Target via CommentOn*.

- `slug: String` (key)
- `body: String`
- `embedding: Vector(3072)?`
- `createdAt: Date`
- `createdBy: String?` Actor slug that created the record

## Edge types

- `Repo -[RepoHasComponent]-> Component` ---- Containment ----
- `Component -[ComponentHasSubcomponent]-> Component`
- `Epic -[EpicContainsIssue]-> Issue`
- `Release -[ReleaseIncludesPr]-> PR`
- `SpecFile -[SpecSpecifies]-> Epic` ---- Specification & decisions ----
- `SpecFile -[SpecDescribes]-> Component`
- `SpecFile -[SpecSupersedes]-> SpecFile`
- `SpecFile -[SpecReferences]-> SpecFile`
- `Decision -[DecisionAppliesToComponent]-> Component`
- `Decision -[DecisionAppliesToSpec]-> SpecFile`
- `Decision -[DecisionSupersedes]-> Decision`
- `Decision -[DecisionEmergedFromIssue]-> Issue`
- `Decision -[DecisionEmergedFromIncident]-> Incident`
- `Issue -[IssueTargetsComponent]-> Component` ---- Work targeting ----
- `Epic -[EpicTargetsComponent]-> Component`
- `Epic -[EpicTargetsRelease]-> Release`
- `Issue -[IssueTargetsRelease]-> Release` Release the issue is slated for (planning intent; actual delivery is derivable via IssueImplementedBy → ReleaseIncludesPr)
- `Issue -[IssueImplementedBy]-> PR` ---- Implementation ----
- `PR -[PrClosesIssue]-> Issue` Takes effect on merge
- `PR -[PrTouchesComponent]-> Component`
- `PR -[PrIncludesCommit]-> Commit`
- `Release -[ReleaseInRepo]-> Repo` ---- Release / deploy ----
- `Release -[ReleaseSupersedes]-> Release`
- `Deployment -[DeploymentOfRelease]-> Release`
- `Incident -[IncidentAffectsComponent]-> Component` ---- Incident & learning ----
- `Incident -[IncidentCausedByPr]-> PR`
- `Incident -[IncidentCausedByDeployment]-> Deployment`
- `Incident -[IncidentCausedByCommit]-> Commit`
- `Learning -[LearningAnalyzesIncident]-> Incident`
- `Learning -[LearningAboutComponent]-> Component`
- `Learning -[LearningAboutBlocker]-> ExternalBlocker`
- `Learning -[LearningAboutAssumption]-> Assumption`
- `Learning -[LearningAboutGap]-> Gap`
- `Learning -[LearningFromEpic]-> Epic`
- `Learning -[LearningReferencesDecision]-> Decision`
- `Issue -[IssueBlocksIssue]-> Issue` ---- Dependencies: blocking (affect ready-work) ----
- `Epic -[EpicBlocksEpic]-> Epic`
- `PR -[PrBlocksPr]-> PR`
- `Epic -[EpicParentChildIssue]-> Issue` ParentChild: child blocked when parent blocked
- `Issue -[IssueParentChildIssue]-> Issue`
- `Issue -[IssueConditionalBlocksIssue]-> Issue` Target runs only if source fails
- `Issue -[IssueWaitsForIssue]-> Issue`
- `Issue -[IssueWaitsForGate]-> Gate`
- `PR -[PrWaitsForGate]-> Gate`
- `Issue -[IssueWaitsForBlocker]-> ExternalBlocker`
- `PR -[PrWaitsForBlocker]-> ExternalBlocker`
- `Issue -[IssueRelated]-> Issue` General-purpose informational link — the one escape hatch
- `Issue -[IssueDiscoveredFrom]-> Issue`
- `Component -[ComponentDependsOn]-> Component` Architectural dependency, runtime or build-time
- `Issue -[IssueOwnedBy]-> Actor` ---- Ownership / authorship ----
- `Epic -[EpicOwnedBy]-> Actor`
- `Component -[ComponentOwnedBy]-> Actor`
- `Repo -[RepoOwnedBy]-> Actor`
- `SpecFile -[SpecAuthoredBy]-> Actor`
- `Decision -[DecisionAuthoredBy]-> Actor`
- `PR -[PrAuthoredBy]-> Actor`
- `PR -[PrReviewedBy]-> Actor`
- `Commit -[CommitAuthoredBy]-> Actor`
- `Incident -[IncidentCommandedBy]-> Actor`
- `Deployment -[DeploymentTriggeredBy]-> Actor`
- `Comment -[CommentOnIssue]-> Issue` ---- Discussion (Comment per target) ----
- `Comment -[CommentOnPr]-> PR`
- `Comment -[CommentOnSpec]-> SpecFile`
- `Comment -[CommentOnDecision]-> Decision`
- `Comment -[CommentOnIncident]-> Incident`
- `Comment -[CommentOnEpic]-> Epic`
- `Comment -[CommentPostedBy]-> Actor`
- `Issue -[IssueTagged]-> Label` ---- Tagging (per target) ----
- `Epic -[EpicTagged]-> Label`
- `PR -[PrTagged]-> Label`
- `SpecFile -[SpecTagged]-> Label`
- `Component -[ComponentTagged]-> Label`
- `Incident -[IncidentTagged]-> Label`
- `Learning -[LearningTagged]-> Label`
- `Principle -[PrExceptionToPrinciple]-> PR` Justified-exception record, mostly for forbids principles
- `Decision -[DecisionEstablishesInvariant]-> Invariant`
- `Decision -[DecisionEstablishesPrinciple]-> Principle`
- `Decision -[DecisionRelaxesInvariant]-> Invariant`
- `Decision -[DecisionRelaxesPrinciple]-> Principle`
- `Gap -[GapUnderminesInvariant]-> Invariant`
- `Issue -[IssueNarrowsGap]-> Gap`
- `PR -[PrWidensGap]-> Gap` A change that worsens known debt — flagged in review
- `PR -[PrNarrowsGap]-> Gap` A PR that reduces known debt against a Gap (symmetric with IssueNarrowsGap)
- `Invariant -[InvariantAboutComponent]-> Component`
- `Assumption -[AssumptionCoversBlocker]-> ExternalBlocker` A failing guard signals the blocker moved
- `Assumption -[AssumptionAboutComponent]-> Component`
- `Capability -[CapabilityImplementedBy]-> Component`
- `Capability -[CapabilityTrackedBy]-> Epic`
- `Invariant -[InvariantDescribedIn]-> SpecFile`
- `Principle -[PrincipleDescribedIn]-> SpecFile`
- `Gap -[GapDescribedIn]-> SpecFile`
- `Capability -[CapabilityDescribedIn]-> SpecFile`

Full schema: https://github.com/ModernRelay/omnigraph-cookbooks/blob/main/dev-graph/schema.pg

## Questions it answers

### What is ready to pick up?

Issues ready to pick up: backlog/todo, no incoming block, no outgoing wait

```graphql
query ready()
    @description("Issues ready to pick up: backlog/todo, no incoming block, no outgoing wait")
    @instruction("Excludes started + terminal states and any incoming Blocks/ParentChild or outgoing WaitsFor*. The strict 'blocking source must itself be non-terminal' / 'gate must be pending' refinement is left to the caller; this returns the structural candidates.")
{
    match {
        $i: Issue
        not { $_ issueBlocksIssue $i }
        not { $_ issueParentChildIssue $i }
        not { $_ epicParentChildIssue $i }
        not { $i issueWaitsForIssue $_ }
        not { $i issueWaitsForGate $_ }
        not { $i issueWaitsForBlocker $_ }
        $i.status != "in_progress"
        $i.status != "needs_review"
        $i.status != "hold"
        $i.status != "done"
        $i.status != "canceled"
        $i.status != "duplicate"
    }
    return { $i.slug, $i.title, $i.priority, $i.issueType }
    order { $i.priority }
}
```

### Which issues are waiting on a fix upstream?

Non-terminal issues gated on an external (upstream) blocker — the cross-system dependency view

```graphql
query blocked_on_upstream()
    @description("Non-terminal issues gated on an external (upstream) blocker — the cross-system dependency view")
{
    match {
        $i: Issue
        $i issueWaitsForBlocker $blk
        $i.status != "done"
        $i.status != "canceled"
        $i.status != "duplicate"
    }
    return { $i.slug, $i.title, $blk.slug, $blk.system, $blk.status, $blk.shippedInVersion, $blk.pinnedVersion, $blk.residualWorkaround }
}
```

### Which spec describes this epic?

The spec file(s) that specify an epic

```graphql
query epic_spec($epic: String)
    @description("The spec file(s) that specify an epic")
{
    match {
        $e: Epic { slug: $epic }
        $s specSpecifies $e
    }
    return { $s.slug, $s.title, $s.status, $s.version }
}
```

### Which pull requests shipped in this release?

PRs included in a release (the per-release changeset)

```graphql
query release_prs($release: String)
    @description("PRs included in a release (the per-release changeset)")
{
    match {
        $r: Release { slug: $release }
        $r releaseIncludesPr $p
    }
    return { $p.slug, $p.title, $p.githubRef, $p.status }
}
```

## Stored queries

### queries/issues-dashboard.gq

- `open_epics`: Open epics (shaping or active), most-recently-updated first
- `epic_issue_counts`: Issue count by status within an epic (completion at a glance)
- `epic_spec`: The spec file(s) that specify an epic
- `epic_release`: Release(s) an epic targets
- `epic_owner`: Actor that owns an epic
- `issue_detail`: Full issue detail incl. acceptance criteria + design notes
- `issue_owner`: Actor that owns an issue
- `issue_labels`: Labels tagged on an issue
- `issue_blockers`: Issues blocking this one via incoming IssueBlocksIssue, with status. This is only the hard issue-blocks-issue dimension — for parent/gate/upstream blocks see issue_parents, issue_parent_epic, issue_gates, issue_waits_on.
- `issue_parents`: Parent issues of this one (incoming IssueParentChildIssue) — this issue is blocked when a parent is. The inverse of issue_children.
- `issue_parent_epic`: Parent epic gating this issue via EpicParentChildIssue (the blocking parent-child edge, distinct from EpicContainsIssue membership)
- `issue_related`: Issues explicitly related to this one (IssueRelated)
- `issue_children`: Sub-issues of this one (IssueParentChildIssue)
- `issue_waits_on`: External blockers this issue waits for (IssueWaitsForBlocker)
- `issue_gates`: Gates this issue waits for (IssueWaitsForGate)
- `issue_decisions`: Decisions that emerged from this issue (DecisionEmergedFromIssue)
- `issue_components`: Components an issue targets (IssueTargetsComponent)
- `issue_comments`: Comments on this issue, oldest first; createdBy is the author actor slug

### queries/queries.gq

- `issue_lookup`: Fetch an issue by slug
- `epic_lookup`: Fetch an epic by slug
- `pr_lookup`: Fetch a PR by slug
- `ready`: Issues ready to pick up: backlog/todo, no incoming block, no outgoing wait
- `blocked`: Non-terminal issues blocked by another issue (incoming IssueBlocksIssue). ready() also excludes parent/gate/wait/upstream blocks — see blocked_by_parent, blocked_by_epic, blocked_by_gate, blocked_by_wait, blocked_on_upstream for those dimensions.
- `blocked_by_parent`: Non-terminal issues with a parent issue (incoming IssueParentChildIssue) — a child is blocked when its parent is
- `blocked_by_epic`: Non-terminal issues gated by a parent epic (incoming EpicParentChildIssue — the blocking parent-child edge, distinct from EpicContainsIssue membership)
- `blocked_by_gate`: Non-terminal issues waiting on a Gate (outgoing IssueWaitsForGate) — check the gate's status to see if it still blocks
- `blocked_by_wait`: Non-terminal issues waiting on another issue (outgoing IssueWaitsForIssue) — a soft aggregation dependency, distinct from a hard IssueBlocksIssue
- `blocked_on_upstream`: Non-terminal issues gated on an external (upstream) blocker — the cross-system dependency view
- `stale_candidates`: Active (non-terminal) issues, oldest-updated first
- `epic_issues`: All issues contained by an epic
- `epic_open_issues`: Non-terminal issues remaining in an epic (completion = 1 - open/total)
- `release_prs`: PRs included in a release (the per-release changeset)
- `issue_implementations`: PRs that implement an issue
- `prs_for_component`: PRs that touch a component — component churn input
- `issues_for_component`: Issues targeting a component
- `incident_root_cause`: Multi-hop: incident → causing PR → its commits
- `incident_components`: Components an incident affected — blast-radius first hop
- `learnings_for_incident`: Learnings that analyze an incident
- `unheld_invariants`: Invariants currently violated (incl. aspirational ones not yet held)
- `gaps_undermining_invariants`: Open gaps and the invariants they fall short of
- `assumptions`: All assumptions with their guard reference and status
- `assumptions_for_blocker`: Surface-guard assumptions covering an external blocker (failing guard ⇒ blocker moved)
- `capabilities_by_tier`: Capabilities of a given provenance tier (owned/inherited) and their implementing components
- `decisions_for_component`: Accepted decisions (ADRs) that apply to a component
- `components_without_spec`: Components with no SpecFile describing them — documentation gap
- `capabilities_without_component`: Capabilities with no implementing component — planning gap
- `search_issues`: Semantic search over issues
- `search_epics`: Semantic search over epics
- `search_specs`: Semantic search over spec/RFC docs
- `search_decisions`: Semantic search over ADRs / decisions
- `search_learnings`: Semantic search over learnings (incident reviews, gotchas, hindsight)
- `search_invariants`: Semantic search over invariants
- `search_principles`: Semantic search over principles
- `search_gaps`: Semantic search over architectural gaps
- `search_capabilities`: Semantic search over product capabilities
- `search_prs`: Semantic search over PRs
- `search_incidents`: Semantic search over incidents
- `create_issue` (write): Create a work item. status: backlog|todo|in_progress|needs_review|hold|done|canceled|duplicate; issueType: bug|feature|task|chore|question|risk.
- `create_epic` (write): Create an epic. status: shaping|active|done|abandoned.
- `create_pr` (write): Create a PR record (VCS-host-authoritative). status: draft|open|merged|closed; githubRef required, e.g. meridian#128.
- `update_issue_status` (write): Transition an issue's status.
- `set_issue_priority` (write): Set issue priority (0=none,1=urgent,2=high,3=medium,4=low).
- `update_epic_status` (write): Transition an epic's status.
- `update_pr_status` (write): Transition a PR's status (draft/open/merged/closed).
- `resolve_incident` (write): Update an incident's status; stamps resolvedAt (use status=resolved).
- `set_invariant_status` (write): Flip an invariant between holds/violated.
- `update_gap_state` (write): Move a gap through narrowing/widened/closed.
- `mark_blocker_shipped` (write): Update an external blocker (status: open|closed|shipped); record shippedInVersion.
- `update_capability_status` (write): Move a capability through planned/shipped/deprecated.
- `add_issue_to_epic` (write): EpicContainsIssue: place an issue under an epic.
- `link_issue_blocks_issue` (write): IssueBlocksIssue: source blocks target (target has it incoming).
- `link_pr_closes_issue` (write): PrClosesIssue: takes effect on merge.
- `link_issue_implemented_by_pr` (write): IssueImplementedBy: a PR implements an issue.
- `link_issue_targets_component` (write): IssueTargetsComponent: which component the issue touches.
- `assign_issue_owner` (write): IssueOwnedBy: set the issue owner (ownership is an edge, not a field).
- `add_comment_on_issue` (write): Append a comment to an issue thread (Comment is never edited).
- `record_decision` (write): Record an ADR (append-only). status: proposed|accepted|rejected|superseded.
- `supersede_decision` (write): DecisionSupersedes: a new decision replaces an earlier one (create the new Decision first).
- `record_deployment` (write): Record a deployment (append-only). env: dev|staging|prod|preview; outcome: success|rolled_back|failed.
- `add_learning` (write): Capture a learning from an incident (append-only).

## Run it

```bash
git clone https://github.com/ModernRelay/omnigraph-cookbooks
cd omnigraph-cookbooks
export COOKBOOK=$PWD/dev-graph
omnigraph cluster validate --config "$COOKBOOK"
omnigraph cluster apply --target "$COOKBOOK" --config "$COOKBOOK" --as act-admin --json
```

The full local setup (server, sample data, queries): https://github.com/ModernRelay/omnigraph-cookbooks#local-setup

Source: https://www.omnigraph.dev/use-cases/dev-graph
