@ghx-dev/core 0.1.0-beta.0 → 0.1.1

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

@@ -0,0 +1,48 @@
+capability_id: issue.comments.list
+version: "1.0.0"
+description: List comments for one issue.
+input_schema:
+  type: object
+  required: [owner, name, issueNumber, first]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
+    first: { type: integer, minimum: 1 }
+    after: { type: [string, "null"] }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, body, authorLogin, url, createdAt]
+        properties:
+          id: { type: string, minLength: 1 }
+          body: { type: string }
+          authorLogin: { type: [string, "null"] }
+          url: { type: string, minLength: 1 }
+          createdAt: { type: string, minLength: 1 }
+        additionalProperties: false
+    pageInfo:
+      type: object
+      required: [hasNextPage, endCursor]
+      properties:
+        hasNextPage: { type: boolean }
+        endCursor: { type: [string, "null"] }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: [cli]
+  notes:
+    - Prefer GraphQL for typed issue-comment pagination and stable cursor handling.
+    - CLI fallback uses gh api graphql with bounded cursor pagination for comments.
+graphql:
+  operationName: IssueCommentsList
+  documentPath: src/gql/operations/issue-comments-list.graphql
+cli:
+  command: api graphql

package/dist/cards/issue.create.yaml

@@ -0,0 +1,28 @@
+capability_id: issue.create
+version: "1.0.0"
+description: Create a new issue.
+input_schema:
+  type: object
+  required: [owner, name, title]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    title: { type: string, minLength: 1 }
+    body: { type: string }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 1 }
+    title: { type: string }
+    state: { type: string }
+    url: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueCreate
+  documentPath: src/gql/operations/issue-create.graphql

package/dist/cards/issue.delete.yaml

@@ -0,0 +1,23 @@
+capability_id: issue.delete
+version: "1.0.0"
+description: Delete an issue.
+input_schema:
+  type: object
+  required: [issueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number, deleted]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 0 }
+    deleted: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueDelete
+  documentPath: src/gql/operations/issue-delete.graphql

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

@@ -0,0 +1,27 @@
+capability_id: issue.labels.update
+version: "1.0.0"
+description: Replace issue labels.
+input_schema:
+  type: object
+  required: [issueId, labels]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    labels:
+      type: array
+      items: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, labels]
+  properties:
+    id: { type: string, minLength: 1 }
+    labels:
+      type: array
+      items: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueLabelsUpdate
+  documentPath: src/gql/operations/issue-labels-update.graphql

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

@@ -0,0 +1,34 @@
+capability_id: issue.linked_prs.list
+version: "1.0.0"
+description: List pull requests linked to an issue.
+input_schema:
+  type: object
+  required: [owner, name, issueNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, number, title, state, url]
+        properties:
+          id: { type: string, minLength: 1 }
+          number: { type: integer, minimum: 1 }
+          title: { type: string }
+          state: { type: string }
+          url: { type: string }
+        additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueLinkedPrsList
+  documentPath: src/gql/operations/issue-linked-prs-list.graphql

package/dist/cards/issue.list.yaml

@@ -0,0 +1,48 @@
+capability_id: issue.list
+version: "1.0.0"
+description: List repository issues.
+input_schema:
+  type: object
+  required: [owner, name]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    state: { type: string, minLength: 1 }
+    first: { type: integer, minimum: 1 }
+    after: { type: [string, "null"] }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, number, title, state, url]
+        properties:
+          id: { type: string, minLength: 1 }
+          number: { type: integer, minimum: 1 }
+          title: { type: string }
+          state: { type: string }
+          url: { type: string, minLength: 1 }
+        additionalProperties: false
+    pageInfo:
+      type: object
+      required: [hasNextPage, endCursor]
+      properties:
+        hasNextPage: { type: boolean }
+        endCursor: { type: [string, "null"] }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: [graphql]
+  notes:
+    - Prefer CLI for low-latency structured fetches when gh authentication is available.
+graphql:
+  operationName: IssueList
+  documentPath: src/gql/operations/issue-list.graphql
+cli:
+  command: issue list
+  jsonFields: [id, number, title, state, url]

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

@@ -0,0 +1,23 @@
+capability_id: issue.milestone.set
+version: "1.0.0"
+description: Set issue milestone number or clear with null.
+input_schema:
+  type: object
+  required: [issueId, milestoneNumber]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    milestoneNumber: { type: [integer, "null"], minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, milestoneNumber]
+  properties:
+    id: { type: string, minLength: 1 }
+    milestoneNumber: { type: [integer, "null"] }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueMilestoneSet
+  documentPath: src/gql/operations/issue-milestone-set.graphql

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

