@ghx-dev/core 0.1.2 → 0.2.1

package/dist/release-33236BBA.js

@@ -0,0 +1,57 @@
+import {
+  getSdk,
+  getSdk2
+} from "./chunk-GQO6BHJV.js";
+import "./chunk-R3CBGJZX.js";
+import {
+  assertReleaseViewInput,
+  assertRepoAndPaginationInput
+} from "./chunk-OQWLEFAH.js";
+import {
+  createGraphqlRequestClient
+} from "./chunk-HEHONZTO.js";
+
+// src/gql/domains/release.ts
+function mapReleaseNode(r) {
+  return {
+    id: r.databaseId ?? null,
+    tagName: r.tagName,
+    name: r.name ?? null,
+    isDraft: r.isDraft,
+    isPrerelease: r.isPrerelease,
+    url: r.url != null ? String(r.url) : null,
+    targetCommitish: r.tagCommit?.oid != null ? String(r.tagCommit.oid) : null,
+    createdAt: r.createdAt != null ? String(r.createdAt) : null,
+    publishedAt: r.publishedAt != null ? String(r.publishedAt) : null
+  };
+}
+async function runReleaseView(transport, input) {
+  assertReleaseViewInput(input);
+  const sdk = getSdk2(createGraphqlRequestClient(transport));
+  const result = await sdk.ReleaseView(input);
+  if (!result.repository?.release) {
+    throw new Error("Release not found");
+  }
+  return mapReleaseNode(result.repository.release);
+}
+async function runReleaseList(transport, input) {
+  assertRepoAndPaginationInput(input);
+  const sdk = getSdk(createGraphqlRequestClient(transport));
+  const result = await sdk.ReleaseList(input);
+  if (!result.repository) {
+    throw new Error(`Repository ${input.owner}/${input.name} not found`);
+  }
+  const conn = result.repository.releases;
+  return {
+    items: (conn?.nodes ?? []).flatMap((n) => n ? [mapReleaseNode(n)] : []),
+    pageInfo: {
+      hasNextPage: conn?.pageInfo.hasNextPage ?? false,
+      endCursor: conn?.pageInfo.endCursor ?? null
+    }
+  };
+}
+export {
+  runReleaseList,
+  runReleaseView
+};
+//# sourceMappingURL=release-33236BBA.js.map

