{
  "slug": "github-graphql-adds-issue-field-schema-and-value-types-7811d89f39ac",
  "title": "GitHub GraphQL adds issue field schema and value types",
  "tools": [
    "github-graphql-api"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-12T00:00:00.000Z",
  "announced_at": "2026-03-12T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When tooling must read issue field definitions and values, query `Repository.issueFields` and `Issue.issueFieldValues`, selecting concrete union members with inline fragments. Use `IssueFieldCommon` and `IssueFieldValueCommon` for shared fields; `IssueFieldCreateOrUpdateInput` is for supplying values, not reading them.",
    "examples": [
      "query($owner: String!, $name: String!, $first: Int!) { repository(owner: $owner, name: $name) { issueFields(first: $first) { nodes { __typename ... on IssueFieldCommon { id name createdAt dataType description visibility } ... on IssueFieldSingleSelect { options { id name color priority } } } pageInfo { hasNextPage endCursor } } } }",
      "query($owner: String!, $name: String!, $number: Int!, $first: Int!) { repository(owner: $owner, name: $name) { issue(number: $number) { issueFieldValues(first: $first) { nodes { __typename ... on IssueFieldValueCommon { field { __typename ... on IssueFieldCommon { id name dataType } } } ... on IssueFieldDateValue { value } ... on IssueFieldNumberValue { value } ... on IssueFieldSingleSelectValue { name } ... on IssueFieldTextValue { value } } pageInfo { hasNextPage endCursor } } } } }"
    ],
    "gotchas": [
      "repository(owner:, name:) (required): Selects the repository by owner and name.",
      "issue(number:) (required): Selects the issue by its number in the repository.",
      "first: Returns the first n connection elements; use `pageInfo` and `after` to paginate.",
      "IssueFieldCreateOrUpdateInput.fieldId (required): ID of the issue field.",
      "IssueFieldCreateOrUpdateInput.dateValue: Date field value.",
      "IssueFieldCreateOrUpdateInput.numberValue: Numeric field value.",
      "IssueFieldCreateOrUpdateInput.singleSelectOptionId: ID of the selected single-select option.",
      "IssueFieldCreateOrUpdateInput.textValue: Text field value.",
      "IssueFieldCreateOrUpdateInput.delete: Set true to delete the field value.",
      "IssueFieldSingleSelectOptionInput.color (required): Option display color: BLUE, GRAY, GREEN, ORANGE, PINK, PURPLE, RED, or YELLOW.",
      "IssueFieldSingleSelectOptionInput.name (required): Option name.",
      "IssueFieldSingleSelectOptionInput.priority (required): Option priority order.",
      "IssueFieldOrder.direction (required): Ordering direction.",
      "IssueFieldOrder.field (required): Ordering field: NAME or CREATED_AT.",
      "`IssueFieldCreateOrUpdateInput` requires `fieldId`; its value fields include `dateValue`, `numberValue`, `singleSelectOptionId`, and `textValue`.",
      "The added field data types are `DATE`, `NUMBER`, `TEXT`, and `SINGLE_SELECT`.",
      "The added visibility values are `ALL` and `ORG_ONLY`.",
      "The added issue field order values are `NAME` and `CREATED_AT`.",
      "Single-select options require `color`, `name`, and `priority`; `color` accepts `BLUE`, `GRAY`, `GREEN`, `ORANGE`, `PINK`, `PURPLE`, `RED`, or `YELLOW`.",
      "Docs conflict: Current official schema docs list the additional `MULTI_SELECT` field and value types, beyond the four types stated in the card; current docs also add `multiSelectOptionIds`, `confidence`, `rationale`, and `suggest` to `IssueFieldCreateOrUpdateInput`. The current docs are newer than the 2026-03-12 change. https://docs.github.com/en/graphql/reference/issues",
      "Docs conflict: Current changelog documents `Repository.issueFields` and its pagination/order arguments in a later schema change than 2026-03-12. https://docs.github.com/en/graphql/overview/changelog?apiVersion=2022-11-28"
    ]
  },
  "why_it_matters": "Build tooling that reads issue field definitions and values through the GitHub GraphQL API.",
  "sources": [
    "https://docs.github.com/en/graphql/overview/changelog#schema-changes-for-2026-03-12",
    "https://docs.github.com/en/graphql/reference/repos",
    "https://docs.github.com/en/graphql/reference/issues"
  ],
  "rank": 0.97043,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-57d8d410ebef9cd9-7:gate",
    "evidence_hash": "912193d6318cbbe9e6d9a29d83bbd5a8d46afc4c93c8479aad9a6a524b60351c"
  },
  "review": {
    "draft_hash": "d042f5adeabfc971e397f5632a5a490c2a8912eeecbf64115c696a1e855e78a0",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.73 (>= 0.6 needed)."
  }
}