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

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

@@ -0,0 +1,98 @@
+capability_id: pr.comments.list
+version: "1.0.0"
+description: List pull request review threads with unresolved filtering.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    first: { type: integer, minimum: 1 }
+    after: { type: [string, "null"] }
+    unresolvedOnly: { type: boolean }
+    includeOutdated: { type: boolean }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required:
+          [
+            id,
+            path,
+            line,
+            startLine,
+            diffSide,
+            subjectType,
+            isResolved,
+            isOutdated,
+            viewerCanReply,
+            viewerCanResolve,
+            viewerCanUnresolve,
+            resolvedByLogin,
+            comments
+          ]
+        properties:
+          id: { type: string, minLength: 1 }
+          path: { type: [string, "null"] }
+          line: { type: [integer, "null"] }
+          startLine: { type: [integer, "null"] }
+          diffSide: { type: [string, "null"] }
+          subjectType: { type: [string, "null"] }
+          isResolved: { type: boolean }
+          isOutdated: { type: boolean }
+          viewerCanReply: { type: boolean }
+          viewerCanResolve: { type: boolean }
+          viewerCanUnresolve: { type: boolean }
+          resolvedByLogin: { type: [string, "null"] }
+          comments:
+            type: array
+            items:
+              type: object
+              required: [id, authorLogin, body, createdAt, url]
+              properties:
+                id: { type: string, minLength: 1 }
+                authorLogin: { type: [string, "null"] }
+                body: { type: string }
+                createdAt: { type: string, minLength: 1 }
+                url: { type: string, minLength: 1 }
+              additionalProperties: false
+        additionalProperties: false
+    pageInfo:
+      type: object
+      required: [hasNextPage, endCursor]
+      properties:
+        hasNextPage: { type: boolean }
+        endCursor: { type: [string, "null"] }
+      additionalProperties: false
+    filterApplied:
+      type: object
+      required: [unresolvedOnly, includeOutdated]
+      properties:
+        unresolvedOnly: { type: boolean }
+        includeOutdated: { type: boolean }
+      additionalProperties: false
+    scan:
+      type: object
+      required: [pagesScanned, sourceItemsScanned, scanTruncated]
+      properties:
+        pagesScanned: { type: integer, minimum: 0 }
+        sourceItemsScanned: { type: integer, minimum: 0 }
+        scanTruncated: { type: boolean }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+  notes:
+    - Prefer GraphQL for review-thread semantics and unresolved filtering.
+graphql:
+  operationName: PrCommentsList
+  documentPath: src/gql/operations/pr-comments-list.graphql
+cli:
+  command: api graphql

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

@@ -0,0 +1,43 @@
+capability_id: pr.diff.list_files
+version: "1.0.0"
+description: List changed files in a pull request diff.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { 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: [path, additions, deletions]
+        properties:
+          path: { type: string, minLength: 1 }
+          additions: { type: integer, minimum: 0 }
+          deletions: { type: integer, minimum: 0 }
+        additionalProperties: false
+    pageInfo:
+      type: object
+      required: [hasNextPage, endCursor]
+      properties:
+        hasNextPage: { type: boolean }
+        endCursor: { type: [string, "null"] }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrDiffListFiles
+  documentPath: src/gql/operations/pr-diff-list-files.graphql
+cli:
+  command: pr view

package/dist/cards/pr.list.yaml

@@ -0,0 +1,48 @@
+capability_id: pr.list
+version: "1.0.0"
+description: List repository pull requests.
+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: PrList
+  documentPath: src/gql/operations/pr-list.graphql
+cli:
+  command: pr list
+  jsonFields: [id, number, title, state, url]

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

@@ -0,0 +1,29 @@
+capability_id: pr.merge.execute
+version: "1.0.0"
+description: Execute a pull request merge.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    method:
+      type: string
+      enum: [merge, squash, rebase]
+    deleteBranch: { type: boolean }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, method, queued, deleteBranch]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    method: { type: string, enum: [merge, squash, rebase] }
+    queued: { type: boolean }
+    deleteBranch: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr merge

package/dist/cards/pr.mergeability.view.yaml

@@ -0,0 +1,27 @@
+capability_id: pr.mergeability.view
+version: "1.0.0"
+description: View pull request mergeability and readiness signals.
+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: [mergeable, mergeStateStatus, reviewDecision, isDraft, state]
+  properties:
+    mergeable: { type: [string, "null"] }
+    mergeStateStatus: { type: [string, "null"] }
+    reviewDecision: { type: [string, "null"] }
+    isDraft: { type: boolean }
+    state: { type: string }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr view
+  jsonFields: [mergeable, mergeStateStatus, reviewDecision, isDraft, state]

package/dist/cards/pr.ready_for_review.set.yaml

@@ -0,0 +1,24 @@
+capability_id: pr.ready_for_review.set
+version: "1.0.0"
+description: Mark pull request as ready for review or draft.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, ready]
+  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]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    isDraft: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr ready

package/dist/cards/pr.review.submit_approve.yaml

@@ -0,0 +1,26 @@
+capability_id: pr.review.submit_approve
+version: "1.0.0"
+description: Submit an approving pull request review.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, event, submitted, body]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    event: { type: string, const: APPROVE }
+    submitted: { type: boolean }
+    body: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr review

package/dist/cards/pr.review.submit_comment.yaml

@@ -0,0 +1,26 @@
+capability_id: pr.review.submit_comment
+version: "1.0.0"
+description: Submit a comment-only pull request review.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, body]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, event, submitted, body]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    event: { type: string, const: COMMENT }
+    submitted: { type: boolean }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr review

