@ghx-dev/core 0.1.0-beta.0

package/dist/core/registry/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/core/registry/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/core/registry/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/core/registry/cards/repo.view.yaml

@@ -0,0 +1,34 @@
+capability_id: repo.view
+version: "1.0.0"
+description: Fetch repository metadata.
+input_schema:
+  type: object
+  required: [owner, name]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, name, nameWithOwner, isPrivate, url, defaultBranch]
+  properties:
+    id: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    nameWithOwner: { type: string, minLength: 1 }
+    isPrivate: { type: boolean }
+    stargazerCount: { type: integer, minimum: 0 }
+    forkCount: { type: integer, minimum: 0 }
+    url: { type: string, minLength: 1 }
+    defaultBranch: { type: [string, "null"] }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: [graphql]
+  notes:
+    - Prefer CLI for low-latency structured fetches when gh authentication is available.
+graphql:
+  operationName: RepoView
+  documentPath: src/gql/operations/repo-view.graphql
+cli:
+  command: repo view
+  jsonFields: [id, name, nameWithOwner, isPrivate, stargazerCount, forkCount, url, defaultBranchRef]

package/dist/core/registry/cards/workflow_job.logs.analyze.yaml

@@ -0,0 +1,33 @@
+capability_id: workflow_job.logs.analyze
+version: "1.0.0"
+description: Fetch and analyze workflow job logs.
+input_schema:
+  type: object
+  required: [owner, name, jobId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    jobId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [jobId, truncated, summary]
+  properties:
+    jobId: { type: integer, minimum: 1 }
+    truncated: { type: boolean }
+    summary:
+      type: object
+      required: [errorCount, warningCount, topErrorLines]
+      properties:
+        errorCount: { type: integer, minimum: 0 }
+        warningCount: { type: integer, minimum: 0 }
+        topErrorLines:
+          type: array
+          items: { type: string }
+      additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: run view

package/dist/core/registry/cards/workflow_job.logs.get.yaml

@@ -0,0 +1,24 @@
+capability_id: workflow_job.logs.get
+version: "1.0.0"
+description: Fetch logs for a workflow job.
+input_schema:
+  type: object
+  required: [owner, name, jobId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    jobId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [jobId, log, truncated]
+  properties:
+    jobId: { type: integer, minimum: 1 }
+    log: { type: string }
+    truncated: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: run view

package/dist/core/registry/cards/workflow_run.jobs.list.yaml

@@ -0,0 +1,35 @@
+capability_id: workflow_run.jobs.list
+version: "1.0.0"
+description: List jobs in a workflow run.
+input_schema:
+  type: object
+  required: [owner, name, runId]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    runId: { type: integer, minimum: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, name, status, conclusion, startedAt, completedAt, url]
+        properties:
+          id: { type: integer, minimum: 0 }
+          name: { type: [string, "null"] }
+          status: { type: [string, "null"] }
+          conclusion: { type: [string, "null"] }
+          startedAt: { type: [string, "null"] }
+          completedAt: { type: [string, "null"] }
+          url: { type: [string, "null"] }
+        additionalProperties: false
+  additionalProperties: false
+routing:
+  preferred: cli
+  fallbacks: []
+cli:
+  command: run view

package/dist/core/registry/cards/workflow_runs.list.yaml

@@ -0,0 +1,45 @@
+capability_id: workflow_runs.list
+version: "1.0.0"
+description: List workflow runs for a repository.
+input_schema:
+  type: object
+  required: [owner, name]
+  properties:
+    owner: { type: string, minLength: 1 }
+    name: { type: string, minLength: 1 }
+    first: { type: integer, minimum: 1 }
+    branch: { type: string, minLength: 1 }
+    event: { type: string, minLength: 1 }
+    status: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [items, pageInfo]
+  properties:
+    items:
+      type: array
+      items:
+        type: object
+        required: [id, workflowName, status, conclusion, headBranch, url]
+        properties:
+          id: { type: integer, minimum: 0 }
+          workflowName: { type: [string, "null"] }
+          status: { type: [string, "null"] }
+          conclusion: { type: [string, "null"] }
+          headBranch: { type: [string, "null"] }
+          url: { 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: cli
+  fallbacks: []
+cli:
+  command: run list
+  jsonFields: [databaseId,workflowName,status,conclusion,headBranch,url]

package/dist/core/registry/index.d.ts

@@ -0,0 +1,15 @@
+import { OperationCard } from './types.js';
+import '../contracts/envelope.js';
+import '../routing/reason-codes.js';
+import '../errors/codes.js';
+
+declare function validateOperationCard(card: unknown): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+declare function listOperationCards(): OperationCard[];
+declare function getOperationCard(capabilityId: string): OperationCard | undefined;
+
+export { getOperationCard, listOperationCards, validateOperationCard };

package/dist/core/registry/index.js

@@ -0,0 +1,12 @@
+import {
+  getOperationCard,
+  listOperationCards,
+  validateOperationCard
+} from "../../chunk-MT4U5DYD.js";
+import "../../chunk-2W4L5YCC.js";
+export {
+  getOperationCard,
+  listOperationCards,
+  validateOperationCard
+};
+//# sourceMappingURL=index.js.map

package/dist/core/registry/index.js.map

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

package/dist/core/registry/operation-card-schema.d.ts

@@ -0,0 +1,167 @@
+declare const operationCardSchema: {
+    readonly $id: "https://ghx.local/schemas/operation-card.json";
+    readonly type: "object";
+    readonly required: readonly ["capability_id", "version", "description", "input_schema", "output_schema", "routing"];
+    readonly properties: {
+        readonly capability_id: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly input_schema: {
+            readonly type: "object";
+        };
+        readonly output_schema: {
+            readonly type: "object";
+        };
+        readonly routing: {
+            readonly type: "object";
+            readonly required: readonly ["preferred", "fallbacks"];
+            readonly properties: {
+                readonly preferred: {
+                    readonly enum: readonly ["cli", "graphql", "rest"];
+                };
+                readonly fallbacks: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly enum: readonly ["cli", "graphql", "rest"];
+                    };
+                };
+                readonly suitability: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["when", "predicate", "reason"];
+                        readonly properties: {
+                            readonly when: {
+                                readonly enum: readonly ["always", "env", "params"];
+                            };
+                            readonly predicate: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+                readonly notes: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly graphql: {
+            readonly type: "object";
+            readonly required: readonly ["operationName", "documentPath"];
+            readonly properties: {
+                readonly operationName: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly documentPath: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly variables: {
+                    readonly type: "object";
+                };
+                readonly limits: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly maxPageSize: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly cli: {
+            readonly type: "object";
+            readonly required: readonly ["command"];
+            readonly properties: {
+                readonly command: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly jsonFields: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly jq: {
+                    readonly type: "string";
+                };
+                readonly limits: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly maxItemsPerCall: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly rest: {
+            readonly type: "object";
+            readonly required: readonly ["endpoints"];
+            readonly properties: {
+                readonly endpoints: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["method", "path"];
+                        readonly properties: {
+                            readonly method: {
+                                readonly type: "string";
+                            };
+                            readonly path: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly examples: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["title", "input"];
+                readonly properties: {
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly input: {
+                        readonly type: "object";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+
+export { operationCardSchema };

package/dist/core/registry/operation-card-schema.js

@@ -0,0 +1,7 @@
+import {
+  operationCardSchema
+} from "../../chunk-2W4L5YCC.js";
+export {
+  operationCardSchema
+};
+//# sourceMappingURL=operation-card-schema.js.map

package/dist/core/registry/operation-card-schema.js.map

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

package/dist/core/registry/schema-validator.d.ts

@@ -0,0 +1,16 @@
+type SchemaValidationError = {
+    instancePath: string;
+    message: string;
+    keyword: string;
+    params: Record<string, unknown>;
+};
+type SchemaValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: SchemaValidationError[];
+};
+declare function validateInput(inputSchema: Record<string, unknown>, params: Record<string, unknown>): SchemaValidationResult;
+declare function validateOutput(outputSchema: Record<string, unknown>, data: unknown): SchemaValidationResult;
+
+export { validateInput, validateOutput };

package/dist/core/registry/schema-validator.js

@@ -0,0 +1,9 @@
+import {
+  validateInput,
+  validateOutput
+} from "../../chunk-5JRLVOF2.js";
+export {
+  validateInput,
+  validateOutput
+};
+//# sourceMappingURL=schema-validator.js.map

package/dist/core/registry/schema-validator.js.map

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

package/dist/core/registry/types.d.ts

@@ -0,0 +1,51 @@
+import { RouteSource } from '../contracts/envelope.js';
+import '../routing/reason-codes.js';
+import '../errors/codes.js';
+
+type JsonSchema = Record<string, unknown>;
+interface SuitabilityRule {
+    when: "always" | "env" | "params";
+    predicate: string;
+    reason: string;
+}
+interface OperationCard<Input = Record<string, unknown>> {
+    capability_id: string;
+    version: string;
+    description: string;
+    input_schema: JsonSchema;
+    output_schema: JsonSchema;
+    routing: {
+        preferred: RouteSource;
+        fallbacks: RouteSource[];
+        suitability?: SuitabilityRule[];
+        notes?: string[];
+    };
+    graphql?: {
+        operationName: string;
+        documentPath: string;
+        variables?: Record<string, string>;
+        limits?: {
+            maxPageSize?: number;
+        };
+    };
+    cli?: {
+        command: string;
+        jsonFields?: string[];
+        jq?: string;
+        limits?: {
+            maxItemsPerCall?: number;
+        };
+    };
+    rest?: {
+        endpoints: Array<{
+            method: string;
+            path: string;
+        }>;
+    };
+    examples?: Array<{
+        title: string;
+        input: Input;
+    }>;
+}
+
+export type { JsonSchema, OperationCard, SuitabilityRule };

package/dist/core/registry/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/core/registry/types.js.map

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

package/dist/core/routing/capability-registry.d.ts

@@ -0,0 +1,8 @@
+interface CapabilityEntry {
+    task: string;
+    defaultRoute: "cli" | "rest" | "graphql";
+    fallbackRoutes: Array<"cli" | "rest" | "graphql">;
+}
+declare const capabilityRegistry: CapabilityEntry[];
+
+export { type CapabilityEntry, capabilityRegistry };

package/dist/core/routing/capability-registry.js

@@ -0,0 +1,15 @@
+import {
+  listOperationCards
+} from "../../chunk-MT4U5DYD.js";
+import "../../chunk-2W4L5YCC.js";
+
+// src/core/routing/capability-registry.ts
+var capabilityRegistry = listOperationCards().map((card) => ({
+  task: card.capability_id,
+  defaultRoute: card.routing.preferred,
+  fallbackRoutes: [...card.routing.fallbacks]
+}));
+export {
+  capabilityRegistry
+};
+//# sourceMappingURL=capability-registry.js.map

package/dist/core/routing/capability-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/routing/capability-registry.ts"],"sourcesContent":["import { listOperationCards } from \"../registry/index.js\"\n\nexport interface CapabilityEntry {\n  task: string\n  defaultRoute: \"cli\" | \"rest\" | \"graphql\"\n  fallbackRoutes: Array<\"cli\" | \"rest\" | \"graphql\">\n}\n\nexport const capabilityRegistry: CapabilityEntry[] = listOperationCards().map((card) => ({\n  task: card.capability_id,\n  defaultRoute: card.routing.preferred,\n  fallbackRoutes: [...card.routing.fallbacks]\n}))\n"],"mappings":";;;;;;AAQO,IAAM,qBAAwC,mBAAmB,EAAE,IAAI,CAAC,UAAU;AAAA,EACvF,MAAM,KAAK;AAAA,EACX,cAAc,KAAK,QAAQ;AAAA,EAC3B,gBAAgB,CAAC,GAAG,KAAK,QAAQ,SAAS;AAC5C,EAAE;","names":[]}

package/dist/core/routing/engine.d.ts

@@ -0,0 +1,32 @@
+import { routePreferenceOrder } from './policy.js';
+import { ResultEnvelope } from '../contracts/envelope.js';
+import { TaskRequest } from '../contracts/task.js';
+import { GithubClient } from '../../gql/client.js';
+import { RouteReasonCode } from './reason-codes.js';
+import { CliCommandRunner } from '../execution/adapters/cli-capability-adapter.js';
+import '../errors/codes.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 '../registry/types.js';
+
+declare function chooseRoute(): (typeof routePreferenceOrder)[number];
+type ExecutionDeps = {
+    githubClient: Pick<GithubClient, "fetchRepoView" | "fetchIssueCommentsList" | "fetchIssueList" | "fetchIssueView" | "fetchPrList" | "fetchPrView" | "fetchPrCommentsList" | "fetchPrReviewsList" | "fetchPrDiffListFiles" | "replyToReviewThread" | "resolveReviewThread" | "unresolveReviewThread">;
+    githubToken?: string | null;
+    cliRunner?: CliCommandRunner;
+    ghCliAvailable?: boolean;
+    ghAuthenticated?: boolean;
+    reason?: RouteReasonCode;
+};
+declare function executeTask(request: TaskRequest, deps: ExecutionDeps): Promise<ResultEnvelope>;
+
+export { chooseRoute, executeTask };