package/dist/release-33236BBA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gql/domains/release.ts"],"sourcesContent":["import { assertReleaseViewInput, assertRepoAndPaginationInput } from \"../assertions.js\"\nimport type { ReleaseListQuery } from \"../operations/release-list.generated.js\"\nimport { getSdk as getReleaseListSdk } from \"../operations/release-list.generated.js\"\nimport type { ReleaseViewQuery } from \"../operations/release-view.generated.js\"\nimport { getSdk as getReleaseViewSdk } from \"../operations/release-view.generated.js\"\nimport type { GraphqlTransport } from \"../transport.js\"\nimport { createGraphqlRequestClient } from \"../transport.js\"\nimport type {\n  ReleaseItemData,\n  ReleaseListData,\n  ReleaseListInput,\n  ReleaseViewData,\n  ReleaseViewInput,\n} from \"../types.js\"\n\ntype ReleaseNode = {\n  databaseId?: number | null\n  tagName: string\n  name?: string | null\n  isDraft: boolean\n  isPrerelease: boolean\n  url: unknown\n  createdAt: unknown\n  publishedAt?: unknown\n  tagCommit?: { oid: unknown } | null\n}\n\nfunction mapReleaseNode(r: ReleaseNode): ReleaseItemData {\n  return {\n    id: r.databaseId ?? null,\n    tagName: r.tagName,\n    name: r.name ?? null,\n    isDraft: r.isDraft,\n    isPrerelease: r.isPrerelease,\n    url: r.url != null ? String(r.url) : null,\n    targetCommitish: r.tagCommit?.oid != null ? String(r.tagCommit.oid) : null,\n    createdAt: r.createdAt != null ? String(r.createdAt) : null,\n    publishedAt: r.publishedAt != null ? String(r.publishedAt) : null,\n  }\n}\n\nexport async function runReleaseView(\n  transport: GraphqlTransport,\n  input: ReleaseViewInput,\n): Promise<ReleaseViewData> {\n  assertReleaseViewInput(input)\n  const sdk = getReleaseViewSdk(createGraphqlRequestClient(transport))\n  const result: ReleaseViewQuery = await sdk.ReleaseView(input)\n  if (!result.repository?.release) {\n    throw new Error(\"Release not found\")\n  }\n  return mapReleaseNode(result.repository.release)\n}\n\nexport async function runReleaseList(\n  transport: GraphqlTransport,\n  input: ReleaseListInput,\n): Promise<ReleaseListData> {\n  assertRepoAndPaginationInput(input)\n  const sdk = getReleaseListSdk(createGraphqlRequestClient(transport))\n  const result: ReleaseListQuery = await sdk.ReleaseList(input)\n  if (!result.repository) {\n    throw new Error(`Repository ${input.owner}/${input.name} not found`)\n  }\n  const conn = result.repository.releases\n  return {\n    items: (conn?.nodes ?? []).flatMap((n) => (n ? [mapReleaseNode(n)] : [])),\n    pageInfo: {\n      hasNextPage: conn?.pageInfo.hasNextPage ?? false,\n      endCursor: conn?.pageInfo.endCursor ?? null,\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AA2BA,SAAS,eAAe,GAAiC;AACvD,SAAO;AAAA,IACL,IAAI,EAAE,cAAc;AAAA,IACpB,SAAS,EAAE;AAAA,IACX,MAAM,EAAE,QAAQ;AAAA,IAChB,SAAS,EAAE;AAAA,IACX,cAAc,EAAE;AAAA,IAChB,KAAK,EAAE,OAAO,OAAO,OAAO,EAAE,GAAG,IAAI;AAAA,IACrC,iBAAiB,EAAE,WAAW,OAAO,OAAO,OAAO,EAAE,UAAU,GAAG,IAAI;AAAA,IACtE,WAAW,EAAE,aAAa,OAAO,OAAO,EAAE,SAAS,IAAI;AAAA,IACvD,aAAa,EAAE,eAAe,OAAO,OAAO,EAAE,WAAW,IAAI;AAAA,EAC/D;AACF;AAEA,eAAsB,eACpB,WACA,OAC0B;AAC1B,yBAAuB,KAAK;AAC5B,QAAM,MAAMA,QAAkB,2BAA2B,SAAS,CAAC;AACnE,QAAM,SAA2B,MAAM,IAAI,YAAY,KAAK;AAC5D,MAAI,CAAC,OAAO,YAAY,SAAS;AAC/B,UAAM,IAAI,MAAM,mBAAmB;AAAA,EACrC;AACA,SAAO,eAAe,OAAO,WAAW,OAAO;AACjD;AAEA,eAAsB,eACpB,WACA,OAC0B;AAC1B,+BAA6B,KAAK;AAClC,QAAM,MAAM,OAAkB,2BAA2B,SAAS,CAAC;AACnE,QAAM,SAA2B,MAAM,IAAI,YAAY,KAAK;AAC5D,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI,MAAM,cAAc,MAAM,KAAK,IAAI,MAAM,IAAI,YAAY;AAAA,EACrE;AACA,QAAM,OAAO,OAAO,WAAW;AAC/B,SAAO;AAAA,IACL,QAAQ,MAAM,SAAS,CAAC,GAAG,QAAQ,CAAC,MAAO,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAE;AAAA,IACxE,UAAU;AAAA,MACR,aAAa,MAAM,SAAS,eAAe;AAAA,MAC3C,WAAW,MAAM,SAAS,aAAa;AAAA,IACzC;AAAA,EACF;AACF;","names":["getSdk"]}

package/dist/repo-M6DKCWBG.js

