@ghx-dev/core 0.1.0-beta.0

package/dist/core/execution/adapters/graphql-capability-adapter.d.ts

@@ -0,0 +1,20 @@
+import { GithubClient } from '../../../gql/client.js';
+import { ResultEnvelope } from '../../contracts/envelope.js';
+import 'graphql';
+import '../../../gql/operations/issue-comments-list.generated.js';
+import '../../../gql/generated/common-types.js';
+import 'graphql-request';
+import '../../../gql/operations/issue-list.generated.js';
+import '../../../gql/operations/issue-view.generated.js';
+import '../../../gql/operations/pr-diff-list-files.generated.js';
+import '../../../gql/operations/pr-reviews-list.generated.js';
+import '../../../gql/operations/pr-list.generated.js';
+import '../../../gql/operations/pr-view.generated.js';
+import '../../../gql/operations/repo-view.generated.js';
+import '../../routing/reason-codes.js';
+import '../../errors/codes.js';
+
+type GraphqlCapabilityId = "repo.view" | "issue.view" | "issue.list" | "issue.comments.list" | "pr.view" | "pr.list" | "pr.comments.list" | "pr.reviews.list" | "pr.diff.list_files" | "pr.comment.reply" | "pr.comment.resolve" | "pr.comment.unresolve";
+declare function runGraphqlCapability(client: Pick<GithubClient, "fetchRepoView" | "fetchIssueView" | "fetchIssueList" | "fetchIssueCommentsList" | "fetchPrView" | "fetchPrList" | "fetchPrCommentsList" | "fetchPrReviewsList" | "fetchPrDiffListFiles" | "replyToReviewThread" | "resolveReviewThread" | "unresolveReviewThread">, capabilityId: GraphqlCapabilityId, params: Record<string, unknown>): Promise<ResultEnvelope>;
+
+export { type GraphqlCapabilityId, runGraphqlCapability };

package/dist/core/execution/adapters/graphql-capability-adapter.js

@@ -0,0 +1,11 @@
+import {
+  runGraphqlCapability
+} from "../../../chunk-YNNDBMNR.js";
+import "../../../chunk-QEAMC4IJ.js";
+import "../../../chunk-B6RLMKS4.js";
+import "../../../chunk-573MDG3I.js";
+import "../../../chunk-UOJWOHRM.js";
+export {
+  runGraphqlCapability
+};
+//# sourceMappingURL=graphql-capability-adapter.js.map

package/dist/core/execution/adapters/graphql-capability-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/execution/adapters/rest-adapter.d.ts

@@ -0,0 +1,3 @@
+declare function runRestAdapter(): Promise<unknown>;
+
+export { runRestAdapter };

package/dist/core/execution/adapters/rest-adapter.js

@@ -0,0 +1,8 @@
+// src/core/execution/adapters/rest-adapter.ts
+async function runRestAdapter() {
+  throw new Error("runRestAdapter is not implemented yet");
+}
+export {
+  runRestAdapter
+};
+//# sourceMappingURL=rest-adapter.js.map

package/dist/core/execution/adapters/rest-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/execution/adapters/rest-adapter.ts"],"sourcesContent":["export async function runRestAdapter(): Promise<unknown> {\n  throw new Error(\"runRestAdapter is not implemented yet\")\n}\n"],"mappings":";AAAA,eAAsB,iBAAmC;AACvD,QAAM,IAAI,MAAM,uCAAuC;AACzD;","names":[]}

package/dist/core/execution/cli/safe-runner.d.ts

@@ -0,0 +1,12 @@
+import { CliCommandRunner } from '../adapters/cli-capability-adapter.js';
+import '../../contracts/envelope.js';
+import '../../routing/reason-codes.js';
+import '../../errors/codes.js';
+import '../../registry/types.js';
+
+type SafeRunnerOptions = {
+    maxOutputBytes?: number;
+};
+declare function createSafeCliCommandRunner(options?: SafeRunnerOptions): CliCommandRunner;
+
+export { createSafeCliCommandRunner };

package/dist/core/execution/cli/safe-runner.js

@@ -0,0 +1,7 @@
+import {
+  createSafeCliCommandRunner
+} from "../../../chunk-DLKIQBK6.js";
+export {
+  createSafeCliCommandRunner
+};
+//# sourceMappingURL=safe-runner.js.map

package/dist/core/execution/cli/safe-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/execution/normalizer.d.ts

@@ -0,0 +1,13 @@
+import { ResultEnvelope } from '../contracts/envelope.js';
+import { RouteReasonCode } from '../routing/reason-codes.js';
+import '../errors/codes.js';
+
+type MetaInput = {
+    capabilityId: string;
+    reason: RouteReasonCode | undefined;
+    pagination?: ResultEnvelope["meta"]["pagination"];
+};
+declare function normalizeResult<TData>(data: TData, route: "cli" | "rest" | "graphql", options: MetaInput): ResultEnvelope<TData>;
+declare function normalizeError<TData = unknown>(error: NonNullable<ResultEnvelope["error"]>, route: "cli" | "rest" | "graphql", options: MetaInput): ResultEnvelope<TData>;
+
+export { normalizeError, normalizeResult };

package/dist/core/execution/normalizer.js

@@ -0,0 +1,9 @@
+import {
+  normalizeError,
+  normalizeResult
+} from "../../chunk-QEAMC4IJ.js";
+export {
+  normalizeError,
+  normalizeResult
+};
+//# sourceMappingURL=normalizer.js.map

package/dist/core/execution/normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/execution/preflight.d.ts

@@ -0,0 +1,24 @@
+import { RouteSource } from '../contracts/envelope.js';
+import { ErrorCode } from '../errors/codes.js';
+import '../routing/reason-codes.js';
+
+type PreflightInput = {
+    route: RouteSource;
+    githubToken?: string | null;
+    ghCliAvailable?: boolean;
+    ghAuthenticated?: boolean;
+};
+type PreflightResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: ErrorCode;
+    message: string;
+    retryable: boolean;
+    details: {
+        route: RouteSource;
+    };
+};
+declare function preflightCheck(input: PreflightInput): PreflightResult;
+
+export { type PreflightInput, type PreflightResult, preflightCheck };

package/dist/core/execution/preflight.js

@@ -0,0 +1,8 @@
+import {
+  preflightCheck
+} from "../../chunk-TDTKOJKN.js";
+import "../../chunk-UOJWOHRM.js";
+export {
+  preflightCheck
+};
+//# sourceMappingURL=preflight.js.map

package/dist/core/execution/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/registry/cards/check_run.annotations.list.yaml

@@ -0,0 +1,35 @@
+capability_id: check_run.annotations.list
+version: "1.0.0"
+description: List annotations for one check run.
+input_schema:
+  type: object
+  required: [owner, name, checkRunId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    checkRunId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [path, startLine, endLine, level, message, title, details]
+        properties:
+          path: { type: [string, "null"] }
+          startLine: { type: [integer, "null"] }
+          endLine: { type: [integer, "null"] }
+          level: { type: [string, "null"] }
+          message: { type: [string, "null"] }
+          title: { type: [string, "null"] }
+          details: { type: [string, "null"] }
+        additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: api

package/dist/core/registry/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/core/registry/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/core/registry/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/core/registry/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/core/registry/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/core/registry/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/core/registry/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

package/dist/core/registry/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/core/registry/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/core/registry/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/core/registry/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/core/registry/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