@ghx-dev/core 0.1.2 → 0.2.1

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

@@ -3,21 +3,41 @@ version: "1.0.0"
 description: Set issue milestone number or clear with null.
 input_schema:
   type: object
-  required: [issueId, milestoneNumber]
+  required: [owner, name, issueNumber, milestoneNumber]
   properties:
-    issueId: { type: string, minLength: 1 }
-    milestoneNumber: { type: [integer, "null"], minimum: 1 }
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
+    milestoneNumber: { type: integer, minimum: 1 }
   additionalProperties: false
 output_schema:
   type: object
-  required: [id, milestoneNumber]
+  required: [id, milestoneNumber, updated]
   properties:
     id: { type: string, minLength: 1 }
     milestoneNumber: { type: [integer, "null"] }
+    updated: { type: boolean }
   additionalProperties: false
 routing:
   preferred: graphql
   fallbacks: []
 graphql:
   operationName: IssueMilestoneSet
+  operationType: mutation
   documentPath: src/gql/operations/issue-milestone-set.graphql
+  resolution:
+    lookup:
+      operationName: IssueMilestoneLookupByNumber
+      documentPath: src/gql/operations/issue-milestone-lookup-by-number.graphql
+      vars:
+        owner: owner
+        name: name
+        issueNumber: issueNumber
+        milestoneNumber: milestoneNumber
+    inject:
+      - target: issueId
+        source: scalar
+        path: repository.issue.id
+      - target: milestoneId
+        source: scalar
+        path: repository.milestone.id