@@ -0,0 +1,82 @@
+import {
+  getSdk,
+  getSdk2,
+  getSdk3
+} from "./chunk-NQ53ETYV.js";
+import "./chunk-R3CBGJZX.js";
+import {
+  assertRepoAndPaginationInput,
+  assertRepoInput
+} from "./chunk-OQWLEFAH.js";
+import {
+  createGraphqlRequestClient
+} from "./chunk-HEHONZTO.js";
+
+// src/gql/domains/repo.ts
+async function runRepoView(transport, input) {
+  assertRepoInput(input);
+  const sdk = getSdk3(createGraphqlRequestClient(transport));
+  const result = await sdk.RepoView(input);
+  if (!result.repository) {
+    throw new Error("Repository not found");
+  }
+  return {
+    id: result.repository.id,
+    name: result.repository.name,
+    nameWithOwner: result.repository.nameWithOwner,
+    isPrivate: result.repository.isPrivate,
+    stargazerCount: result.repository.stargazerCount,
+    forkCount: result.repository.forkCount,
+    url: result.repository.url,
+    defaultBranch: result.repository.defaultBranchRef?.name ?? null
+  };
+}
+async function runRepoLabelsList(transport, input) {
+  assertRepoAndPaginationInput(input);
+  const sdk = getSdk2(createGraphqlRequestClient(transport));
+  const result = await sdk.RepoLabelsList(input);
+  if (!result.repository) {
+    throw new Error(`Repository ${input.owner}/${input.name} not found`);
+  }
+  const conn = result.repository?.labels;
+  return {
+    items: (conn?.nodes ?? []).map((n) => ({
+      id: n?.id ?? null,
+      name: n?.name ?? null,
+      description: n?.description ?? null,
+      color: n?.color ?? null,
+      isDefault: n?.isDefault ?? null
+    })),
+    pageInfo: {
+      hasNextPage: conn?.pageInfo.hasNextPage ?? false,
+      endCursor: conn?.pageInfo.endCursor ?? null
+    }
+  };
+}
+async function runRepoIssueTypesList(transport, input) {
+  assertRepoAndPaginationInput(input);
+  const sdk = getSdk(createGraphqlRequestClient(transport));
+  const result = await sdk.RepoIssueTypesList(input);
+  if (!result.repository) {
+    throw new Error(`Repository ${input.owner}/${input.name} not found`);
+  }
+  const conn = result.repository?.issueTypes;
+  return {
+    items: (conn?.nodes ?? []).map((n) => ({
+      id: n?.id ?? null,
+      name: n?.name ?? null,
+      color: n?.color != null ? String(n.color) : null,
+      isEnabled: n?.isEnabled ?? null
+    })),
+    pageInfo: {
+      hasNextPage: conn?.pageInfo.hasNextPage ?? false,
+      endCursor: conn?.pageInfo.endCursor ?? null
+    }
+  };
+}
+export {
+  runRepoIssueTypesList,
+  runRepoLabelsList,
+  runRepoView
+};
+//# sourceMappingURL=repo-M6DKCWBG.js.map