@@ -0,0 +1,22 @@
+capability_id: issue.parent.remove
+version: "1.0.0"
+description: Remove an issue parent relation.
+input_schema:
+  type: object
+  required: [issueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [issueId, parentRemoved]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    parentRemoved: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueParentRemove
+  documentPath: src/gql/operations/issue-parent-remove.graphql

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

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

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

@@ -0,0 +1,54 @@
+capability_id: issue.relations.get
+version: "1.0.0"
+description: Get issue parent/children/blocking relations.
+input_schema:
+  type: object
+  required: [owner, name, issueNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [issue, parent, children, blockedBy]
+  properties:
+    issue:
+      type: object
+      required: [id, number]
+      properties:
+        id: { type: string, minLength: 1 }
+        number: { type: integer, minimum: 1 }
+      additionalProperties: false
+    parent:
+      type: [object, "null"]
+      required: [id, number]
+      properties:
+        id: { type: string, minLength: 1 }
+        number: { type: integer, minimum: 1 }
+      additionalProperties: false
+    children:
+      type: array
+      items:
+        type: object
+        required: [id, number]
+        properties:
+          id: { type: string, minLength: 1 }
+          number: { type: integer, minimum: 1 }
+        additionalProperties: false
+    blockedBy:
+      type: array
+      items:
+        type: object
+        required: [id, number]
+        properties:
+          id: { type: string, minLength: 1 }
+          number: { type: integer, minimum: 1 }
+        additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueRelationsGet
+  documentPath: src/gql/operations/issue-relations-get.graphql

package/dist/cards/issue.reopen.yaml

@@ -0,0 +1,24 @@
+capability_id: issue.reopen
+version: "1.0.0"
+description: Reopen a closed issue.
+input_schema:
+  type: object
+  required: [issueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number, state, reopened]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 1 }
+    state: { type: string }
+    reopened: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueReopen
+  documentPath: src/gql/operations/issue-reopen.graphql

package/dist/cards/issue.update.yaml

@@ -0,0 +1,27 @@
+capability_id: issue.update
+version: "1.0.0"
+description: Update issue title and/or body.
+input_schema:
+  type: object
+  required: [issueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    title: { type: string }
+    body: { type: string }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 1 }
+    title: { type: string }
+    state: { type: string }
+    url: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueUpdate
+  documentPath: src/gql/operations/issue-update.graphql

package/dist/cards/issue.view.yaml

@@ -0,0 +1,32 @@
+capability_id: issue.view
+version: "1.0.0"
+description: Fetch one issue by number.
+input_schema:
+  type: object
+  required: [owner, name, issueNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    issueNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number, title, state, url]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 1 }
+    title: { type: string }
+    state: { type: string }
+    url: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: [graphql]
+  notes:
+    - Prefer CLI for low-latency structured fetches when gh authentication is available.
+graphql:
+  operationName: IssueView
+  documentPath: src/gql/operations/issue-view.graphql
+cli:
+  command: issue view
+  jsonFields: [id, number, title, state, url]

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

@@ -0,0 +1,38 @@
+capability_id: pr.assignees.update
+version: "1.0.0"
+description: Update pull request assignees.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    add:
+      type: array
+      items: { type: string, minLength: 1 }
+    remove:
+      type: array
+      items: { type: string, minLength: 1 }
+  anyOf:
+    - required: [add]
+    - required: [remove]
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, add, remove, updated]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    add:
+      type: array
+      items: { type: string, minLength: 1 }
+    remove:
+      type: array
+      items: { type: string, minLength: 1 }
+    updated: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr edit

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

@@ -0,0 +1,23 @@
+capability_id: pr.branch.update
+version: "1.0.0"
+description: Update pull request branch with latest base branch changes.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, updated]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    updated: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr update-branch

package/dist/cards/pr.checks.get_failed.yaml

@@ -0,0 +1,42 @@
+capability_id: pr.checks.get_failed
+version: "1.0.0"
+description: List failed pull request checks.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, summary]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [name, state, workflow, link]
+        properties:
+          name: { type: [string, "null"] }
+          state: { type: [string, "null"] }
+          workflow: { type: [string, "null"] }
+          link: { type: [string, "null"] }
+        additionalProperties: false
+    summary:
+      type: object
+      required: [total, failed, pending, passed]
+      properties:
+        total: { type: integer, minimum: 0 }
+        failed: { type: integer, minimum: 0 }
+        pending: { type: integer, minimum: 0 }
+        passed: { type: integer, minimum: 0 }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr checks
+  jsonFields: [name, state, workflow, link]

package/dist/cards/pr.checks.rerun_all.yaml

@@ -0,0 +1,26 @@
+capability_id: pr.checks.rerun_all
+version: "1.0.0"
+description: Rerun all pull request workflow checks for a selected run.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, runId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    runId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, runId, mode, queued]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    runId: { type: integer, minimum: 1 }
+    mode: { type: string, const: all }
+    queued: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: run rerun

package/dist/cards/pr.checks.rerun_failed.yaml

@@ -0,0 +1,26 @@
+capability_id: pr.checks.rerun_failed
+version: "1.0.0"
+description: Rerun failed pull request workflow checks for a selected run.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, runId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    runId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, runId, mode, queued]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    runId: { type: integer, minimum: 1 }
+    mode: { type: string, const: failed }
+    queued: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: run rerun

package/dist/cards/pr.comment.reply.yaml

@@ -0,0 +1,23 @@
+capability_id: pr.comment.reply
+version: "1.0.0"
+description: Reply to a pull request review thread.
+input_schema:
+  type: object
+  required: [threadId, body]
+  properties:
+    threadId: { type: string, minLength: 1 }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, isResolved]
+  properties:
+    id: { type: string, minLength: 1 }
+    isResolved: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrCommentReply
+  documentPath: src/gql/operations/pr-comment-reply.graphql

package/dist/cards/pr.comment.resolve.yaml

@@ -0,0 +1,22 @@
+capability_id: pr.comment.resolve
+version: "1.0.0"
+description: Resolve a pull request review thread.
+input_schema:
+  type: object
+  required: [threadId]
+  properties:
+    threadId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, isResolved]
+  properties:
+    id: { type: string, minLength: 1 }
+    isResolved: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrCommentResolve
+  documentPath: src/gql/operations/pr-comment-resolve.graphql

package/dist/cards/pr.comment.unresolve.yaml

@@ -0,0 +1,22 @@
+capability_id: pr.comment.unresolve
+version: "1.0.0"
+description: Unresolve a pull request review thread.
+input_schema:
+  type: object
+  required: [threadId]
+  properties:
+    threadId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, isResolved]
+  properties:
+    id: { type: string, minLength: 1 }
+    isResolved: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrCommentUnresolve
+  documentPath: src/gql/operations/pr-comment-unresolve.graphql