GitState

Defined in: src/forge/types.ts:143

A session’s forge kind plus its current PR status — the GET /api/sessions/:id/git payload and the value cached/pushed for the list overview.

Extends

• PrStatus

Properties

checks

checks: ChecksState

Defined in: src/forge/types.ts:123

Inherited from

PrStatus.checks

---

createdAt?

optional createdAt?: number

Defined in: src/forge/types.ts:120

ms epoch the PR was opened; undefined when there is no PR (or a cached payload predates the field). Drives the UI’s “PR open for X” wait line.

Inherited from

PrStatus.createdAt

---

deployConfigured

deployConfigured: boolean

Defined in: src/forge/types.ts:138

A deploy workflow is configured for this host.

Inherited from

PrStatus.deployConfigured

---

handoff?

optional handoff?: "reviewer" | "merger"

Defined in: src/forge/types.ts:149

Who is up once the PR is open + green, when it isn’t the operator — computed server-side from .shepherd/roles.json + the operator’s login. Absent = the operator’s turn (today’s “awaiting merge”). Drives the herd’s waiting-on-reviewer / waiting-on-merger groups.

---

handoffInferred?

optional handoffInferred?: boolean

Defined in: src/forge/types.ts:155

true when handoff was auto-inferred from PR reviewers (no .shepherd/roles.json); suppresses the outward issue-log comment, which stays opt-in to explicitly-configured roles.

---

handoffWho?

optional handoffWho?: string

Defined in: src/forge/types.ts:151

The login to display for handoff (e.g. “scoop”); absent for self.

---

headSha?

optional headSha?: string

Defined in: src/forge/types.ts:126

Head commit SHA of the PR branch; undefined when there is no PR. Drives “review this head once” dedup and per-push re-review.

Inherited from

PrStatus.headSha

---

isDraft?

optional isDraft?: boolean

Defined in: src/forge/types.ts:134

true = PR is a draft / not ready-for-review. Optional; absent ⇒ treat as false downstream.

Inherited from

PrStatus.isDraft

---

issueUrl?

optional issueUrl?: string

Defined in: src/forge/types.ts:159

Web URL of the backlog issue this session was spawned for (session.issueNumber), or absent when the session has no linked issue or the repo has no web forge (LocalForge). Lets GitRail surface an “open issue” link.

---

kind

kind: ForgeKind

Defined in: src/forge/types.ts:144

---

latestReview?

optional latestReview?: PrReview

Defined in: src/forge/types.ts:128

Newest human PR review (critic-marked reviews excluded), or undefined.

Inherited from

PrStatus.latestReview

---

mergeable?

optional mergeable?: boolean | null

Defined in: src/forge/types.ts:122

null = host still computing mergeability.

Inherited from

PrStatus.mergeable

---

mergeStateStatus?

optional mergeStateStatus?: MergeStateStatus

Defined in: src/forge/types.ts:136

GitHub’s merge-eligibility signal; undefined on forges that don’t supply it (Gitea).

Inherited from

PrStatus.mergeStateStatus

---

number?

optional number?: number

Defined in: src/forge/types.ts:115

Inherited from

PrStatus.number

---

requestedReviewers?

optional requestedReviewers?: string[]

Defined in: src/forge/types.ts:132

GitHub logins with a pending review request on the PR (teams/bots without a login are dropped). Drives merger auto-inference when the repo has no .shepherd/roles.json. Optional: a cached payload predating the field ⇒ treat as [].

Inherited from

PrStatus.requestedReviewers

---

state

state: "none" | "open" | "merged" | "closed"

Defined in: src/forge/types.ts:114

Inherited from

PrStatus.state

---

title?

optional title?: string

Defined in: src/forge/types.ts:117

Inherited from

PrStatus.title

---

url?

optional url?: string

Defined in: src/forge/types.ts:116

Inherited from

PrStatus.url