Skip to content

Check a bug issue's lifecycle state

Use this to read where a bug issue stands — combining GitHub’s native open/closed state with the triage board’s Status value — without mutating anything.

  1. Call:

    get_lifecycle_state {
    owner: "<owner>",
    repo: "<repo>",
    issueNumber: <n>,
    projectOwnerLogin: "<org-or-user>",
    projectNumber: <n>
    }
  2. Read the response:

    {
    "issueNumber": 142,
    "nativeState": "open",
    "onBoard": true,
    "status": "In Progress"
    }
    • nativeState is GitHub’s own open/closed, independent of the board.
    • onBoard: false means the issue isn’t a project item on the board you specified; status will be null in that case.
    • status: null with onBoard: true means the issue is on the board but its Status field has no value set. Neither case is an error — this tool never throws for a missing board membership or Status value.
  • If you need a hard failure instead of a null on a missing board/field (for example, before a write), use set_lifecycle_state instead — it resolves the same data but must throw a typed error when it can’t proceed.