@ghx-dev/core 0.2.0 → 0.2.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ghx",
-  "description": "GitHub execution router for AI agents — 66 capabilities with deterministic routing and normalized output",
-  "version": "0.2.0",
+  "description": "GitHub execution router for AI agents — 70 capabilities with deterministic routing and normalized output",
+  "version": "0.2.2",
   "author": {
     "name": "Arye Kogan"
   },

package/README.md

@@ -1,276 +1,120 @@
-# @ghx-dev/core
+<h1 align="center">@ghx-dev/core</h1>
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/aryeko/ghx/main/assets/branding/social/ghx-social-dark-1280x640.png" alt="ghx social preview" width="480">
 </p>
 
+<p align="center">
+  A typed GitHub execution router that gives AI agents deterministic, token-efficient access to the GitHub API.
+</p>
+
 [![npm version](https://img.shields.io/npm/v/%40ghx-dev%2Fcore)](https://www.npmjs.com/package/@ghx-dev/core)
 [![npm downloads](https://img.shields.io/npm/dm/%40ghx-dev%2Fcore)](https://www.npmjs.com/package/@ghx-dev/core)
 [![CI (main)](https://github.com/aryeko/ghx/actions/workflows/ci-main.yml/badge.svg)](https://github.com/aryeko/ghx/actions/workflows/ci-main.yml)
 [![codecov](https://codecov.io/gh/aryeko/ghx/graph/badge.svg?token=KBIGR138V7)](https://codecov.io/gh/aryeko/ghx)
 [![License](https://img.shields.io/npm/l/%40ghx-dev%2Fcore)](https://github.com/aryeko/ghx/blob/main/LICENSE)
 
-Typed GitHub execution router for AI agents. Deterministic routing across CLI and GraphQL, runtime schema validation, and a stable result envelope -- so agents stop wasting tokens re-discovering GitHub API surfaces.
-
-## Why ghx
-
-Agents instructed to "use `gh` CLI" for common PR and issue operations waste significant tokens on research, trial-and-error, and output parsing. Benchmarked across 27 runs on standard PR workflows:
-
-| Metric | Improvement |
-|---|---|
-| Active tokens | **-37%** fewer tokens consumed |
-| Latency | **-32%** faster end-to-end |
-| Tool calls | **-33%** fewer tool invocations |
-| Success rate | **100%** (zero regressions) |
-
-ghx eliminates the discovery phase: agents call typed capabilities, get validated results back in a stable envelope.
-
-## Installation
-
-Requirements: Node.js `22+`, `gh` CLI authenticated (`gh auth status`).
-
-```bash
-npm install @ghx-dev/core
+## Why ghx?
+
+When AI agents use the `gh` CLI directly, they waste thousands of tokens on research, trial-and-error formatting, and guessing JSON parsing paths. **ghx eliminates this waste** by providing a stable, structured execution layer.
+
+> **100% success rate, 73% fewer tool calls, 18% fewer active tokens, 54% lower latency** compared to raw CLI usage ([measured across 30 runs](https://github.com/aryeko/ghx/blob/main/docs/eval-report.md) on standard PR workflows with Codex 5.3).
+
+```mermaid
+sequenceDiagram
+    participant Agent
+    participant ghx as ghx
+    participant GH as GitHub API
+
+    %% Agent requests a typed execution
+    Agent->>ghx: executeTask("pr.view", { owner, name, prNumber })
+    
+    %% ghx routing engine takes over
+    Note over ghx: 1. Validate input schema<br/>2. Select optimal route (GraphQL/CLI)<br/>3. Run preflight checks
+    ghx->>GH: typed GraphQL request
+    GH-->>ghx: response
+    Note over ghx: normalize errors & structure
+    
+    %% Stable envelope returned
+    ghx-->>Agent: ResultEnvelope { ok: true, data: { ... } }
 ```
 
-Alternative package managers:
-
-```bash
-pnpm add @ghx-dev/core
-# or
-yarn add @ghx-dev/core
-```
+## Features
 
-Or run directly without installing:
+- **70+ Declarative Capabilities**: PRs, issues, labels, workflows, projects, releases — all defined by versioned YAML operation cards.
+- **Deterministic Routing**: The agent doesn't choose CLI vs. GraphQL. ghx evaluates suitability rules and picks the optimal route automatically, with built-in fallbacks.
+- **Stable Result Envelope**: No try/catch needed. Every execution returns `{ ok, data, error, meta }`. Errors are mapped to standard codes (`AUTH`, `RATE_LIMIT`, `NOT_FOUND`, etc.).
+- **Chaining & Batching**: Execute multiple steps (`add label`, `add assignee`, `comment`) in one call. ghx resolves node IDs and batches them into a single network request.
+- **Type Safety**: Full TypeScript schemas for inputs and outputs (via generated GraphQL types).
 
-```bash
-npx @ghx-dev/core capabilities list
-```
+## Documentation
 
-Global CLI install:
+Comprehensive documentation is available in the [`docs/`](./docs/) directory:
 
-```bash
-npm i -g @ghx-dev/core
-```
+- **[Getting Started](./docs/getting-started/README.md)** — Installation, why ghx, and use case diagrams.
+  - [Library Quickstart](./docs/getting-started/library-quickstart.md)
+  - [CLI Quickstart](./docs/getting-started/cli-quickstart.md)
+  - [Agent Setup](./docs/getting-started/agent-setup.md)
+- **[Concepts](./docs/concepts/README.md)** — How ghx works internally (Routing Engine, Operation Cards, Result Envelope, Chaining).
+- **[Architecture](./docs/architecture/README.md)** — System design, execution pipeline, formatters, and GraphQL layer.
+- **[Reference](./docs/reference/README.md)** — API exports, error codes, and a complete table of all 70+ capabilities.
 
-## Quick Start (CLI)
-
-Set `GITHUB_TOKEN` or `GH_TOKEN` in your environment, then:
+## Quick Start (Library)
 
 ```bash
-npx @ghx-dev/core capabilities list
-npx @ghx-dev/core capabilities explain repo.view
-npx @ghx-dev/core run repo.view --input '{"owner":"aryeko","name":"ghx"}'
-```
-
-If installed globally, replace `npx @ghx-dev/core` with `ghx`.
-
-Every capability returns a stable envelope:
-
-```json
-{
-  "ok": true,
-  "data": {
-    "id": "R_kgDOOx...",
-    "name": "ghx",
-    "nameWithOwner": "aryeko/ghx"
-  },
-  "error": null,
-  "meta": {
-    "capability_id": "repo.view",
-    "route_used": "cli",
-    "reason": "CARD_PREFERRED"
-  }
-}
+npm install @ghx-dev/core
 ```
 
-## Quick Start (Library API)
-
 ```ts
 import { createGithubClientFromToken, executeTask } from "@ghx-dev/core"
 
 const token = process.env.GITHUB_TOKEN!
 const githubClient = createGithubClientFromToken(token)
 
+// Execute a task: input is validated, optimal route is chosen
 const result = await executeTask(
   { task: "repo.view", input: { owner: "aryeko", name: "ghx" } },
   { githubClient, githubToken: token },
 )
 
 if (result.ok) {
-  console.log(result.data)
+  console.log("Success:", result.data.nameWithOwner)
+  console.log("Route used:", result.meta.route_used) // e.g. "graphql"
 } else {
-  console.error(result.error?.code, result.error?.message)
+  console.error("Failed:", result.error.code) // e.g. "NOT_FOUND"
+  console.error("Retryable?", result.error.retryable)
 }
 ```
 
-Need a custom GraphQL transport? Use `createGithubClient(transport)` instead -- see the [advanced usage section](#custom-graphql-transport).
-
-## Agent Onboarding
+## Quick Start (CLI)
 
-Install ghx as a project skill for Claude Code:
+Use ghx directly from your terminal or add it as an agent skill.
 
 ```bash
-npx @ghx-dev/core setup --scope project --yes
-npx @ghx-dev/core setup --scope project --verify
-```
-
-### Setup Skill Source
-
-The canonical setup skill content is stored in:
-
-- `skills/using-ghx/SKILL.md` (package root)
-
-During build/publish it is copied to:
-
-- `dist/skills/using-ghx/SKILL.md`
-
-`ghx setup` writes this content to `.agents/skills/ghx/SKILL.md` in user or project scope.
-
-## Agent Tools
-
-```ts
-import {
-  createExecuteTool,
-  createGithubClientFromToken,
-  executeTask,
-  explainCapability,
-  listCapabilities,
-} from "@ghx-dev/core"
-
-// Wire the execute tool to the real engine
-const token = process.env.GITHUB_TOKEN!
-const githubClient = createGithubClientFromToken(token)
-
-const tool = createExecuteTool({
-  executeTask: (request) => executeTask(request, { githubClient, githubToken: token }),
-})
-
-// Discover and execute capabilities
-console.log(listCapabilities())
-console.log(explainCapability("repo.view"))
-const result = await tool.execute("repo.view", { owner: "aryeko", name: "ghx" })
-```
-
-## 69 Capabilities
-
-**Repository** -- `repo.view`, `repo.labels.list`, `repo.issue_types.list`
-
-**Issues** -- `issue.view`, `issue.list`, `issue.comments.list`, `issue.create`, `issue.update`, `issue.close`, `issue.reopen`, `issue.delete`, `issue.labels.update`, `issue.assignees.update`, `issue.milestone.set`, `issue.comments.create`, `issue.linked_prs.list`, `issue.relations.get`, `issue.parent.set`, `issue.parent.remove`, `issue.blocked_by.add`, `issue.blocked_by.remove`
-
-**Pull Requests (read)** -- `pr.view`, `pr.list`, `pr.threads.list`, `pr.reviews.list`, `pr.diff.files`, `pr.checks.list`, `pr.merge.status`
-
-**Pull Requests (execute)** -- `pr.threads.reply`, `pr.threads.resolve`, `pr.threads.unresolve`, `pr.update`, `pr.reviews.submit`, `pr.reviews.request`, `pr.merge`, `pr.checks.rerun.failed`, `pr.checks.rerun.all`, `pr.branch.update`, `pr.assignees.add`, `pr.assignees.remove`
-
-**CI Diagnostics** -- `workflow.runs.list`, `workflow.job.logs.get`
-
-**Releases** -- `release.list`, `release.get`, `release.create_draft`, `release.update`, `release.publish_draft`
-
-**Workflow Controls** -- `workflow.list`, `workflow.get`, `workflow_dispatch.run`, `workflow_run.view`, `workflow_run.rerun_failed`, `workflow_run.rerun_all`, `workflow_run.cancel`, `workflow_run.artifacts.list`
-
-**Projects v2** -- `project_v2.org.get`, `project_v2.user.get`, `project_v2.fields.list`, `project_v2.items.list`, `project_v2.item.add_issue`, `project_v2.item.field.update`
-
-For exact input/output contracts, see the [operation card registry](https://github.com/aryeko/ghx/tree/main/packages/core/src/core/registry/cards).
-
-## Result Envelope
+# List all 70+ capabilities
+npx @ghx-dev/core capabilities list
 
-All execution paths resolve to:
+# Run a capability
+npx @ghx-dev/core run pr.view --input '{"owner":"aryeko","name":"ghx","number":42}'
 
-```ts
-type ResultEnvelope<TData = unknown> = {
-  ok: boolean
-  data?: TData
-  error?: {
-    code: string      // AUTH, NOT_FOUND, RATE_LIMIT, VALIDATION, ...
-    message: string
-    retryable: boolean
-    details?: Record<string, unknown>
-  }
-  meta: {
-    capability_id: string
-    route_used?: "cli" | "graphql" | "rest"
-    reason?: string
-    attempts?: Array<{
-      route: "cli" | "graphql" | "rest"
-      status: "success" | "error" | "skipped"
-      error_code?: string
-      duration_ms?: number
-    }>
-  }
-}
+# Output is a standard ResultEnvelope:
+# {
+#   "ok": true,
+#   "data": { ... },
+#   "meta": { "capability_id": "pr.view", "route_used": "graphql", ... }
+# }
 ```
 
-## Environment Variables
+## Agent Integration
 
-- `GITHUB_TOKEN` or `GH_TOKEN` (required)
-- `GITHUB_GRAPHQL_URL` (optional; override GraphQL endpoint)
-- `GH_HOST` (optional; derives enterprise GraphQL endpoint)
+To install the `ghx` skill for Claude Code:
 
-## Security and Permissions
-
-- Start with least privilege and grant only what your capability set needs.
-- For quick local testing, a classic PAT with `repo` scope is the simplest route.
-- For production agents, prefer fine-grained tokens with read permissions first (`Metadata`, `Contents`, `Pull requests`, `Issues`, `Actions`, `Projects`) and add writes only where needed.
-
-## Compatibility
-
-- Node.js `22+`
-- GitHub Cloud and GitHub Enterprise hosts (`GH_HOST` supported)
-- Route adapters: CLI and GraphQL
-
-## Public Exports
-
-Root (`@ghx-dev/core`):
-
-- `executeTask` -- run a capability
-- `createGithubClientFromToken` -- create a client from a token string
-- `createGithubClient`, `createGraphqlClient` -- create clients from a custom transport
-- `listOperationCards`, `getOperationCard` -- inspect capability registry
-- `createSafeCliCommandRunner` -- custom CLI execution
-- Types: `TaskRequest`, `ResultEnvelope`, `ResultError`, `ResultMeta`, `AttemptMeta`, `RouteSource`, `RouteReasonCode`, `TokenClientOptions`
-
-Subpaths:
-
-- `@ghx-dev/core/cli` -- CLI entrypoint
-
-## Custom GraphQL Transport
-
-For full control over the GraphQL layer, pass your own transport to `createGithubClient`:
-
-```ts
-import { createGithubClient, executeTask } from "@ghx-dev/core"
-
-const githubClient = createGithubClient({
-  async execute<TData>(query: string, variables?: Record<string, unknown>): Promise<TData> {
-    const response = await fetch("https://api.github.com/graphql", {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${process.env.GITHUB_TOKEN}`,
-      },
-      body: JSON.stringify({ query, variables: variables ?? {} }),
-    })
-    const payload = (await response.json()) as { data?: TData; errors?: Array<{ message?: string }> }
-    if (payload.errors?.length) throw new Error(payload.errors[0]?.message ?? "GraphQL error")
-    if (payload.data === undefined) throw new Error("GraphQL response missing data")
-    return payload.data
-  },
-})
-
-const result = await executeTask(
-  { task: "repo.view", input: { owner: "aryeko", name: "ghx" } },
-  { githubClient, githubToken: process.env.GITHUB_TOKEN },
-)
+```bash
+npx @ghx-dev/core setup --scope project --yes
 ```
 
-## Documentation
-
-- [Documentation Hub](https://github.com/aryeko/ghx/blob/main/docs/README.md)
-- [Architecture](https://github.com/aryeko/ghx/blob/main/docs/architecture/README.md)
-- [Capabilities Reference](https://github.com/aryeko/ghx/blob/main/docs/capabilities/README.md)
-- [Operation Cards](https://github.com/aryeko/ghx/blob/main/docs/architecture/operation-cards.md)
-- [Publishing Guide](https://github.com/aryeko/ghx/blob/main/docs/contributing/publishing.md)
+This installs `.agents/skills/ghx/SKILL.md` which teaches Claude how to use `npx @ghx-dev/core` for reliable GitHub interactions.
 
 ## License
 
-MIT - https://github.com/aryeko/ghx/blob/main/LICENSE
+MIT

package/dist/cards/issue.assignees.add.yaml

@@ -27,6 +27,7 @@ routing:
   fallbacks: [cli]
 graphql:
   operationName: IssueAssigneesAdd
+  operationType: mutation
   documentPath: src/gql/operations/issue-assignees-add.graphql
   resolution:
     lookup:

package/dist/cards/issue.assignees.remove.yaml

@@ -27,6 +27,7 @@ routing:
   fallbacks: [cli]
 graphql:
   operationName: IssueAssigneesRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-assignees-remove.graphql
   resolution:
     lookup:

package/dist/cards/issue.assignees.set.yaml

@@ -26,6 +26,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueAssigneesUpdate
+  operationType: mutation
   documentPath: src/gql/operations/issue-assignees-update.graphql
   resolution:
     lookup:

package/dist/cards/issue.close.yaml

@@ -23,6 +23,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueClose
+  operationType: mutation
   documentPath: src/gql/operations/issue-close.graphql
   resolution:
     lookup:

package/dist/cards/issue.comments.create.yaml

@@ -23,6 +23,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueCommentCreate
+  operationType: mutation
   documentPath: src/gql/operations/issue-comment-create.graphql
   resolution:
     lookup:

package/dist/cards/issue.comments.list.yaml

@@ -43,6 +43,7 @@ routing:
     - CLI fallback uses gh api graphql with bounded cursor pagination for comments.
 graphql:
   operationName: IssueCommentsList
+  operationType: query
   documentPath: src/gql/operations/issue-comments-list.graphql
 cli:
   command: api graphql

package/dist/cards/issue.create.yaml

@@ -25,6 +25,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueCreate
+  operationType: mutation
   documentPath: src/gql/operations/issue-create.graphql
   resolution:
     lookup:

package/dist/cards/issue.delete.yaml

@@ -22,6 +22,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueDelete
+  operationType: mutation
   documentPath: src/gql/operations/issue-delete.graphql
   resolution:
     lookup:

package/dist/cards/issue.labels.add.yaml

@@ -27,6 +27,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueLabelsAdd
+  operationType: mutation
   documentPath: src/gql/operations/issue-labels-add.graphql
   resolution:
     lookup:

package/dist/cards/issue.labels.remove.yaml

@@ -27,6 +27,7 @@ routing:
   fallbacks: [cli]
 graphql:
   operationName: IssueLabelsRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-labels-remove.graphql
   resolution:
     lookup:

package/dist/cards/issue.labels.set.yaml

@@ -26,6 +26,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueLabelsUpdate
+  operationType: mutation
   documentPath: src/gql/operations/issue-labels-update.graphql
   resolution:
     lookup:

package/dist/cards/issue.list.yaml

@@ -42,6 +42,7 @@ routing:
     - Prefer CLI for low-latency structured fetches when gh authentication is available.
 graphql:
   operationName: IssueList
+  operationType: query
   documentPath: src/gql/operations/issue-list.graphql
 cli:
   command: issue list

package/dist/cards/issue.milestone.clear.yaml

@@ -21,6 +21,7 @@ routing:
   fallbacks: [cli]
 graphql:
   operationName: IssueMilestoneSet
+  operationType: mutation
   documentPath: src/gql/operations/issue-milestone-set.graphql
   resolution:
     lookup:

package/dist/cards/issue.milestone.set.yaml

@@ -23,6 +23,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueMilestoneSet
+  operationType: mutation
   documentPath: src/gql/operations/issue-milestone-set.graphql
   resolution:
     lookup:

package/dist/cards/issue.relations.blocked_by.add.yaml

@@ -21,4 +21,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueBlockedByAdd
+  operationType: mutation
   documentPath: src/gql/operations/issue-blocked-by-add.graphql

package/dist/cards/issue.relations.blocked_by.remove.yaml

@@ -21,4 +21,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueBlockedByRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-blocked-by-remove.graphql

package/dist/cards/issue.relations.parent.remove.yaml

@@ -19,6 +19,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueParentRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-parent-remove.graphql
   resolution:
     lookup:

package/dist/cards/issue.relations.parent.set.yaml

@@ -21,4 +21,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueParentSet
+  operationType: mutation
   documentPath: src/gql/operations/issue-parent-set.graphql

package/dist/cards/issue.relations.prs.list.yaml

@@ -31,4 +31,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueLinkedPrsList
+  operationType: query
   documentPath: src/gql/operations/issue-linked-prs-list.graphql

package/dist/cards/issue.relations.view.yaml

@@ -51,4 +51,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueRelationsGet
+  operationType: query
   documentPath: src/gql/operations/issue-relations-get.graphql

package/dist/cards/issue.reopen.yaml

@@ -23,6 +23,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueReopen
+  operationType: mutation
   documentPath: src/gql/operations/issue-reopen.graphql
   resolution:
     lookup:

package/dist/cards/issue.update.yaml

@@ -26,6 +26,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueUpdate
+  operationType: mutation
   documentPath: src/gql/operations/issue-update.graphql
   resolution:
     lookup:

package/dist/cards/issue.view.yaml

@@ -28,6 +28,7 @@ routing:
     - Prefer GraphQL for structured fetch; CLI fallback if gh auth unavailable.
 graphql:
   operationName: IssueView
+  operationType: query
   documentPath: src/gql/operations/issue-view.graphql
 cli:
   command: issue view

package/dist/cards/pr.assignees.add.yaml

@@ -23,7 +23,11 @@ output_schema:
       items: { type: string }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrAssigneesAdd
+  operationType: mutation
+  documentPath: src/gql/operations/pr-assignees-add.graphql
 cli:
   command: pr edit

package/dist/cards/pr.assignees.remove.yaml

@@ -23,7 +23,11 @@ output_schema:
       items: { type: string }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrAssigneesRemove
+  operationType: mutation
+  documentPath: src/gql/operations/pr-assignees-remove.graphql
 cli:
   command: pr edit

package/dist/cards/pr.branch.update.yaml

@@ -17,7 +17,11 @@ output_schema:
     updated: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrBranchUpdate
+  operationType: mutation
+  documentPath: src/gql/operations/pr-branch-update.graphql
 cli:
   command: pr update-branch

package/dist/cards/pr.create.yaml

@@ -3,7 +3,7 @@ version: "1.0.0"
 description: Create a pull request.
 input_schema:
   type: object
-  required: [owner, name, title, head]
+  required: [owner, name, title, head, base]
   properties:
     owner: { type: string, minLength: 1 }
     name: { type: string, minLength: 1 }
@@ -24,7 +24,11 @@ output_schema:
     draft: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrCreate
+  operationType: mutation
+  documentPath: src/gql/operations/pr-create.graphql
 cli:
   command: pr create

package/dist/cards/pr.diff.files.yaml

@@ -38,6 +38,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: PrDiffListFiles
+  operationType: query
   documentPath: src/gql/operations/pr-diff-list-files.graphql
 cli:
   command: pr view

package/dist/cards/pr.list.yaml

@@ -42,6 +42,7 @@ routing:
     - Prefer CLI for low-latency structured fetches when gh authentication is available.
 graphql:
   operationName: PrList
+  operationType: query
   documentPath: src/gql/operations/pr-list.graphql
 cli:
   command: pr list

package/dist/cards/pr.merge.status.yaml

@@ -24,6 +24,7 @@ routing:
   fallbacks: [cli]
 graphql:
   operationName: PrMergeStatus
+  operationType: query
   documentPath: src/gql/operations/pr-merge-status.graphql
 cli:
   command: pr view