package/dist/repo-M6DKCWBG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gql/domains/repo.ts"],"sourcesContent":["import { assertRepoAndPaginationInput, assertRepoInput } from \"../assertions.js\"\nimport type { RepoIssueTypesListQuery } from \"../operations/repo-issue-types-list.generated.js\"\nimport { getSdk as getRepoIssueTypesListSdk } from \"../operations/repo-issue-types-list.generated.js\"\nimport type { RepoLabelsListQuery } from \"../operations/repo-labels-list.generated.js\"\nimport { getSdk as getRepoLabelsListSdk } from \"../operations/repo-labels-list.generated.js\"\nimport type { RepoViewQuery } from \"../operations/repo-view.generated.js\"\nimport { getSdk } from \"../operations/repo-view.generated.js\"\nimport type { GraphqlTransport } from \"../transport.js\"\nimport { createGraphqlRequestClient } from \"../transport.js\"\nimport type {\n  RepoIssueTypesListData,\n  RepoIssueTypesListInput,\n  RepoLabelsListData,\n  RepoLabelsListInput,\n  RepoViewData,\n  RepoViewInput,\n} from \"../types.js\"\n\nexport async function runRepoView(\n  transport: GraphqlTransport,\n  input: RepoViewInput,\n): Promise<RepoViewData> {\n  assertRepoInput(input)\n  const sdk = getSdk(createGraphqlRequestClient(transport))\n  const result: RepoViewQuery = await sdk.RepoView(input)\n  if (!result.repository) {\n    throw new Error(\"Repository not found\")\n  }\n\n  return {\n    id: result.repository.id,\n    name: result.repository.name,\n    nameWithOwner: result.repository.nameWithOwner,\n    isPrivate: result.repository.isPrivate,\n    stargazerCount: result.repository.stargazerCount,\n    forkCount: result.repository.forkCount,\n    url: result.repository.url,\n    defaultBranch: result.repository.defaultBranchRef?.name ?? null,\n  }\n}\n\nexport async function runRepoLabelsList(\n  transport: GraphqlTransport,\n  input: RepoLabelsListInput,\n): Promise<RepoLabelsListData> {\n  assertRepoAndPaginationInput(input)\n  const sdk = getRepoLabelsListSdk(createGraphqlRequestClient(transport))\n  const result: RepoLabelsListQuery = await sdk.RepoLabelsList(input)\n  if (!result.repository) {\n    throw new Error(`Repository ${input.owner}/${input.name} not found`)\n  }\n  const conn = result.repository?.labels\n  return {\n    items: (conn?.nodes ?? []).map((n) => ({\n      id: n?.id ?? null,\n      name: n?.name ?? null,\n      description: n?.description ?? null,\n      color: n?.color ?? null,\n      isDefault: n?.isDefault ?? null,\n    })),\n    pageInfo: {\n      hasNextPage: conn?.pageInfo.hasNextPage ?? false,\n      endCursor: conn?.pageInfo.endCursor ?? null,\n    },\n  }\n}\n\nexport async function runRepoIssueTypesList(\n  transport: GraphqlTransport,\n  input: RepoIssueTypesListInput,\n): Promise<RepoIssueTypesListData> {\n  assertRepoAndPaginationInput(input)\n  const sdk = getRepoIssueTypesListSdk(createGraphqlRequestClient(transport))\n  const result: RepoIssueTypesListQuery = await sdk.RepoIssueTypesList(input)\n  if (!result.repository) {\n    throw new Error(`Repository ${input.owner}/${input.name} not found`)\n  }\n  const conn = result.repository?.issueTypes\n  return {\n    items: (conn?.nodes ?? []).map((n) => ({\n      id: n?.id ?? null,\n      name: n?.name ?? null,\n      color: n?.color != null ? String(n.color) : null,\n      isEnabled: n?.isEnabled ?? null,\n    })),\n    pageInfo: {\n      hasNextPage: conn?.pageInfo.hasNextPage ?? false,\n      endCursor: conn?.pageInfo.endCursor ?? null,\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,eAAsB,YACpB,WACA,OACuB;AACvB,kBAAgB,KAAK;AACrB,QAAM,MAAMA,QAAO,2BAA2B,SAAS,CAAC;AACxD,QAAM,SAAwB,MAAM,IAAI,SAAS,KAAK;AACtD,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI,MAAM,sBAAsB;AAAA,EACxC;AAEA,SAAO;AAAA,IACL,IAAI,OAAO,WAAW;AAAA,IACtB,MAAM,OAAO,WAAW;AAAA,IACxB,eAAe,OAAO,WAAW;AAAA,IACjC,WAAW,OAAO,WAAW;AAAA,IAC7B,gBAAgB,OAAO,WAAW;AAAA,IAClC,WAAW,OAAO,WAAW;AAAA,IAC7B,KAAK,OAAO,WAAW;AAAA,IACvB,eAAe,OAAO,WAAW,kBAAkB,QAAQ;AAAA,EAC7D;AACF;AAEA,eAAsB,kBACpB,WACA,OAC6B;AAC7B,+BAA6B,KAAK;AAClC,QAAM,MAAMA,QAAqB,2BAA2B,SAAS,CAAC;AACtE,QAAM,SAA8B,MAAM,IAAI,eAAe,KAAK;AAClE,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI,MAAM,cAAc,MAAM,KAAK,IAAI,MAAM,IAAI,YAAY;AAAA,EACrE;AACA,QAAM,OAAO,OAAO,YAAY;AAChC,SAAO;AAAA,IACL,QAAQ,MAAM,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO;AAAA,MACrC,IAAI,GAAG,MAAM;AAAA,MACb,MAAM,GAAG,QAAQ;AAAA,MACjB,aAAa,GAAG,eAAe;AAAA,MAC/B,OAAO,GAAG,SAAS;AAAA,MACnB,WAAW,GAAG,aAAa;AAAA,IAC7B,EAAE;AAAA,IACF,UAAU;AAAA,MACR,aAAa,MAAM,SAAS,eAAe;AAAA,MAC3C,WAAW,MAAM,SAAS,aAAa;AAAA,IACzC;AAAA,EACF;AACF;AAEA,eAAsB,sBACpB,WACA,OACiC;AACjC,+BAA6B,KAAK;AAClC,QAAM,MAAM,OAAyB,2BAA2B,SAAS,CAAC;AAC1E,QAAM,SAAkC,MAAM,IAAI,mBAAmB,KAAK;AAC1E,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI,MAAM,cAAc,MAAM,KAAK,IAAI,MAAM,IAAI,YAAY;AAAA,EACrE;AACA,QAAM,OAAO,OAAO,YAAY;AAChC,SAAO;AAAA,IACL,QAAQ,MAAM,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO;AAAA,MACrC,IAAI,GAAG,MAAM;AAAA,MACb,MAAM,GAAG,QAAQ;AAAA,MACjB,OAAO,GAAG,SAAS,OAAO,OAAO,EAAE,KAAK,IAAI;AAAA,MAC5C,WAAW,GAAG,aAAa;AAAA,IAC7B,EAAE;AAAA,IACF,UAAU;AAAA,MACR,aAAa,MAAM,SAAS,eAAe;AAAA,MAC3C,WAAW,MAAM,SAAS,aAAa;AAAA,IACzC;AAAA,EACF;AACF;","names":["getSdk"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghx-dev/core",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "GitHub execution router for AI agents with deterministic routing and normalized output.",
   "author": "Arye Kogan",
   "license": "MIT",
@@ -37,16 +37,14 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
-    "./agent": {
-      "import": "./dist/agent.js",
-      "types": "./dist/agent.d.ts"
-    },
     "./cli": {
       "import": "./dist/cli/index.js"
     }
   },
   "files": [
     "dist",
+    ".claude-plugin",
+    "skills",
     "LICENSE",
     "README.md"
   ],
