@ghx-dev/core 0.2.0 → 0.2.1

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.2.0",
+  "version": "0.2.1",
   "description": "GitHub execution router for AI agents with deterministic routing and normalized output.",
   "author": "Arye Kogan",
   "license": "MIT",
@@ -71,13 +71,13 @@
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@graphql-codegen/cli": "^6.1.1",
+    "@graphql-codegen/cli": "^6.1.2",
     "@graphql-codegen/near-operation-file-preset": "^4.0.0",
-    "@graphql-codegen/schema-ast": "^4.1.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",
-    "@opencode-ai/sdk": "^1.2.6",
+    "@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",

package/skills/using-ghx/SKILL.md

@@ -6,18 +6,84 @@ description: Execute GitHub operations via ghx — deterministic routing, normal
 
 **CRITICAL:** Use `ghx` for ALL GitHub operations. Do not use `gh api` or any other raw `gh` commands unless no matching ghx capability exists.
 
-## Discovery
+## Capabilities
 
-If you don't know the capability ID or required inputs, list by domain first:
+All available capabilities (`id - description [inputs]`, `?` = optional):
 
-```bash
-ghx capabilities list --domain pr
+```
+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?]
 ```
 
-Domains: `repo`, `issue`, `pr`, `release`, `workflow`, `project_v2`.
-Required inputs shown in brackets (e.g. `[owner, name, prNumber]`).
-
-Only if you need the full input/output schema for a specific capability:
+Only if the full input/output schema of a specific capability needed:
 
 ```bash
 ghx capabilities explain <capability_id>
@@ -41,7 +107,7 @@ ghx run pr.reviews.submit --input - <<'EOF'
 EOF
 ```
 
-Result: `{ ok, data, error, meta }`. Check `ok` first. If `ok=false` and `error.retryable=true`, retry once.
+**Result (compact, default):** `{ ok, data?, pagination? }` on success — `{ ok, error: { code, message } }` on failure.
 
 ## Chain
 
@@ -56,6 +122,6 @@ ghx chain --steps - <<'EOF'
 EOF
 ```
 
-**Result:** `{ status, results[], meta }`. Check `status` first (`"success"` | `"partial"` | `"failed"`). Each `results[i]` has `{ task, ok, data | error }`.
+**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.