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

package/README.md

@@ -1,175 +1,178 @@
 # @ghx-dev/core
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aryeko/ghx/main/assets/branding/social/ghx-social-dark-1280x640.png" alt="ghx social preview" width="480">
+</p>
+
 [![npm version](https://img.shields.io/npm/v/%40ghx-dev%2Fcore)](https://www.npmjs.com/package/@ghx-dev/core)
 [![npm downloads](https://img.shields.io/npm/dm/%40ghx-dev%2Fcore)](https://www.npmjs.com/package/@ghx-dev/core)
+[![CI (main)](https://github.com/aryeko/ghx/actions/workflows/ci-main.yml/badge.svg)](https://github.com/aryeko/ghx/actions/workflows/ci-main.yml)
+[![codecov](https://codecov.io/gh/aryeko/ghx/graph/badge.svg?token=KBIGR138V7)](https://codecov.io/gh/aryeko/ghx)
 [![License](https://img.shields.io/npm/l/%40ghx-dev%2Fcore)](https://github.com/aryeko/ghx/blob/main/LICENSE)
 
-CLI-first GitHub execution router for agents.
+Typed GitHub execution router for AI agents. Deterministic routing across CLI and GraphQL, runtime schema validation, and a stable result envelope -- so agents stop wasting tokens re-discovering GitHub API surfaces.
+
+## Why ghx
 
-`@ghx-dev/core` exposes a typed execution engine that routes GitHub tasks across CLI and GraphQL, validates inputs/outputs against operation-card schemas, and returns a stable result envelope for deterministic agent workflows.
+Agents instructed to "use `gh` CLI" for common PR and issue operations waste significant tokens on research, trial-and-error, and output parsing. Benchmarked across 27 runs on standard PR workflows:
 
-## Why @ghx-dev/core
+| Metric | Improvement |
+|---|---|
+| Active tokens | **-37%** fewer tokens consumed |
+| Latency | **-32%** faster end-to-end |
+| Tool calls | **-33%** fewer tool invocations |
+| Success rate | **100%** (zero regressions) |
 
-- **Stable contract**: every task returns `{ ok, data, error, meta }`
-- **Route-aware execution**: preferred route + fallback routes per capability
-- **Schema validation**: runtime validation for task input/output
-- **Typed clients**: typed GraphQL/GitHub client helpers
-- **Agent-ready tools**: subpath exports for capability listing/explanation/execution wrappers
+ghx eliminates the discovery phase: agents call typed capabilities, get validated results back in a stable envelope.
 
 ## Installation
 
+Requirements: Node.js `22+`, `gh` CLI authenticated (`gh auth status`).
+
 ```bash
-pnpm add @ghx-dev/core
+npm install @ghx-dev/core
 ```
 
 Alternative package managers:
 
 ```bash
-npm i @ghx-dev/core
+pnpm add @ghx-dev/core
 # or
 yarn add @ghx-dev/core
 ```
 
-## Quick Start (Library API)
+Or run directly without installing:
 
-```ts
-import { createGithubClient, executeTask } from "@ghx-dev/core"
+```bash
+npx @ghx-dev/core capabilities list
+```
 
-const githubToken = process.env.GITHUB_TOKEN
+Global CLI install:
 
-if (!githubToken) {
-  throw new Error("Missing GITHUB_TOKEN")
-}
+```bash
+npm i -g @ghx-dev/core
+```
 
-const githubClient = createGithubClient({
-  async execute<TData>(query: string, variables?: Record<string, unknown>): Promise<TData> {
-    const response = await fetch("https://api.github.com/graphql", {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${githubToken}`,
-      },
-      body: JSON.stringify({ query, variables: variables ?? {} }),
-    })
+## Quick Start (CLI)
 
-    const payload = (await response.json()) as {
-      data?: TData
-      errors?: Array<{ message?: string }>
-      message?: string
-    }
+Set `GITHUB_TOKEN` or `GH_TOKEN` in your environment, then:
 
-    if (!response.ok) {
-      throw new Error(payload.message ?? `GraphQL request failed (${response.status})`)
-    }
+```bash
+npx @ghx-dev/core capabilities list
+npx @ghx-dev/core capabilities explain repo.view
+npx @ghx-dev/core run repo.view --input '{"owner":"aryeko","name":"ghx"}'
+```
 
-    if (payload.errors?.length) {
-      throw new Error(payload.errors[0]?.message ?? "GraphQL returned errors")
-    }
+If installed globally, replace `npx @ghx-dev/core` with `ghx`.
 
-    if (payload.data === undefined) {
-      throw new Error("GraphQL response missing data")
-    }
+Every capability returns a stable envelope:
 
-    return payload.data
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "R_kgDOOx...",
+    "name": "ghx",
+    "nameWithOwner": "aryeko/ghx"
   },
-})
+  "error": null,
+  "meta": {
+    "capability_id": "repo.view",
+    "route_used": "cli",
+    "reason": "CARD_PREFERRED"
+  }
+}
+```
+
+## Quick Start (Library API)
+
+```ts
+import { createGithubClientFromToken, executeTask } from "@ghx-dev/core"
+
+const token = process.env.GITHUB_TOKEN!
+const githubClient = createGithubClientFromToken(token)
 
 const result = await executeTask(
-  {
-    task: "repo.view",
-    input: {
-      owner: "aryeko",
-      name: "ghx",
-    },
-  },
-  {
-    githubClient,
-    githubToken,
-  },
+  { task: "repo.view", input: { owner: "aryeko", name: "ghx" } },
+  { githubClient, githubToken: token },
 )
 
-if (!result.ok) {
-  throw new Error(`${result.error?.code}: ${result.error?.message}`)
+if (result.ok) {
+  console.log(result.data)
+} else {
+  console.error(result.error?.code, result.error?.message)
 }
+```
+
+Need a custom GraphQL transport? Use `createGithubClient(transport)` instead -- see the [advanced usage section](#custom-graphql-transport).
+
+## Agent Onboarding
 
-console.log(result.data)
+Install ghx as a project skill for Claude Code:
+
+```bash
+npx @ghx-dev/core setup --scope project --yes
+npx @ghx-dev/core setup --scope project --verify
 ```
 
+### Setup Skill Source
+
+The canonical setup skill content is stored in:
+
+- `src/cli/assets/skills/ghx/SKILL.md`
+
+During build/publish it is copied to:
+
+- `dist/cli/assets/skills/ghx/SKILL.md`
+
+`ghx setup` writes this content to `.agents/skills/ghx/SKILL.md` in user or project scope.
+
 ## Agent Tools (`@ghx-dev/core/agent`)
 
 ```ts
 import {
   createExecuteTool,
-  explainCapability,
   listCapabilities,
+  explainCapability,
   MAIN_SKILL_TEXT,
 } from "@ghx-dev/core/agent"
+import { createGithubClientFromToken, executeTask } from "@ghx-dev/core"
 
-const executeTool = createExecuteTool({
-  executeTask: async (request) => {
-    // delegate to your runtime integration
-    return { ok: true, data: request, meta: { capability_id: request.task } }
-  },
+// Wire the execute tool to the real engine
+const token = process.env.GITHUB_TOKEN!
+const githubClient = createGithubClientFromToken(token)
+
+const tool = createExecuteTool({
+  executeTask: (request) => executeTask(request, { githubClient, githubToken: token }),
 })
 
-console.log(MAIN_SKILL_TEXT)
+// Discover and execute capabilities
 console.log(listCapabilities())
 console.log(explainCapability("repo.view"))
-await executeTool.execute("repo.view", { owner: "aryeko", name: "ghx" })
+const result = await tool.execute("repo.view", { owner: "aryeko", name: "ghx" })
 ```
 
-## CLI
+`MAIN_SKILL_TEXT` provides a ready-to-use system prompt describing all capabilities.
 
-When installed globally (or executed via package manager), use:
+## 66 Capabilities
 
-```bash
-ghx run repo.view --input '{"owner":"aryeko","name":"ghx"}'
-```
+**Repository** -- `repo.view`, `repo.labels.list`, `repo.issue_types.list`
 
-Environment variables used by the CLI path:
+**Issues** -- `issue.view`, `issue.list`, `issue.comments.list`, `issue.create`, `issue.update`, `issue.close`, `issue.reopen`, `issue.delete`, `issue.labels.update`, `issue.assignees.update`, `issue.milestone.set`, `issue.comments.create`, `issue.linked_prs.list`, `issue.relations.get`, `issue.parent.set`, `issue.parent.remove`, `issue.blocked_by.add`, `issue.blocked_by.remove`
 
-- `GITHUB_TOKEN` or `GH_TOKEN` (required)
-- `GITHUB_GRAPHQL_URL` (optional override)
-- `GH_HOST` (optional; used to derive enterprise GraphQL endpoint)
-
-## Built-in Capabilities
-
-- `repo.view` - fetch repository metadata
-- `issue.view` - fetch a single issue
-- `issue.list` - list repository issues
-- `issue.comments.list` - list issue comments with pagination
-- `pr.view` - fetch a single pull request
-- `pr.list` - list pull requests
-- `pr.comments.list` - list pull request review threads/comments
-- `pr.reviews.list` - list pull request reviews
-- `pr.diff.list_files` - list changed files in a pull request
-- `pr.status.checks` - list pull request checks and summary counts
-- `pr.checks.get_failed` - list failed pull request checks
-- `pr.mergeability.view` - fetch mergeability and review decision signals
-- `pr.comment.reply` - reply to a pull request review thread
-- `pr.comment.resolve` - resolve a pull request review thread
-- `pr.comment.unresolve` - unresolve a pull request review thread
-- `pr.ready_for_review.set` - mark draft/ready-for-review state
-- `check_run.annotations.list` - list check run annotations
-- `workflow_runs.list` - list workflow runs for a repository
-- `workflow_run.jobs.list` - list jobs for a workflow run
-- `workflow_job.logs.get` - fetch workflow job logs
-- `workflow_job.logs.analyze` - analyze workflow job logs for error/warning summaries
+**Pull Requests (read)** -- `pr.view`, `pr.list`, `pr.comments.list`, `pr.reviews.list`, `pr.diff.list_files`, `pr.status.checks`, `pr.checks.get_failed`, `pr.mergeability.view`
 
-## Public Exports
+**Pull Requests (execute)** -- `pr.comment.reply`, `pr.comment.resolve`, `pr.comment.unresolve`, `pr.ready_for_review.set`, `pr.review.submit_approve`, `pr.review.submit_request_changes`, `pr.review.submit_comment`, `pr.merge.execute`, `pr.checks.rerun_failed`, `pr.checks.rerun_all`, `pr.reviewers.request`, `pr.assignees.update`, `pr.branch.update`
 
-Root (`@ghx-dev/core`):
+**CI Diagnostics** -- `check_run.annotations.list`, `workflow_runs.list`, `workflow_run.jobs.list`, `workflow_job.logs.get`, `workflow_job.logs.analyze`
 
-- `executeTask`
-- `createGithubClient`, `createGraphqlClient`
-- `listOperationCards`, `getOperationCard`
-- `createSafeCliCommandRunner`
-- core result/task types (`TaskRequest`, `ResultEnvelope`, `ResultError`, `ResultMeta`, `AttemptMeta`, `RouteSource`, `RouteReasonCode`)
+**Releases** -- `release.list`, `release.get`, `release.create_draft`, `release.update`, `release.publish_draft`
 
-Subpaths:
+**Workflow Controls** -- `workflow.list`, `workflow.get`, `workflow_dispatch.run`, `workflow_run.get`, `workflow_run.rerun_failed`, `workflow_run.rerun_all`, `workflow_run.cancel`, `workflow_run.artifacts.list`
 
-- `@ghx-dev/core/agent` - agent tooling exports
-- `@ghx-dev/core/cli` - CLI entrypoint
+**Projects v2** -- `project_v2.org.get`, `project_v2.user.get`, `project_v2.fields.list`, `project_v2.items.list`, `project_v2.item.add_issue`, `project_v2.item.field.update`
+
+For exact input/output contracts, see the [operation card registry](https://github.com/aryeko/ghx/tree/main/packages/core/src/core/registry/cards).
 
 ## Result Envelope
 
@@ -180,7 +183,7 @@ type ResultEnvelope<TData = unknown> = {
   ok: boolean
   data?: TData
   error?: {
-    code: string
+    code: string      // AUTH, NOT_FOUND, RATE_LIMIT, VALIDATION, ...
     message: string
     retryable: boolean
     details?: Record<string, unknown>
@@ -199,13 +202,77 @@ type ResultEnvelope<TData = unknown> = {
 }
 ```
 
+## Environment Variables
+
+- `GITHUB_TOKEN` or `GH_TOKEN` (required)
+- `GITHUB_GRAPHQL_URL` (optional; override GraphQL endpoint)
+- `GH_HOST` (optional; derives enterprise GraphQL endpoint)
+
+## Security and Permissions
+
+- Start with least privilege and grant only what your capability set needs.
+- For quick local testing, a classic PAT with `repo` scope is the simplest route.
+- For production agents, prefer fine-grained tokens with read permissions first (`Metadata`, `Contents`, `Pull requests`, `Issues`, `Actions`, `Projects`) and add writes only where needed.
+
+## Compatibility
+
+- Node.js `22+`
+- GitHub Cloud and GitHub Enterprise hosts (`GH_HOST` supported)
+- Route adapters: CLI and GraphQL
+
+## Public Exports
+
+Root (`@ghx-dev/core`):
+
+- `executeTask` -- run a capability
+- `createGithubClientFromToken` -- create a client from a token string
+- `createGithubClient`, `createGraphqlClient` -- create clients from a custom transport
+- `listOperationCards`, `getOperationCard` -- inspect capability registry
+- `createSafeCliCommandRunner` -- custom CLI execution
+- Types: `TaskRequest`, `ResultEnvelope`, `ResultError`, `ResultMeta`, `AttemptMeta`, `RouteSource`, `RouteReasonCode`, `TokenClientOptions`
+
+Subpaths:
+
+- `@ghx-dev/core/agent` -- `createExecuteTool`, `listCapabilities`, `explainCapability`, `MAIN_SKILL_TEXT`
+- `@ghx-dev/core/cli` -- CLI entrypoint
+
+## Custom GraphQL Transport
+
+For full control over the GraphQL layer, pass your own transport to `createGithubClient`:
+
+```ts
+import { createGithubClient, executeTask } from "@ghx-dev/core"
+
+const githubClient = createGithubClient({
+  async execute<TData>(query: string, variables?: Record<string, unknown>): Promise<TData> {
+    const response = await fetch("https://api.github.com/graphql", {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${process.env.GITHUB_TOKEN}`,
+      },
+      body: JSON.stringify({ query, variables: variables ?? {} }),
+    })
+    const payload = (await response.json()) as { data?: TData; errors?: Array<{ message?: string }> }
+    if (payload.errors?.length) throw new Error(payload.errors[0]?.message ?? "GraphQL error")
+    if (payload.data === undefined) throw new Error("GraphQL response missing data")
+    return payload.data
+  },
+})
+
+const result = await executeTask(
+  { task: "repo.view", input: { owner: "aryeko", name: "ghx" } },
+  { githubClient, githubToken: process.env.GITHUB_TOKEN },
+)
+```
+
 ## Documentation
 
-- Architecture overview: https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/ARCHITECTURE.md
-- Module map: https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/MODULES.md
-- File map: https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/FILES.md
-- Adding capabilities: https://github.com/aryeko/ghx/blob/main/docs/guides/adding-a-capability.md
-- Publishing guide: https://github.com/aryeko/ghx/blob/main/docs/guides/publishing.md
+- [Architecture overview](https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/ARCHITECTURE.md)
+- [Module map](https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/MODULES.md)
+- [File map](https://github.com/aryeko/ghx/blob/main/docs/CODEMAPS/FILES.md)
+- [Operation card registry](https://github.com/aryeko/ghx/blob/main/docs/architecture/operation-card-registry.md)
+- [Publishing guide](https://github.com/aryeko/ghx/blob/main/docs/guides/publishing.md)
 
 ## License
 

package/dist/agent.d.ts

@@ -1,7 +1,32 @@
-export { MAIN_SKILL_TEXT } from './agent-interface/prompt/main-skill.js';
-export { explainCapability } from './agent-interface/tools/explain-tool.js';
-export { createExecuteTool } from './agent-interface/tools/execute-tool.js';
-export { listCapabilities } from './agent-interface/tools/list-capabilities-tool.js';
-import './core/contracts/envelope.js';
-import './core/routing/reason-codes.js';
-import './core/errors/codes.js';
+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,17 +1,34 @@
 import {
-  createExecuteTool
-} from "./chunk-DJIEG6K7.js";
-import {
-  explainCapability
-} from "./chunk-MMG6CIKK.js";
-import {
+  explainCapability,
   listCapabilities
-} from "./chunk-3RJCF42N.js";
-import "./chunk-MT4U5DYD.js";
-import "./chunk-2W4L5YCC.js";
-import {
-  MAIN_SKILL_TEXT
-} from "./chunk-FXN6IIT5.js";
+} from "./chunk-SCIJMW5P.js";
+import "./chunk-OL4ARD3R.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,

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"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({\n        ...request,\n      })\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;AAAA,QACtB,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/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/cards/issue.assignees.update.yaml

@@ -0,0 +1,27 @@
+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.blocked_by.add.yaml

@@ -0,0 +1,23 @@
+capability_id: issue.blocked_by.add
+version: "1.0.0"
+description: Add a blocked-by relation for an issue.
+input_schema:
+  type: object
+  required: [issueId, blockedByIssueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    blockedByIssueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [issueId, blockedByIssueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    blockedByIssueId: { type: string, minLength: 1 }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueBlockedByAdd
+  documentPath: src/gql/operations/issue-blocked-by-add.graphql

package/dist/cards/issue.blocked_by.remove.yaml

@@ -0,0 +1,24 @@
+capability_id: issue.blocked_by.remove
+version: "1.0.0"
+description: Remove a blocked-by relation for an issue.
+input_schema:
+  type: object
+  required: [issueId, blockedByIssueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    blockedByIssueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [issueId, blockedByIssueId, removed]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    blockedByIssueId: { type: string, minLength: 1 }
+    removed: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueBlockedByRemove
+  documentPath: src/gql/operations/issue-blocked-by-remove.graphql

package/dist/cards/issue.close.yaml

@@ -0,0 +1,24 @@
+capability_id: issue.close
+version: "1.0.0"
+description: Close an issue.
+input_schema:
+  type: object
+  required: [issueId]
+  properties:
+    issueId: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, number, state, closed]
+  properties:
+    id: { type: string, minLength: 1 }
+    number: { type: integer, minimum: 1 }
+    state: { type: string }
+    closed: { type: boolean }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueClose
+  documentPath: src/gql/operations/issue-close.graphql

package/dist/cards/issue.comments.create.yaml

@@ -0,0 +1,24 @@
+capability_id: issue.comments.create
+version: "1.0.0"
+description: Create an issue comment.
+input_schema:
+  type: object
+  required: [issueId, body]
+  properties:
+    issueId: { type: string, minLength: 1 }
+    body: { type: string, minLength: 1 }
+  additionalProperties: false
+output_schema:
+  type: object
+  required: [id, body, url]
+  properties:
+    id: { type: string, minLength: 1 }
+    body: { type: string }
+    url: { type: string }
+  additionalProperties: false
+routing:
+  preferred: graphql
+  fallbacks: []
+graphql:
+  operationName: IssueCommentCreate
+  documentPath: src/gql/operations/issue-comment-create.graphql