@@ -59,7 +57,7 @@
       "ci": {},
       "ci:extra": {
         "dependsOn": [
-          "gql:check"
+          "plugin:sync:check"
         ]
       },
       "test:e2e": {}
@@ -68,27 +66,30 @@
   "dependencies": {
     "ajv": "^8.18.0",
     "graphql": "^16.11.0",
-    "graphql-tag": "^2.12.6",
     "graphql-request": "^7.3.1",
+    "graphql-tag": "^2.12.6",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@opencode-ai/sdk": "^1.2.6",
-    "@vitest/coverage-v8": "^2.1.8",
-    "@graphql-codegen/cli": "^6.1.1",
+    "@graphql-codegen/cli": "^6.1.2",
     "@graphql-codegen/near-operation-file-preset": "^4.0.0",
-    "@graphql-codegen/typescript": "^5.0.7",
+    "@graphql-codegen/schema-ast": "^5.0.0",
+    "@graphql-codegen/typescript": "^5.0.8",
     "@graphql-codegen/typescript-graphql-request": "^6.3.0",
-    "@graphql-codegen/typescript-operations": "^5.0.7",
+    "@graphql-codegen/typescript-operations": "^5.0.8",
+    "@opencode-ai/sdk": "^1.2.10",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^2.1.8",
     "tsup": "^8.5.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^2.1.8"
   },
   "scripts": {
-    "build": "tsup && node scripts/copy-registry-cards.mjs",
+    "ghx": "tsx src/cli/index.ts",
+    "build": "tsup",
     "format": "biome check --write .",
     "format:check": "biome check .",
     "lint": "eslint . --max-warnings=0",
@@ -98,8 +99,10 @@
     "test:coverage": "vitest run --project unit --coverage",
     "test:e2e:local": "vitest run --project e2e:local",
     "test:e2e:sdk": "if [ -n \"$OPENAI_API_KEY\" ]; then vitest run --project e2e:sdk; else echo 'Skipping core SDK E2E: OPENAI_API_KEY not set'; fi",
-    "gql:codegen": "tsx scripts/run-gql-codegen.ts",
-    "gql:codegen:watch": "graphql-codegen --config codegen.ts --watch",
-    "gql:check": "pnpm run gql:codegen && biome check --write --no-errors-on-unmatched src/gql/generated src/gql/operations && git diff --exit-code -- src/gql/generated src/gql/operations/*.generated.ts"
+    "plugin:sync": "node scripts/sync-plugin-manifests.mjs",
+    "plugin:sync:check": "node scripts/sync-plugin-manifests.mjs --check",
+    "gql:generate": "node scripts/generate-gql-artifacts.mjs && biome check --write --no-errors-on-unmatched src/gql/generated src/gql/operations",
+    "gql:schema:refresh": "GITHUB_TOKEN=\"$(gh auth token)\" graphql-codegen --config codegen-schema.ts",
+    "gql:verify": "pnpm run gql:generate && git diff --exit-code -- ':(glob)src/gql/**/*.generated.ts'"
   }
 }

package/skills/using-ghx/SKILL.md