package/dist/{core/registry/cards/issue.blocked_by.add.yaml → cards/issue.relations.blocked_by.add.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.blocked_by.add
+capability_id: issue.relations.blocked_by.add
 version: "1.0.0"
 description: Add a blocked-by relation for an issue.
 input_schema:
@@ -10,14 +10,16 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [issueId, blockedByIssueId]
+  required: [issueId, blockedByIssueId, added]
   properties:
     issueId: { type: string, minLength: 1 }
     blockedByIssueId: { type: string, minLength: 1 }
+    added: { type: boolean }
   additionalProperties: false
 routing:
   preferred: graphql
   fallbacks: []
 graphql:
   operationName: IssueBlockedByAdd
+  operationType: mutation
   documentPath: src/gql/operations/issue-blocked-by-add.graphql

package/dist/cards/{issue.blocked_by.remove.yaml → issue.relations.blocked_by.remove.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.blocked_by.remove
+capability_id: issue.relations.blocked_by.remove
 version: "1.0.0"
 description: Remove a blocked-by relation for an issue.
 input_schema:
@@ -21,4 +21,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueBlockedByRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-blocked-by-remove.graphql

package/dist/cards/{issue.parent.remove.yaml → issue.relations.parent.remove.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.parent.remove
+capability_id: issue.relations.parent.remove
 version: "1.0.0"
 description: Remove an issue parent relation.
 input_schema:
@@ -19,4 +19,15 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueParentRemove
+  operationType: mutation
   documentPath: src/gql/operations/issue-parent-remove.graphql
+  resolution:
+    lookup:
+      operationName: IssueParentLookup
+      documentPath: src/gql/operations/issue-parent-lookup.graphql
+      vars:
+        issueId: issueId
+    inject:
+      - target: parentIssueId
+        source: scalar
+        path: node.parent.id

package/dist/{core/registry/cards/issue.parent.set.yaml → cards/issue.relations.parent.set.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.parent.set
+capability_id: issue.relations.parent.set
 version: "1.0.0"
 description: Set an issue parent relation.
 input_schema:
@@ -10,14 +10,16 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [issueId, parentIssueId]
+  required: [issueId, parentIssueId, updated]
   properties:
     issueId: { type: string, minLength: 1 }
     parentIssueId: { type: string, minLength: 1 }
+    updated: { type: boolean }
   additionalProperties: false
 routing:
   preferred: graphql
   fallbacks: []
 graphql:
   operationName: IssueParentSet
+  operationType: mutation
   documentPath: src/gql/operations/issue-parent-set.graphql

package/dist/{core/registry/cards/issue.linked_prs.list.yaml → cards/issue.relations.prs.list.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.linked_prs.list
+capability_id: issue.relations.prs.list
 version: "1.0.0"
 description: List pull requests linked to an issue.
 input_schema:
@@ -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.get.yaml → issue.relations.view.yaml}

@@ -1,4 +1,4 @@
-capability_id: issue.relations.get
+capability_id: issue.relations.view
 version: "1.0.0"
 description: Get issue parent/children/blocking relations.
 input_schema:
@@ -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

@@ -3,9 +3,11 @@ version: "1.0.0"
 description: Reopen a closed issue.
 input_schema:
   type: object
-  required: [issueId]
+  required: [owner, name, issueNumber]
   properties:
-    issueId: { type: string, minLength: 1 }
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
   additionalProperties: false
 output_schema:
   type: object
@@ -21,4 +23,17 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueReopen
+  operationType: mutation
   documentPath: src/gql/operations/issue-reopen.graphql
+  resolution:
+    lookup:
+      operationName: IssueNodeIdLookup
+      documentPath: src/gql/operations/issue-node-id-lookup.graphql
+      vars:
+        owner: owner
+        name: name
+        issueNumber: issueNumber
+    inject:
+      - target: issueId
+        source: scalar
+        path: repository.issue.id

package/dist/cards/issue.update.yaml

@@ -3,9 +3,11 @@ version: "1.0.0"
 description: Update issue title and/or body.
 input_schema:
   type: object
-  required: [issueId]
+  required: [owner, name, issueNumber]
   properties:
-    issueId: { type: string, minLength: 1 }
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
     title: { type: string }
     body: { type: string }
   additionalProperties: false
@@ -24,4 +26,17 @@ routing:
   fallbacks: []
 graphql:
   operationName: IssueUpdate
+  operationType: mutation
   documentPath: src/gql/operations/issue-update.graphql
+  resolution:
+    lookup:
+      operationName: IssueNodeIdLookup
+      documentPath: src/gql/operations/issue-node-id-lookup.graphql
+      vars:
+        owner: owner
+        name: name
+        issueNumber: issueNumber
+    inject:
+      - target: issueId
+        source: scalar
+        path: repository.issue.id

package/dist/cards/issue.view.yaml

@@ -11,22 +11,25 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [id, number, title, state, url]
+  required: [id, number, title, state, url, body, labels]
   properties:
     id: { type: string, minLength: 1 }
     number: { type: integer, minimum: 1 }
     title: { type: string }
     state: { type: string }
     url: { type: string, minLength: 1 }
+    body: { type: string }
+    labels: { type: array, items: { type: string } }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: [graphql]
+  preferred: graphql
+  fallbacks: [cli]
   notes:
-    - Prefer CLI for low-latency structured fetches when gh authentication is available.
+    - 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
-  jsonFields: [id, number, title, state, url]
+  jsonFields: [id, number, title, state, url, body, labels]

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

@@ -0,0 +1,33 @@
+capability_id: pr.assignees.add
+version: "1.0.0"
+description: Add assignees to a pull request without replacing existing ones.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, assignees]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    assignees:
+      type: array
+      items: { type: string, minLength: 1 }
+      minItems: 1
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, added]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    added:
+      type: array
+      items: { type: string }
+  additionalProperties: false
+routing:
+  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

@@ -0,0 +1,33 @@
+capability_id: pr.assignees.remove
+version: "1.0.0"
+description: Remove specific assignees from a pull request.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, assignees]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    assignees:
+      type: array
+      items: { type: string, minLength: 1 }
+      minItems: 1
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, removed]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    removed:
+      type: array
+      items: { type: string }
+  additionalProperties: false
+routing:
+  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/{core/registry/cards/pr.status.checks.yaml → cards/pr.checks.list.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.status.checks
+capability_id: pr.checks.list
 version: "1.0.0"
 description: List pull request check statuses with summary counts.
 input_schema:
@@ -8,6 +8,7 @@ input_schema:
     owner: { type: string, minLength: 1 }
     name: { type: string, minLength: 1 }
     prNumber: { type: integer, minimum: 1 }
+    state: { type: string, enum: [failed, pending, passed] }
   additionalProperties: false
 output_schema:
   type: object
@@ -17,12 +18,24 @@ output_schema:
       type: array
       items:
         type: object
-        required: [name, state, workflow, link]
+        required: [name, state, workflow, link, annotations]
         properties:
           name: { type: [string, "null"] }
           state: { type: [string, "null"] }
           workflow: { type: [string, "null"] }
           link: { type: [string, "null"] }
+          annotations:
+            type: array
+            items:
+              type: object
+              required: [path, startLine, endLine, level, message]
+              properties:
+                path: { type: [string, "null"] }
+                startLine: { type: [integer, "null"] }
+                endLine: { type: [integer, "null"] }
+                level: { type: [string, "null"] }
+                message: { type: [string, "null"] }
+              additionalProperties: false
         additionalProperties: false
     summary:
       type: object

package/dist/{core/registry/cards/pr.checks.rerun_all.yaml → cards/pr.checks.rerun.all.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.checks.rerun_all
+capability_id: pr.checks.rerun.all
 version: "1.0.0"
 description: Rerun all pull request workflow checks for a selected run.
 input_schema:
@@ -12,11 +12,9 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [prNumber, runId, mode, queued]
+  required: [runId, queued]
   properties:
-    prNumber: { type: integer, minimum: 1 }
     runId: { type: integer, minimum: 1 }
-    mode: { type: string, const: all }
     queued: { type: boolean }
   additionalProperties: false
 routing:

package/dist/{core/registry/cards/pr.checks.rerun_failed.yaml → cards/pr.checks.rerun.failed.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.checks.rerun_failed
+capability_id: pr.checks.rerun.failed
 version: "1.0.0"
 description: Rerun failed pull request workflow checks for a selected run.
 input_schema:
@@ -12,11 +12,9 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [prNumber, runId, mode, queued]
+  required: [runId, queued]
   properties:
-    prNumber: { type: integer, minimum: 1 }
-    runId: { type: integer, minimum: 1 }
-    mode: { type: string, const: failed }
+    runId: { type: integer }
     queued: { type: boolean }
   additionalProperties: false
 routing:

package/dist/cards/pr.create.yaml

@@ -0,0 +1,34 @@
+capability_id: pr.create
+version: "1.0.0"
+description: Create a pull request.
+input_schema:
+  type: object
+  required: [owner, name, title, head, base]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    title: { type: string, minLength: 1 }
+    body: { type: string }
+    head: { type: string, minLength: 1 }
+    base: { type: string, minLength: 1 }
+    draft: { type: boolean }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [number, url, title, state, draft]
+  properties:
+    number: { type: integer, minimum: 1 }
+    url: { type: string, minLength: 1 }
+    title: { type: string }
+    state: { type: string }
+    draft: { type: boolean }
+  additionalProperties: false
+routing:
+  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.list_files.yaml → pr.diff.files.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.diff.list_files
+capability_id: pr.diff.files
 version: "1.0.0"
 description: List changed files in a pull request diff.
 input_schema:
@@ -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.ready_for_review.set.yaml → pr.diff.view.yaml}

@@ -1,24 +1,22 @@
-capability_id: pr.ready_for_review.set
+capability_id: pr.diff.view
 version: "1.0.0"
-description: Mark pull request as ready for review or draft.
+description: View the unified diff for a pull request.
 input_schema:
   type: object
-  required: [owner, name, prNumber, ready]
+  required: [owner, name, prNumber]
   properties:
     owner: { type: string, minLength: 1 }
     name: { type: string, minLength: 1 }
     prNumber: { type: integer, minimum: 1 }
-    ready: { type: boolean }
   additionalProperties: false
 output_schema:
   type: object
-  required: [prNumber, isDraft]
+  required: [diff]
   properties:
-    prNumber: { type: integer, minimum: 1 }
-    isDraft: { type: boolean }
+    diff: { type: string }
   additionalProperties: false
 routing:
   preferred: cli
   fallbacks: []
 cli:
-  command: pr ready
+  command: pr diff

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/{core/registry/cards/pr.mergeability.view.yaml → cards/pr.merge.status.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.mergeability.view
+capability_id: pr.merge.status
 version: "1.0.0"
 description: View pull request mergeability and readiness signals.
 input_schema:
@@ -20,8 +20,12 @@ output_schema:
     state: { type: string }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrMergeStatus
+  operationType: query
+  documentPath: src/gql/operations/pr-merge-status.graphql
 cli:
   command: pr view
   jsonFields: [mergeable, mergeStateStatus, reviewDecision, isDraft, state]

package/dist/{core/registry/cards/pr.merge.execute.yaml → cards/pr.merge.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.merge.execute
+capability_id: pr.merge
 version: "1.0.0"
 description: Execute a pull request merge.
 input_schema:
@@ -15,15 +15,21 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [prNumber, method, queued, deleteBranch]
+  required: [prNumber, method, isMethodAssumed, queued, deleteBranch]
   properties:
     prNumber: { type: integer, minimum: 1 }
     method: { type: string, enum: [merge, squash, rebase] }
+    isMethodAssumed: { type: boolean, description: "true when method was not specified by the caller and defaults to merge" }
     queued: { type: boolean }
     deleteBranch: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  # GQL limitation: deleteBranch: true unsupported, triggers CLI fallback
+  operationName: PrMerge
+  operationType: mutation
+  documentPath: src/gql/operations/pr-merge.graphql
 cli:
   command: pr merge

package/dist/cards/pr.reviews.list.yaml

@@ -1,6 +1,6 @@
 capability_id: pr.reviews.list
 version: "1.0.0"
-description: List pull request reviews.
+description: "List pull request reviews (state, author, overall review body). Returns review-level metadata only — use pr.threads.list for inline diff comments."
 input_schema:
   type: object
   required: [owner, name, prNumber]
@@ -42,6 +42,7 @@ routing:
   fallbacks: []
 graphql:
   operationName: PrReviewsList
+  operationType: query
   documentPath: src/gql/operations/pr-reviews-list.graphql
 cli:
   command: pr view

package/dist/cards/{pr.reviewers.request.yaml → pr.reviews.request.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.reviewers.request
+capability_id: pr.reviews.request
 version: "1.0.0"
 description: Request pull request reviewers.
 input_schema:
@@ -20,12 +20,15 @@ output_schema:
     prNumber: { type: integer, minimum: 1 }
     reviewers:
       type: array
-      minItems: 1
       items: { type: string, minLength: 1 }
     updated: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: PrReviewsRequest
+  operationType: mutation
+  documentPath: src/gql/operations/pr-reviews-request.graphql
 cli:
   command: pr edit

package/dist/cards/pr.reviews.submit.yaml

@@ -0,0 +1,68 @@
+capability_id: pr.reviews.submit
+version: "1.0.0"
+description: Submit a pull request review (approve, request changes, or comment). GitHub requires a non-empty body for COMMENT and REQUEST_CHANGES events.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, event]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    event:
+      type: string
+      enum: [APPROVE, COMMENT, REQUEST_CHANGES]
+    body:
+      type: string
+      minLength: 1
+      description: "Required when event is COMMENT or REQUEST_CHANGES. Optional for APPROVE."
+    comments:
+      type: array
+      items:
+        type: object
+        required: [path, body, line]
+        properties:
+          path: { type: string, minLength: 1 }
+          body: { type: string, minLength: 1 }
+          line: { type: integer, minimum: 1 }
+          side:
+            type: string
+            enum: [LEFT, RIGHT]
+            description: "Diff side of the comment line (LEFT=base, RIGHT=head). Returned as diffSide in pr.threads.list output."
+          startLine:
+            type: integer
+            minimum: 1
+            description: "First line of a multi-line comment range. Omit for single-line comments."
+          startSide:
+            type: string
+            enum: [LEFT, RIGHT]
+            description: "Diff side of startLine (LEFT=base, RIGHT=head). Required if startLine is set."
+        additionalProperties: false
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, state, url, body]
+  properties:
+    id: { type: [string, "null"] }
+    state: { type: [string, "null"] }
+    url: { type: [string, "null"] }
+    body: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrReviewSubmit
+  operationType: mutation
+  documentPath: src/gql/operations/pr-review-submit.graphql
+  resolution:
+    lookup:
+      operationName: PrNodeId
+      documentPath: src/gql/operations/pr-node-id.graphql
+      vars:
+        owner: owner
+        name: name
+        prNumber: prNumber
+    inject:
+      - target: pullRequestId
+        source: scalar
+        path: repository.pullRequest.id