{
  "slug": "gh-issue-adds-hierarchy-type-and-dependency-workflows-6e8d184fe3e9",
  "title": "gh issue adds hierarchy, type, and dependency workflows",
  "tools": [
    "gh"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-10T22:20:55.000Z",
  "announced_at": "2026-06-10T22:20:55.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When managing issue types, hierarchy, or dependencies, use `gh` v2.94.0 or later in a supported repository; create or edit issues with the documented flags, then read structure with `gh issue view` or `gh issue list --json`.",
    "examples": [
      "gh issue create --title \"<title>\" --body \"<body>\" --type <type> --parent <parent-number> --blocked-by <issue-number>",
      "gh issue edit <issue-number> --type <type> --add-sub-issue <sub-issue-number> --add-blocking <issue-number>",
      "gh issue list --type <type> --json number,title,issueType,parent,subIssues,blockedBy,blocking"
    ],
    "gotchas": [
      "Version: v2.94.0",
      "Requires Install or upgrade to GitHub CLI v2.94.0.",
      "--title <string>: Supply the new issue title; otherwise prompted.",
      "--body <string>: Supply the new issue body; otherwise prompted.",
      "--type <name>: Set or filter by issue type name.",
      "--parent <number>: Create the issue as a sub-issue of the specified parent number or URL.",
      "--blocked-by <numbers>: Mark the new issue as blocked by the listed issue numbers or URLs.",
      "--add-sub-issue <number>: Add the specified issue as a sub-issue.",
      "--add-blocking <numbers>: Add issue numbers or URLs that this issue blocks.",
      "--json <fields>: Output selected comma-separated JSON fields.",
      "issueType: JSON field for issue type.",
      "parent: JSON field for parent issue.",
      "subIssues: JSON field for sub-issues.",
      "blockedBy: JSON field for issues blocking this issue.",
      "blocking: JSON field for issues this issue blocks.",
      "Prerequisite: Use GitHub CLI v2.94.0 or later. Issue types and sub-issues are available on GitHub.com and GHES 3.17+; issue relationships require GHES 3.19+.",
      "Prerequisite: Issue type support applies in organizations that have defined issue types.",
      "Hierarchy and dependency support is available in repositories where those features are available.",
      "Issue types are configured at the organization level; type support applies to issues in organizations that have defined them."
    ]
  },
  "why_it_matters": "When organizing repository work or automating issue workflows, create and inspect issue types, parent and sub-issue relationships, and dependencies from the terminal.",
  "sources": [
    "https://github.blog/changelog/2026-06-10-manage-sub-issues-types-and-dependencies-from-github-cli",
    "https://cli.github.com/manual/gh_issue_create",
    "https://github.com/cli/cli/releases/tag/v2.94.0",
    "https://cli.github.com/manual/gh_issue_list",
    "https://cli.github.com/manual/gh_issue_view"
  ],
  "rank": 0.97051,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3-rejudge+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "recover-20261008",
    "verdict_id": "recover-20261008:recover-20261008-ade16b231c110c9d-0:rescue",
    "evidence_hash": "60f0b56d1fa18f863fe6c802f4417fdc0432af038c0e42517ecc958a437f116d"
  },
  "review": {
    "draft_hash": "3364ed839542c568a4b54a3a3c002fe2d8cdfb9ea3d4e8a08444528581f92a34",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "recover-20261008:rescue",
    "reason": "Rescue path: first rejected only because the extracted card lacked usage; judged again on the enriched card, 3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.64 (>= 0.6 needed)."
  }
}