@@ -0,0 +1,127 @@
+---
+description: Execute GitHub operations via ghx — deterministic routing, normalized output, 70 capabilities
+---
+
+# ghx CLI Skill
+
+**CRITICAL:** Use `ghx` for ALL GitHub operations. Do not use `gh api` or any other raw `gh` commands unless no matching ghx capability exists.
+
+## Capabilities
+
+All available capabilities (`id - description [inputs]`, `?` = optional):
+
+```
+repo.view - Fetch repository metadata. [owner, name]
+repo.labels.list - List repository labels. [owner, name, first?, after?]
+repo.issue_types.list - List repository issue types. [owner, name, first?, after?]
+issue.view - Fetch one issue by number. [owner, name, issueNumber]
+issue.list - List repository issues. [owner, name, state?, first?, after?]
+issue.comments.list - List comments for one issue. [owner, name, issueNumber, first, after?]
+issue.create - Create a new issue. [owner, name, title, body?]
+issue.update - Update issue title and/or body. [owner, name, issueNumber, title?, body?]
+issue.close - Close an issue. [owner, name, issueNumber]
+issue.reopen - Reopen a closed issue. [owner, name, issueNumber]
+issue.delete - Delete an issue. [owner, name, issueNumber]
+issue.labels.set - Replace issue labels. [owner, name, issueNumber, labels]
+issue.labels.add - Add labels to an issue without removing existing labels. [owner, name, issueNumber, labels]
+issue.labels.remove - Remove specific labels from an issue. [owner, name, issueNumber, labels]
+issue.assignees.set - Replace issue assignees. [owner, name, issueNumber, assignees]
+issue.assignees.add - Add assignees to an issue without replacing existing ones. [owner, name, issueNumber, assignees]
+issue.assignees.remove - Remove specific assignees from an issue. [owner, name, issueNumber, assignees]
+issue.milestone.set - Set issue milestone number or clear with null. [owner, name, issueNumber, milestoneNumber]
+issue.milestone.clear - Remove the milestone from an issue. [owner, name, issueNumber]
+issue.comments.create - Create an issue comment. [owner, name, issueNumber, body]
+issue.relations.prs.list - List pull requests linked to an issue. [owner, name, issueNumber]
+issue.relations.view - Get issue parent/children/blocking relations. [owner, name, issueNumber]
+issue.relations.parent.set - Set an issue parent relation. [issueId, parentIssueId]
+issue.relations.parent.remove - Remove an issue parent relation. [issueId]
+issue.relations.blocked_by.add - Add a blocked-by relation for an issue. [issueId, blockedByIssueId]
+issue.relations.blocked_by.remove - Remove a blocked-by relation for an issue. [issueId, blockedByIssueId]
+pr.view - Fetch one pull request by number. [owner, name, prNumber]
+pr.list - List repository pull requests. [owner, name, state?, first?, after?]
+pr.create - Create a pull request. [owner, name, title, head, base, body?, draft?]
+pr.update - Update pull request metadata (title, body, draft status). [owner, name, prNumber, title?, body?, draft?]
+pr.threads.list - List PR review threads. [owner, name, prNumber, first?, after?, unresolvedOnly? (default true), includeOutdated? default false]
+pr.threads.reply - Reply to a PR review thread. [threadId, body]
+pr.threads.resolve - Resolve a PR review thread. [threadId]
+pr.threads.unresolve - Unresolve a PR review thread. [threadId]
+pr.reviews.list - List PR reviews (state, author, body). Review-level only — use pr.threads.list for inline comments. [owner, name, prNumber, first?, after?]
+pr.reviews.request - Request PR reviewers. [owner, name, prNumber, reviewers]
+pr.reviews.submit - Submit a PR review (approve/request-changes/comment). Non-empty body required for COMMENT and REQUEST_CHANGES. [owner, name, prNumber, event, body?, comments?[path, body, line, side?, startLine?, startSide?]]
+pr.diff.files - List changed files in a PR diff. [owner, name, prNumber, first?, after?]
+pr.diff.view - View the unified diff for a PR. [owner, name, prNumber]
+pr.checks.list - List PR check statuses with summary counts. [owner, name, prNumber, state?]
+pr.checks.rerun.failed - Rerun failed PR workflow checks for a selected run. [owner, name, prNumber, runId]
+pr.checks.rerun.all - Rerun all PR workflow checks for a selected run. [owner, name, prNumber, runId]
+pr.merge.status - View PR mergeability and readiness signals. [owner, name, prNumber]
+pr.merge - Execute a PR merge. [owner, name, prNumber, method?, deleteBranch?]
+pr.assignees.add - Add assignees to a PR without replacing existing ones. [owner, name, prNumber, assignees]
+pr.assignees.remove - Remove specific assignees from a PR. [owner, name, prNumber, assignees]
+pr.branch.update - Update PR branch with latest base branch changes. [owner, name, prNumber]
+workflow.list - List repository workflows. [owner, name, first?]
+workflow.view - View one repository workflow. [owner, name, workflowId]
+workflow.dispatch - Trigger a workflow dispatch event. [owner, name, workflowId, ref, inputs?]
+workflow.runs.list - List workflow runs for a repository. [owner, name, first?, branch?, event?, status?]
+workflow.run.view - View a workflow run with its jobs. [owner, name, runId]
+workflow.run.cancel - Cancel a workflow run. [owner, name, runId]
+workflow.run.rerun.all - Rerun all jobs in a workflow run. [owner, name, runId]
+workflow.run.rerun.failed - Rerun failed jobs for a workflow run. [owner, name, runId]
+workflow.run.artifacts.list - List artifacts for a workflow run. [owner, name, runId]
+workflow.job.logs.view - Fetch and analyze workflow job logs. [owner, name, jobId]
+workflow.job.logs.raw - Fetch raw (unprocessed) logs for a workflow job. [owner, name, jobId]
+project_v2.org.view - Get an organization Projects v2 project. [org, projectNumber]
+project_v2.user.view - Get a user Projects v2 project. [user, projectNumber]
+project_v2.fields.list - List fields for a Projects v2 project. [owner, projectNumber, first?, after?]
+project_v2.items.list - List items in a Projects v2 project. [owner, projectNumber, first?, after?]
+project_v2.items.issue.add - Add an issue to a Projects v2 project. [owner, projectNumber, issueUrl]
+project_v2.items.issue.remove - Remove an issue from a Projects v2 project. [owner, projectNumber, itemId]
+project_v2.items.field.update - Update a field on a Projects v2 project item. [projectId, itemId, fieldId, valueText?, valueNumber?, valueDate?, valueSingleSelectOptionId?, valueIterationId?, clear?]
+release.list - List releases for a repository. [owner, name, first?, after?]
+release.view - Get release details by tag name. [owner, name, tagName]
+release.create - Create a draft release. [owner, name, tagName, title?, notes?, targetCommitish?, prerelease?]
+release.update - Update a draft release without publishing it. [owner, name, releaseId, tagName?, title?, notes?, targetCommitish?, prerelease?, draft?]
+release.publish - Publish an existing draft release. [owner, name, releaseId, title?, notes?, prerelease?]
+```
+
+Only if the full input/output schema of a specific capability needed:
+
+```bash
+ghx capabilities explain <capability_id>
+```
+
+## Execute
+
+**Always use heredoc — never inline `--input '...'`.** Inline form breaks with nested quotes and trailing commas in model-generated JSON.
+
+```bash
+ghx run <capability_id> --input - <<'EOF'
+{...}
+EOF
+```
+
+Example (submitting a review with inline comments):
+
+```bash
+ghx run pr.reviews.submit --input - <<'EOF'
+{"owner": "acme", "name": "my-repo", "prNumber": 42, "event": "REQUEST_CHANGES", "body": "Please fix the issues.", "comments": [{"path": "src/index.ts", "line": 10, "body": "Off-by-one error here."}]}
+EOF
+```
+
+**Result (compact, default):** `{ ok, data?, pagination? }` on success — `{ ok, error: { code, message } }` on failure.
+
+## Chain
+
+**Always use `ghx chain` when you have two or more operations to execute in a single call.** It batches steps into as few GraphQL round-trips as possible (typically one) — reducing latency and avoiding mid-sequence failures. Steps are not transactional; a `"partial"` result is possible if one step fails after another has already succeeded.
+
+```bash
+ghx chain --steps - <<'EOF'
+[
+  {"task":"<capability_id>","input":{...}},
+  {"task":"<capability_id>","input":{...}}
+]
+EOF
+```
+
+**Result:** `{ status, results[] }`. Each result: `{ task, ok, data? }` on success — `{ task, ok, error: { code, message } }` on failure.
+
+**CRITICAL:** Do not use `gh api` or any other raw `gh` commands unless no matching ghx capability exists. Always try `ghx` first.

