@ghx-dev/core 0.1.2 → 0.2.1

package/dist/core/registry/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/core/registry/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/core/registry/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.status.checks.yaml → core/registry/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/{cards/pr.checks.rerun_all.yaml → core/registry/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/{cards/pr.checks.rerun_failed.yaml → core/registry/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/core/registry/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/core/registry/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/core/registry/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/core/registry/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.mergeability.view.yaml → core/registry/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/{cards/pr.merge.execute.yaml → core/registry/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/core/registry/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/core/registry/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/core/registry/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

package/dist/core/registry/cards/{pr.comments.list.yaml → pr.threads.list.yaml}

@@ -1,6 +1,6 @@
-capability_id: pr.comments.list
+capability_id: pr.threads.list
 version: "1.0.0"
-description: List pull request review threads with unresolved filtering.
+description: List pull request review threads (unresolved only by default; pass unresolvedOnly:false to include resolved).
 input_schema:
   type: object
   required: [owner, name, prNumber]
@@ -93,6 +93,7 @@ routing:
     - Prefer GraphQL for review-thread semantics and unresolved filtering.
 graphql:
   operationName: PrCommentsList
+  operationType: query
   documentPath: src/gql/operations/pr-comments-list.graphql
 cli:
   command: api graphql

package/dist/core/registry/cards/{pr.comment.reply.yaml → pr.threads.reply.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.comment.reply
+capability_id: pr.threads.reply
 version: "1.0.0"
 description: Reply to a pull request review thread.
 input_schema:
@@ -10,14 +10,17 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [id, isResolved]
+  required: [id, isResolved, commentId, commentUrl]
   properties:
     id: { type: string, minLength: 1 }
     isResolved: { type: boolean }
+    commentId: { type: string }
+    commentUrl: { type: string }
   additionalProperties: false
 routing:
   preferred: graphql
   fallbacks: []
 graphql:
   operationName: PrCommentReply
+  operationType: mutation
   documentPath: src/gql/operations/pr-comment-reply.graphql

package/dist/{cards/pr.comment.resolve.yaml → core/registry/cards/pr.threads.resolve.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.comment.resolve
+capability_id: pr.threads.resolve
 version: "1.0.0"
 description: Resolve a pull request review thread.
 input_schema:
@@ -19,4 +19,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: PrCommentResolve
+  operationType: mutation
   documentPath: src/gql/operations/pr-comment-resolve.graphql

package/dist/core/registry/cards/{pr.comment.unresolve.yaml → pr.threads.unresolve.yaml}

@@ -1,4 +1,4 @@
-capability_id: pr.comment.unresolve
+capability_id: pr.threads.unresolve
 version: "1.0.0"
 description: Unresolve a pull request review thread.
 input_schema:
@@ -19,4 +19,5 @@ routing:
   fallbacks: []
 graphql:
   operationName: PrCommentUnresolve
+  operationType: mutation
   documentPath: src/gql/operations/pr-comment-unresolve.graphql

package/dist/core/registry/cards/pr.update.yaml

@@ -0,0 +1,34 @@
+capability_id: pr.update
+version: "1.0.0"
+description: Update pull request metadata (title, body, draft status).
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    title: { type: string, minLength: 1 }
+    body: { type: string }
+    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:
+  # GQL limitation: draft-only updates fall back to CLI
+  operationName: PrUpdate
+  operationType: mutation
+  documentPath: src/gql/operations/pr-update.graphql
+cli:
+  command: pr edit

package/dist/core/registry/cards/pr.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: PrView
+  operationType: query
   documentPath: src/gql/operations/pr-view.graphql
 cli:
   command: pr view
-  jsonFields: [id, number, title, state, url]
+  jsonFields: [id, number, title, state, url, body, labels]

package/dist/core/registry/cards/project_v2.fields.list.yaml

@@ -7,6 +7,8 @@ input_schema:
   properties:
     owner: { type: string, minLength: 1 }
     projectNumber: { type: integer, minimum: 1 }
+    first: { type: integer, minimum: 1 }
+    after: { type: [string, "null"] }
   additionalProperties: false
 output_schema:
   type: object
@@ -21,6 +23,15 @@ output_schema:
           id: { type: [string, "null"] }
           name: { type: [string, "null"] }
           dataType: { type: [string, "null"] }
+          options:
+            type: [array, "null"]
+            items:
+              type: object
+              required: [id, name]
+              properties:
+                id: { type: string }
+                name: { type: string }
+              additionalProperties: false
         additionalProperties: false
     pageInfo:
       type: object
@@ -31,7 +42,12 @@ output_schema:
       additionalProperties: false
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  # GQL limitation: user fallback handled in domain handler
+  operationName: ProjectV2FieldsListOrg
+  operationType: query
+  documentPath: src/gql/operations/project-v2-fields-list-org.graphql
 cli:
   command: project field-list

package/dist/core/registry/cards/{project_v2.item.field.update.yaml → project_v2.items.field.update.yaml}

@@ -1,4 +1,4 @@
-capability_id: project_v2.item.field.update
+capability_id: project_v2.items.field.update
 version: "1.0.0"
 description: Update a field on a Projects v2 project item.
 input_schema:
@@ -17,13 +17,16 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [itemId, updated]
+  required: [itemId]
   properties:
-    itemId: { type: [string, "null"] }
-    updated: { type: boolean }
+    itemId: { type: string }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: UpdateProjectV2ItemField
+  operationType: mutation
+  documentPath: src/gql/operations/project-v2-item-field-update.graphql
 cli:
   command: project item-edit

package/dist/core/registry/cards/{project_v2.item.add_issue.yaml → project_v2.items.issue.add.yaml}

@@ -1,4 +1,4 @@
-capability_id: project_v2.item.add_issue
+capability_id: project_v2.items.issue.add
 version: "1.0.0"
 description: Add an issue to a Projects v2 project.
 input_schema:
@@ -11,13 +11,17 @@ input_schema:
   additionalProperties: false
 output_schema:
   type: object
-  required: [itemId, added]
+  required: [itemId, itemType]
   properties:
-    itemId: { type: [string, "null"] }
-    added: { type: boolean }
+    itemId: { type: string }
+    itemType: { type: [string, "null"] }
   additionalProperties: false
 routing:
-  preferred: cli
-  fallbacks: []
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: AddProjectV2Item
+  operationType: mutation
+  documentPath: src/gql/operations/project-v2-item-add.graphql
 cli:
   command: project item-add

package/dist/core/registry/cards/project_v2.items.issue.remove.yaml

@@ -0,0 +1,26 @@
+capability_id: project_v2.items.issue.remove
+version: "1.0.0"
+description: Remove an issue from a Projects v2 project.
+input_schema:
+  type: object
+  required: [owner, projectNumber, itemId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    projectNumber: { type: integer, minimum: 1 }
+    itemId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [deletedItemId]
+  properties:
+    deletedItemId: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: [cli]
+graphql:
+  operationName: RemoveProjectV2Item
+  operationType: mutation
+  documentPath: src/gql/operations/project-v2-item-remove.graphql
+cli:
+  command: project item-delete