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

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

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

@@ -0,0 +1,26 @@
+capability_id: project_v2.user.get
+version: "1.0.0"
+description: Get a user Projects v2 project.
+input_schema:
+  type: object
+  required: [user, projectNumber]
+  properties:
+    user: { 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

package/dist/cards/release.create_draft.yaml

@@ -0,0 +1,36 @@
+capability_id: release.create_draft
+version: "1.0.0"
+description: Create a draft release.
+input_schema:
+  type: object
+  required: [owner, name, tagName]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    tagName: { type: string, minLength: 1 }
+    title: { type: string, minLength: 1 }
+    notes: { type: string, minLength: 1 }
+    targetCommitish: { type: string, minLength: 1 }
+    prerelease: { type: boolean }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, tagName, name, isDraft, isPrerelease, url, targetCommitish, createdAt, publishedAt]
+  properties:
+    id: { type: integer, minimum: 0 }
+    tagName: { type: [string, "null"] }
+    name: { type: [string, "null"] }
+    isDraft: { type: boolean }
+    isPrerelease: { type: boolean }
+    url: { type: [string, "null"] }
+    targetCommitish: { type: [string, "null"] }
+    createdAt: { type: [string, "null"] }
+    publishedAt: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+  notes:
+    - Enforces draft=true on creation.
+cli:
+  command: api

package/dist/cards/release.get.yaml

@@ -0,0 +1,30 @@
+capability_id: release.get
+version: "1.0.0"
+description: Get release details by tag name.
+input_schema:
+  type: object
+  required: [owner, name, tagName]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    tagName: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, tagName, name, isDraft, isPrerelease, url, targetCommitish, createdAt, publishedAt]
+  properties:
+    id: { type: integer, minimum: 0 }
+    tagName: { type: [string, "null"] }
+    name: { type: [string, "null"] }
+    isDraft: { type: boolean }
+    isPrerelease: { type: boolean }
+    url: { type: [string, "null"] }
+    targetCommitish: { type: [string, "null"] }
+    createdAt: { type: [string, "null"] }
+    publishedAt: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: api