package/dist/agent.d.ts

@@ -1,32 +0,0 @@
-import { R as ResultEnvelope } from './envelope-BpF6MNCv.js';
-
-declare const MAIN_SKILL_TEXT: string;
-
-type ExecuteTaskFn = (request: {
-    task: string;
-    input: Record<string, unknown>;
-    options?: Record<string, unknown>;
-}) => Promise<ResultEnvelope>;
-declare function createExecuteTool(deps: {
-    executeTask: ExecuteTaskFn;
-}): {
-    execute(capabilityId: string, params: Record<string, unknown>, options?: Record<string, unknown>): Promise<ResultEnvelope>;
-};
-
-type CapabilityExplanation = {
-    capability_id: string;
-    purpose: string;
-    required_inputs: string[];
-    preferred_route: "cli" | "graphql" | "rest";
-    fallback_routes: Array<"cli" | "graphql" | "rest">;
-    output_fields: string[];
-};
-declare function explainCapability(capabilityId: string): CapabilityExplanation;
-
-type CapabilityListItem = {
-    capability_id: string;
-    description: string;
-};
-declare function listCapabilities(): CapabilityListItem[];
-
-export { MAIN_SKILL_TEXT, createExecuteTool, explainCapability, listCapabilities };

package/dist/agent.js