package/dist/cards/pr.review.submit_request_changes.yaml

@@ -0,0 +1,26 @@
+capability_id: pr.review.submit_request_changes
+version: "1.0.0"
+description: Submit a pull request review requesting changes.
+input_schema:
+  type: object
+  required: [owner, name, prNumber, body]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { type: integer, minimum: 1 }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [prNumber, event, submitted, body]
+  properties:
+    prNumber: { type: integer, minimum: 1 }
+    event: { type: string, const: REQUEST_CHANGES }
+    submitted: { type: boolean }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: pr review

package/dist/cards/pr.reviewers.request.yaml

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

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

@@ -0,0 +1,47 @@
+capability_id: pr.reviews.list
+version: "1.0.0"
+description: List pull request reviews.
+input_schema:
+  type: object
+  required: [owner, name, prNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    prNumber: { 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, authorLogin, body, state, submittedAt, url, commitOid]
+        properties:
+          id: { type: string, minLength: 1 }
+          authorLogin: { type: [string, "null"] }
+          body: { type: string }
+          state: { type: string }
+          submittedAt: { type: [string, "null"] }
+          url: { type: string, minLength: 1 }
+          commitOid: { type: [string, "null"] }
+        additionalProperties: false
+    pageInfo:
+      type: object
+      required: [hasNextPage, endCursor]
+      properties:
+        hasNextPage: { type: boolean }
+        endCursor: { type: [string, "null"] }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: PrReviewsList
+  documentPath: src/gql/operations/pr-reviews-list.graphql
+cli:
+  command: pr view

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

@@ -0,0 +1,42 @@
+capability_id: pr.status.checks
+version: "1.0.0"
+description: List pull request check statuses with summary counts.
+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.view.yaml

@@ -0,0 +1,32 @@
+capability_id: pr.view
+version: "1.0.0"
+description: Fetch one pull request by number.
+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: [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: PrView
+  documentPath: src/gql/operations/pr-view.graphql
+cli:
+  command: pr view
+  jsonFields: [id, number, title, state, url]

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

@@ -0,0 +1,37 @@
+capability_id: project_v2.fields.list
+version: "1.0.0"
+description: List fields for a Projects v2 project.
+input_schema:
+  type: object
+  required: [owner, projectNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    projectNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, name, dataType]
+        properties:
+          id: { type: [string, "null"] }
+          name: { type: [string, "null"] }
+          dataType: { type: [string, "null"] }
+        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]
+cli:
+  command: project field-list

package/dist/cards/project_v2.item.add_issue.yaml

@@ -0,0 +1,23 @@
+capability_id: project_v2.item.add_issue
+version: "1.0.0"
+description: Add an issue to a Projects v2 project.
+input_schema:
+  type: object
+  required: [owner, projectNumber, issueUrl]
+  properties:
+    owner: { type: string, minLength: 1 }
+    projectNumber: { type: integer, minimum: 1 }
+    issueUrl: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [itemId, added]
+  properties:
+    itemId: { type: [string, "null"] }
+    added: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: [cli]
+cli:
+  command: project item-add

package/dist/cards/project_v2.item.field.update.yaml

@@ -0,0 +1,29 @@
+capability_id: project_v2.item.field.update
+version: "1.0.0"
+description: Update a field on a Projects v2 project item.
+input_schema:
+  type: object
+  required: [projectId, itemId, fieldId]
+  properties:
+    projectId: { type: string, minLength: 1 }
+    itemId: { type: string, minLength: 1 }
+    fieldId: { type: string, minLength: 1 }
+    valueText: { type: string, minLength: 1 }
+    valueNumber: { type: number }
+    valueDate: { type: string, minLength: 1 }
+    valueSingleSelectOptionId: { type: string, minLength: 1 }
+    valueIterationId: { type: string, minLength: 1 }
+    clear: { type: boolean }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [itemId, updated]
+  properties:
+    itemId: { type: [string, "null"] }
+    updated: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: [cli]
+cli:
+  command: project item-edit

package/dist/cards/project_v2.items.list.yaml

@@ -0,0 +1,39 @@
+capability_id: project_v2.items.list
+version: "1.0.0"
+description: List items in a Projects v2 project.
+input_schema:
+  type: object
+  required: [owner, projectNumber]
+  properties:
+    owner: { type: string, minLength: 1 }
+    projectNumber: { type: integer, minimum: 1 }
+    first: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, contentType, contentNumber, contentTitle]
+        properties:
+          id: { type: [string, "null"] }
+          contentType: { type: [string, "null"] }
+          contentNumber: { type: [integer, "null"], minimum: 0 }
+          contentTitle: { type: [string, "null"] }
+        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]
+cli:
+  command: project item-list

package/dist/cards/project_v2.org.get.yaml

@@ -0,0 +1,26 @@
+capability_id: project_v2.org.get
+version: "1.0.0"
+description: Get an organization Projects v2 project.
+input_schema:
+  type: object
+  required: [org, projectNumber]
+  properties:
+    org: { type: string, minLength: 1 }
+    projectNumber: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, title, shortDescription, public, closed, url]
+  properties:
+    id: { type: [string, "null"] }
+    title: { type: [string, "null"] }
+    shortDescription: { type: [string, "null"] }
+    public: { type: [boolean, "null"] }
+    closed: { type: [boolean, "null"] }
+    url: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: [cli]
+cli:
+  command: project view