@@ -1,36 +0,0 @@
-import {
-  explainCapability,
-  listCapabilities
-} from "./chunk-2FCPR3XZ.js";
-import "./chunk-UN5YHUNK.js";
-
-// src/agent-interface/prompt/main-skill.ts
-var MAIN_SKILL_TEXT = `
-Use execute(capability_id, params) for all GitHub actions.
-Never call gh help and never fetch GraphQL schema/introspection.
-If required params are unknown, call explain(capability_id) or ask the user.
-Treat ResultEnvelope.ok=false as a failure.
-If error.retryable=true, retry once unless user requested otherwise.
-Only reason about ResultEnvelope.data and ResultEnvelope.error.
-`.trim();
-
-// src/agent-interface/tools/execute-tool.ts
-function createExecuteTool(deps) {
-  return {
-    execute(capabilityId, params, options) {
-      const request = {
-        task: capabilityId,
-        input: params,
-        ...options ? { options } : {}
-      };
-      return deps.executeTask(request);
-    }
-  };
-}
-export {
-  MAIN_SKILL_TEXT,
-  createExecuteTool,
-  explainCapability,
-  listCapabilities
-};
-//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/agent-interface/prompt/main-skill.ts","../src/agent-interface/tools/execute-tool.ts"],"sourcesContent":["export const MAIN_SKILL_TEXT = `\nUse execute(capability_id, params) for all GitHub actions.\nNever call gh help and never fetch GraphQL schema/introspection.\nIf required params are unknown, call explain(capability_id) or ask the user.\nTreat ResultEnvelope.ok=false as a failure.\nIf error.retryable=true, retry once unless user requested otherwise.\nOnly reason about ResultEnvelope.data and ResultEnvelope.error.\n`.trim()\n","import type { ResultEnvelope } from \"../../core/contracts/envelope.js\"\n\ntype ExecuteTaskFn = (request: {\n  task: string\n  input: Record<string, unknown>\n  options?: Record<string, unknown>\n}) => Promise<ResultEnvelope>\n\nexport function createExecuteTool(deps: { executeTask: ExecuteTaskFn }) {\n  return {\n    execute(\n      capabilityId: string,\n      params: Record<string, unknown>,\n      options?: Record<string, unknown>,\n    ): Promise<ResultEnvelope> {\n      const request = {\n        task: capabilityId,\n        input: params,\n        ...(options ? { options } : {}),\n      }\n\n      return deps.executeTask(request)\n    },\n  }\n}\n"],"mappings":";;;;;;;AAAO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,KAAK;;;ACCA,SAAS,kBAAkB,MAAsC;AACtE,SAAO;AAAA,IACL,QACE,cACA,QACA,SACyB;AACzB,YAAM,UAAU;AAAA,QACd,MAAM;AAAA,QACN,OAAO;AAAA,QACP,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC/B;AAEA,aAAO,KAAK,YAAY,OAAO;AAAA,IACjC;AAAA,EACF;AACF;","names":[]}

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

@@ -1,35 +0,0 @@
-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/cards/issue.assignees.update.yaml

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

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

@@ -1,27 +0,0 @@
-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/pr.assignees.update.yaml

@@ -1,38 +0,0 @@
-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.checks.get_failed.yaml

@@ -1,42 +0,0 @@
-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.review.submit_approve.yaml

@@ -1,26 +0,0 @@
-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