@ghx-dev/core 0.1.0 → 0.1.2

package/dist/{chunk-JH6GM6XU.js → chunk-UN5YHUNK.js}

@@ -1,14 +1,126 @@
-import {
-  operationCardSchema
-} from "./chunk-2W4L5YCC.js";
-
 // src/core/registry/index.ts
 import { readdirSync, readFileSync } from "fs";
 import { dirname, extname, join } from "path";
 import { fileURLToPath } from "url";
-import Ajv from "ajv";
 import { load as parseYaml } from "js-yaml";
+
+// src/core/registry/ajv-instance.ts
+import { Ajv } from "ajv";
 var ajv = new Ajv({ allErrors: true, strict: false });
+
+// src/core/registry/operation-card-schema.ts
+var operationCardSchema = {
+  $id: "https://ghx.local/schemas/operation-card.json",
+  type: "object",
+  required: ["capability_id", "version", "description", "input_schema", "output_schema", "routing"],
+  properties: {
+    capability_id: { type: "string", minLength: 1 },
+    version: { type: "string", minLength: 1 },
+    description: { type: "string", minLength: 1 },
+    input_schema: { type: "object" },
+    output_schema: { type: "object" },
+    routing: {
+      type: "object",
+      required: ["preferred", "fallbacks"],
+      properties: {
+        preferred: { enum: ["cli", "graphql", "rest"] },
+        fallbacks: {
+          type: "array",
+          items: { enum: ["cli", "graphql", "rest"] }
+        },
+        suitability: {
+          type: "array",
+          items: {
+            type: "object",
+            required: ["when", "predicate", "reason"],
+            properties: {
+              when: { enum: ["always", "env", "params"] },
+              predicate: { type: "string", minLength: 1 },
+              reason: { type: "string", minLength: 1 }
+            },
+            additionalProperties: false
+          }
+        },
+        notes: {
+          type: "array",
+          items: { type: "string" }
+        }
+      },
+      additionalProperties: false
+    },
+    graphql: {
+      type: "object",
+      required: ["operationName", "documentPath"],
+      properties: {
+        operationName: { type: "string", minLength: 1 },
+        documentPath: { type: "string", minLength: 1 },
+        variables: { type: "object" },
+        limits: {
+          type: "object",
+          properties: {
+            maxPageSize: { type: "number" }
+          },
+          additionalProperties: false
+        }
+      },
+      additionalProperties: false
+    },
+    cli: {
+      type: "object",
+      required: ["command"],
+      properties: {
+        command: { type: "string", minLength: 1 },
+        jsonFields: {
+          type: "array",
+          items: { type: "string", minLength: 1 }
+        },
+        jq: { type: "string" },
+        limits: {
+          type: "object",
+          properties: {
+            maxItemsPerCall: { type: "number" }
+          },
+          additionalProperties: false
+        }
+      },
+      additionalProperties: false
+    },
+    rest: {
+      type: "object",
+      required: ["endpoints"],
+      properties: {
+        endpoints: {
+          type: "array",
+          items: {
+            type: "object",
+            required: ["method", "path"],
+            properties: {
+              method: { type: "string" },
+              path: { type: "string" }
+            },
+            additionalProperties: false
+          }
+        }
+      },
+      additionalProperties: false
+    },
+    examples: {
+      type: "array",
+      items: {
+        type: "object",
+        required: ["title", "input"],
+        properties: {
+          title: { type: "string" },
+          input: { type: "object" }
+        },
+        additionalProperties: false
+      }
+    }
+  },
+  additionalProperties: false
+};
+
+// src/core/registry/index.ts
 var validateCard = ajv.compile(operationCardSchema);
 function cardDirectory() {
   const currentDir = dirname(fileURLToPath(import.meta.url));
@@ -126,8 +238,8 @@ function getOperationCard(capabilityId) {
 }
 
 export {
-  validateOperationCard,
+  ajv,
   listOperationCards,
   getOperationCard
 };
-//# sourceMappingURL=chunk-JH6GM6XU.js.map
+//# sourceMappingURL=chunk-UN5YHUNK.js.map

package/dist/chunk-UN5YHUNK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/registry/index.ts","../src/core/registry/ajv-instance.ts","../src/core/registry/operation-card-schema.ts"],"sourcesContent":["import { readdirSync, readFileSync } from \"node:fs\"\nimport { dirname, extname, join } from \"node:path\"\nimport { fileURLToPath } from \"node:url\"\n\nimport { load as parseYaml } from \"js-yaml\"\nimport { ajv } from \"./ajv-instance.js\"\nimport { operationCardSchema } from \"./operation-card-schema.js\"\nimport type { OperationCard } from \"./types.js\"\n\nconst validateCard = ajv.compile(operationCardSchema)\n\nfunction cardDirectory(): string {\n  const currentDir = dirname(fileURLToPath(import.meta.url))\n  return join(currentDir, \"cards\")\n}\n\nfunction loadCardsFromYaml(): OperationCard[] {\n  const directory = cardDirectory()\n  const preferredOrder = [\n    \"repo.view\",\n    \"repo.labels.list\",\n    \"repo.issue_types.list\",\n    \"issue.view\",\n    \"issue.list\",\n    \"issue.comments.list\",\n    \"issue.create\",\n    \"issue.update\",\n    \"issue.close\",\n    \"issue.reopen\",\n    \"issue.delete\",\n    \"issue.labels.update\",\n    \"issue.assignees.update\",\n    \"issue.milestone.set\",\n    \"issue.comments.create\",\n    \"issue.linked_prs.list\",\n    \"issue.relations.get\",\n    \"issue.parent.set\",\n    \"issue.parent.remove\",\n    \"issue.blocked_by.add\",\n    \"issue.blocked_by.remove\",\n    \"pr.view\",\n    \"pr.list\",\n    \"pr.comments.list\",\n    \"pr.reviews.list\",\n    \"pr.diff.list_files\",\n    \"pr.status.checks\",\n    \"pr.checks.get_failed\",\n    \"pr.mergeability.view\",\n    \"pr.comment.reply\",\n    \"pr.comment.resolve\",\n    \"pr.comment.unresolve\",\n    \"pr.ready_for_review.set\",\n    \"pr.review.submit_approve\",\n    \"pr.review.submit_request_changes\",\n    \"pr.review.submit_comment\",\n    \"pr.merge.execute\",\n    \"pr.checks.rerun_failed\",\n    \"pr.checks.rerun_all\",\n    \"pr.reviewers.request\",\n    \"pr.assignees.update\",\n    \"pr.branch.update\",\n    \"check_run.annotations.list\",\n    \"workflow_runs.list\",\n    \"workflow_run.jobs.list\",\n    \"workflow_job.logs.get\",\n    \"workflow_job.logs.analyze\",\n    \"workflow.list\",\n    \"workflow.get\",\n    \"workflow_run.get\",\n    \"workflow_run.rerun_all\",\n    \"workflow_run.cancel\",\n    \"workflow_run.artifacts.list\",\n    \"project_v2.org.get\",\n    \"project_v2.user.get\",\n    \"project_v2.fields.list\",\n    \"project_v2.items.list\",\n    \"project_v2.item.add_issue\",\n    \"project_v2.item.field.update\",\n    \"release.list\",\n    \"release.get\",\n    \"release.create_draft\",\n    \"release.update\",\n    \"release.publish_draft\",\n    \"workflow_dispatch.run\",\n    \"workflow_run.rerun_failed\",\n  ]\n  const orderMap = new Map(preferredOrder.map((id, index) => [id, index]))\n\n  const entries = readdirSync(directory)\n    .filter((entry) => {\n      const extension = extname(entry).toLowerCase()\n      return extension === \".yaml\" || extension === \".yml\"\n    })\n    .sort((a, b) => {\n      const capabilityA = a.replace(/\\.ya?ml$/i, \"\")\n      const capabilityB = b.replace(/\\.ya?ml$/i, \"\")\n      const orderA = orderMap.get(capabilityA) ?? Number.MAX_SAFE_INTEGER\n      const orderB = orderMap.get(capabilityB) ?? Number.MAX_SAFE_INTEGER\n\n      if (orderA !== orderB) {\n        return orderA - orderB\n      }\n\n      return a.localeCompare(b)\n    })\n\n  return entries.map((entry): OperationCard => {\n    const filePath = join(directory, entry)\n    const raw = readFileSync(filePath, \"utf8\")\n    const parsed = parseYaml(raw)\n    const validation = validateOperationCard(parsed)\n    if (!validation.ok) {\n      throw new Error(`Invalid operation card '${entry}': ${validation.error}`)\n    }\n\n    return parsed as OperationCard\n  })\n}\n\nexport function validateOperationCard(card: unknown): { ok: true } | { ok: false; error: string } {\n  const valid = validateCard(card)\n  if (!valid) {\n    const message = validateCard.errors?.[0]?.message ?? \"Operation card schema validation failed\"\n    return { ok: false, error: message }\n  }\n\n  return { ok: true }\n}\n\nconst operationCards = loadCardsFromYaml()\n\nexport function listOperationCards(): OperationCard[] {\n  return [...operationCards]\n}\n\nexport function getOperationCard(capabilityId: string): OperationCard | undefined {\n  return operationCards.find((card) => card.capability_id === capabilityId)\n}\n","import { Ajv } from \"ajv\"\n\nexport const ajv = new Ajv({ allErrors: true, strict: false })\n","export const operationCardSchema = {\n  $id: \"https://ghx.local/schemas/operation-card.json\",\n  type: \"object\",\n  required: [\"capability_id\", \"version\", \"description\", \"input_schema\", \"output_schema\", \"routing\"],\n  properties: {\n    capability_id: { type: \"string\", minLength: 1 },\n    version: { type: \"string\", minLength: 1 },\n    description: { type: \"string\", minLength: 1 },\n    input_schema: { type: \"object\" },\n    output_schema: { type: \"object\" },\n    routing: {\n      type: \"object\",\n      required: [\"preferred\", \"fallbacks\"],\n      properties: {\n        preferred: { enum: [\"cli\", \"graphql\", \"rest\"] },\n        fallbacks: {\n          type: \"array\",\n          items: { enum: [\"cli\", \"graphql\", \"rest\"] },\n        },\n        suitability: {\n          type: \"array\",\n          items: {\n            type: \"object\",\n            required: [\"when\", \"predicate\", \"reason\"],\n            properties: {\n              when: { enum: [\"always\", \"env\", \"params\"] },\n              predicate: { type: \"string\", minLength: 1 },\n              reason: { type: \"string\", minLength: 1 },\n            },\n            additionalProperties: false,\n          },\n        },\n        notes: {\n          type: \"array\",\n          items: { type: \"string\" },\n        },\n      },\n      additionalProperties: false,\n    },\n    graphql: {\n      type: \"object\",\n      required: [\"operationName\", \"documentPath\"],\n      properties: {\n        operationName: { type: \"string\", minLength: 1 },\n        documentPath: { type: \"string\", minLength: 1 },\n        variables: { type: \"object\" },\n        limits: {\n          type: \"object\",\n          properties: {\n            maxPageSize: { type: \"number\" },\n          },\n          additionalProperties: false,\n        },\n      },\n      additionalProperties: false,\n    },\n    cli: {\n      type: \"object\",\n      required: [\"command\"],\n      properties: {\n        command: { type: \"string\", minLength: 1 },\n        jsonFields: {\n          type: \"array\",\n          items: { type: \"string\", minLength: 1 },\n        },\n        jq: { type: \"string\" },\n        limits: {\n          type: \"object\",\n          properties: {\n            maxItemsPerCall: { type: \"number\" },\n          },\n          additionalProperties: false,\n        },\n      },\n      additionalProperties: false,\n    },\n    rest: {\n      type: \"object\",\n      required: [\"endpoints\"],\n      properties: {\n        endpoints: {\n          type: \"array\",\n          items: {\n            type: \"object\",\n            required: [\"method\", \"path\"],\n            properties: {\n              method: { type: \"string\" },\n              path: { type: \"string\" },\n            },\n            additionalProperties: false,\n          },\n        },\n      },\n      additionalProperties: false,\n    },\n    examples: {\n      type: \"array\",\n      items: {\n        type: \"object\",\n        required: [\"title\", \"input\"],\n        properties: {\n          title: { type: \"string\" },\n          input: { type: \"object\" },\n        },\n        additionalProperties: false,\n      },\n    },\n  },\n  additionalProperties: false,\n} as const\n"],"mappings":"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","names":[]}

package/dist/cli/assets/skills/ghx/SKILL.md

@@ -0,0 +1,57 @@
+# ghx CLI Skill
+
+Use `ghx` as the default interface for supported GitHub operations.
+
+## Session Bootstrap (run once)
+
+```bash
+gh auth status
+ghx capabilities list
+```
+
+If authentication fails, stop and request authentication before continuing.
+
+## Workflow
+
+1. Choose a capability from `ghx capabilities list`.
+2. If required inputs are unclear, inspect the capability:
+
+```bash
+ghx capabilities explain <capability_id>
+```
+
+3. Execute with structured JSON input:
+
+```bash
+ghx run <capability_id> --input '<json>'
+```
+
+## Result Handling Rules
+
+`ghx run` returns a result envelope: `{ ok, data, error, meta }`.
+
+- Check `ok` first.
+- If `ok=true`, use `data`.
+- If `ok=false`, read `error.code` and `error.message`.
+- If `error.retryable=true`, retry once.
+- For supported operations, do not parse raw `gh` output.
+
+## Input Conventions
+
+- Repository identity is `owner` + `name`.
+- Do not guess input fields; run `ghx capabilities explain <capability_id>`.
+
+## Examples
+
+```bash
+ghx run repo.view --input '{"owner":"octocat","name":"hello-world"}'
+ghx run issue.create --input '{"owner":"octocat","name":"hello-world","title":"Bug report","body":"Steps to reproduce"}'
+ghx run pr.view --input '{"owner":"octocat","name":"hello-world","prNumber":42}'
+ghx run pr.checks.get_failed --input '{"owner":"octocat","name":"hello-world","prNumber":42}'
+```
+
+## Guardrails
+
+- Prefer `ghx` over direct `gh` or API calls for supported operations.
+- Treat `meta.route_used` as informational only.
+- If a required input is unknown, ask the user instead of guessing.

package/dist/cli/index.js

@@ -1,50 +1,382 @@
 #!/usr/bin/env node
 import {
-  setupCommand
-} from "../chunk-MGNGSGMF.js";
+  explainCapability,
+  listCapabilities
+} from "../chunk-2FCPR3XZ.js";
 import {
-  capabilitiesExplainCommand
-} from "../chunk-HQ2VRCH7.js";
-import {
-  capabilitiesListCommand
-} from "../chunk-SJR2SACI.js";
-import {
-  runCommand
-} from "../chunk-22WWCK6A.js";
-import "../chunk-4PLVKNCF.js";
-import "../chunk-GMTG7X2L.js";
-import "../chunk-SD7U4BNA.js";
-import "../chunk-DLKIQBK6.js";
-import "../chunk-SA2D4A5U.js";
-import "../chunk-XNMM64WU.js";
-import "../chunk-UGWIZ3RI.js";
-import "../chunk-B6RLMKS4.js";
-import "../chunk-573MDG3I.js";
-import "../chunk-3MRJX72M.js";
-import "../chunk-5JRLVOF2.js";
-import "../chunk-W2TKG2UL.js";
-import "../chunk-QEAMC4IJ.js";
-import "../chunk-TDTKOJKN.js";
-import "../chunk-UOJWOHRM.js";
-import "../chunk-JH6GM6XU.js";
-import "../chunk-2W4L5YCC.js";
-import "../chunk-JLDU462R.js";
-import "../chunk-EBRDO4Y6.js";
-import "../chunk-RUQXGZ35.js";
-import "../chunk-TCLMLVUQ.js";
-import "../chunk-VD5NXQP7.js";
-import "../chunk-NFF5VF4U.js";
-import "../chunk-D746VR3B.js";
-import "../chunk-W6ROKCY5.js";
-import "../chunk-QZZC53HF.js";
+  createGithubClient,
+  errorCodes,
+  executeTask
+} from "../chunk-RDUPMVHG.js";
+import "../chunk-UN5YHUNK.js";
 
 // src/cli/index.ts
 import { realpathSync } from "fs";
 import { pathToFileURL } from "url";
+
+// src/cli/commands/capabilities-explain.ts
 function usage() {
+  return "Usage: ghx capabilities explain <capability_id> [--json]";
+}
+function parseArgs(argv) {
+  const asJson = argv.includes("--json");
+  const capabilityId = argv.find((arg) => !arg.startsWith("-"));
+  return { capabilityId, asJson };
+}
+async function capabilitiesExplainCommand(argv = []) {
+  const { capabilityId, asJson } = parseArgs(argv);
+  if (!capabilityId) {
+    process.stderr.write(`${usage()}
+`);
+    return 1;
+  }
+  try {
+    const explained = explainCapability(capabilityId);
+    if (asJson) {
+      process.stdout.write(`${JSON.stringify(explained)}
+`);
+      return 0;
+    }
+    process.stdout.write(`${JSON.stringify(explained, null, 2)}
+`);
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}
+`);
+    return 1;
+  }
+}
+
+// src/cli/commands/capabilities-list.ts
+function parseArgs2(argv) {
+  return {
+    asJson: argv.includes("--json")
+  };
+}
+async function capabilitiesListCommand(argv = []) {
+  const { asJson } = parseArgs2(argv);
+  const capabilities = listCapabilities();
+  if (asJson) {
+    process.stdout.write(`${JSON.stringify(capabilities)}
+`);
+    return 0;
+  }
+  const lines = capabilities.map((item) => `${item.capability_id} - ${item.description}`);
+  process.stdout.write(`${lines.join("\n")}
+`);
+  return 0;
+}
+
+// src/cli/commands/run.ts
+var GITHUB_GRAPHQL_ENDPOINT = "https://api.github.com/graphql";
+function parseRunArgs(argv) {
+  const [task, ...rest] = argv;
+  if (!task || task.trim().length === 0) {
+    throw new Error("Usage: ghx run <task> --input '<json>' [--check-gh-preflight]");
+  }
+  const inputIndex = rest.findIndex((arg) => arg === "--input");
+  const inlineInput = rest.find((arg) => arg.startsWith("--input="));
+  const inputCandidate = inputIndex >= 0 ? rest[inputIndex + 1] : void 0;
+  const inputRaw = inputCandidate && !inputCandidate.startsWith("--") ? inputCandidate : inlineInput ? inlineInput.slice("--input=".length) : void 0;
+  if (!inputRaw) {
+    throw new Error("Missing --input JSON");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(inputRaw);
+  } catch {
+    throw new Error("Invalid JSON for --input");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("--input must be a JSON object");
+  }
+  const skipGhPreflight = !rest.includes("--check-gh-preflight");
+  return { task, input: parsed, skipGhPreflight };
+}
+function resolveGithubToken() {
+  const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+  if (!token || token.trim().length === 0) {
+    throw new Error("Missing GITHUB_TOKEN or GH_TOKEN for GraphQL transport");
+  }
+  return token;
+}
+async function executeGraphqlRequest(token, query, variables) {
+  const response = await fetch(GITHUB_GRAPHQL_ENDPOINT, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      accept: "application/json",
+      authorization: `Bearer ${token}`,
+      "user-agent": "ghx"
+    },
+    body: JSON.stringify({ query, variables: variables ?? {} })
+  });
+  const payload = await response.json();
+  if (!response.ok) {
+    const message = payload.message ?? `GitHub GraphQL request failed with status ${response.status}`;
+    throw new Error(message);
+  }
+  if (Array.isArray(payload.errors) && payload.errors.length > 0) {
+    const message = payload.errors[0]?.message ?? "GitHub GraphQL returned errors";
+    throw new Error(message);
+  }
+  if (payload.data === void 0) {
+    throw new Error("GitHub GraphQL response missing data");
+  }
+  return payload.data;
+}
+async function runCommand(argv = []) {
+  if (argv.length === 0) {
+    process.stdout.write("Usage: ghx run <task> --input '<json>' [--check-gh-preflight]\n");
+    return 1;
+  }
+  const { task, input, skipGhPreflight } = parseRunArgs(argv);
+  const githubToken = resolveGithubToken();
+  const githubClient = createGithubClient({
+    async execute(query, variables) {
+      return executeGraphqlRequest(githubToken, query, variables);
+    }
+  });
+  const request = {
+    task,
+    input
+  };
+  const result = await executeTask(request, {
+    githubClient,
+    githubToken,
+    skipGhPreflight
+  });
+  process.stdout.write(`${JSON.stringify(result)}
+`);
+  return 0;
+}
+
+// src/cli/commands/setup.ts
+import { access, appendFile, mkdir, readFile, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import readline from "readline/promises";
+import { fileURLToPath } from "url";
+import { Ajv } from "ajv";
+var ajv = new Ajv({ allErrors: true, strict: false });
+var setupOptionsSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["scope", "assumeYes", "dryRun", "verifyOnly", "track"],
+  properties: {
+    scope: {
+      type: "string",
+      enum: ["user", "project"]
+    },
+    assumeYes: { type: "boolean" },
+    dryRun: { type: "boolean" },
+    verifyOnly: { type: "boolean" },
+    track: { type: "boolean" }
+  }
+};
+var validateSetupOptions = ajv.compile(setupOptionsSchema);
+var setupCommandDirectory = dirname(fileURLToPath(import.meta.url));
+var setupSkillAssetPathCandidates = [
+  join(setupCommandDirectory, "..", "assets", "skills", "ghx", "SKILL.md"),
+  join(setupCommandDirectory, "assets", "skills", "ghx", "SKILL.md"),
+  join(setupCommandDirectory, "cli", "assets", "skills", "ghx", "SKILL.md")
+];
+function isENOENT(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function createSetupError(message, code) {
+  const error = new Error(message);
+  error.code = code;
+  return error;
+}
+async function loadSetupSkillContent() {
+  for (const candidatePath of setupSkillAssetPathCandidates) {
+    try {
+      return await readFile(candidatePath, "utf8");
+    } catch (error) {
+      if (isENOENT(error)) {
+        continue;
+      }
+      throw error;
+    }
+  }
+  throw createSetupError(
+    `Setup skill asset not found. Checked: ${setupSkillAssetPathCandidates.join(", ")}`,
+    errorCodes.NotFound
+  );
+}
+function usage2() {
+  return "Usage: ghx setup --scope <user|project> [--yes] [--dry-run] [--verify] [--track]";
+}
+function parseScope(argv) {
+  const inline = argv.find((arg) => arg.startsWith("--scope="));
+  if (inline) {
+    const raw = inline.slice("--scope=".length);
+    if (raw === "user" || raw === "project") {
+      return raw;
+    }
+    return void 0;
+  }
+  const scopeIndex = argv.findIndex((arg) => arg === "--scope");
+  if (scopeIndex < 0) {
+    return void 0;
+  }
+  const value = argv[scopeIndex + 1];
+  if (value === "user" || value === "project") {
+    return value;
+  }
+  return void 0;
+}
+function parseArgs3(argv) {
+  const scope = parseScope(argv);
+  if (!scope) {
+    return null;
+  }
+  const options = {
+    scope,
+    assumeYes: argv.includes("--yes"),
+    dryRun: argv.includes("--dry-run"),
+    verifyOnly: argv.includes("--verify"),
+    track: argv.includes("--track")
+  };
+  if (!validateSetupOptions(options)) {
+    return null;
+  }
+  return options;
+}
+function resolveSkillPath(scope) {
+  const base = scope === "user" ? homedir() : process.cwd();
+  return join(base, ".agents", "skills", "ghx", "SKILL.md");
+}
+function resolveTrackingPath() {
+  return join(homedir(), ".agents", "ghx", "setup-events.jsonl");
+}
+async function writeTrackingEvent(options) {
+  if (!options.track) {
+    return;
+  }
+  const trackingPath = resolveTrackingPath();
+  await mkdir(join(homedir(), ".agents", "ghx"), { recursive: true });
+  await appendFile(
+    trackingPath,
+    `${JSON.stringify({
+      command: "setup",
+      scope: options.scope,
+      mode: options.mode,
+      success: options.success,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    })}
+`,
+    "utf8"
+  );
+}
+async function confirmOverwrite(skillPath) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return false;
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    const answer = await rl.question(`Skill already exists at ${skillPath}. Overwrite? [y/N] `);
+    const normalized = answer.trim().toLowerCase();
+    return normalized === "y" || normalized === "yes";
+  } finally {
+    rl.close();
+  }
+}
+async function verifySkill(skillPath) {
+  try {
+    const content = await readFile(skillPath, "utf8");
+    return content.includes("ghx capabilities");
+  } catch (error) {
+    if (isENOENT(error)) {
+      return false;
+    }
+    throw error;
+  }
+}
+async function skillFileExists(skillPath) {
+  try {
+    await access(skillPath);
+    return true;
+  } catch (error) {
+    if (isENOENT(error)) {
+      return false;
+    }
+    throw error;
+  }
+}
+async function setupCommand(argv = []) {
+  const parsed = parseArgs3(argv);
+  if (!parsed) {
+    process.stderr.write(`${usage2()}
+`);
+    return 1;
+  }
+  const skillPath = resolveSkillPath(parsed.scope);
+  try {
+    if (parsed.verifyOnly) {
+      const ok = await verifySkill(skillPath);
+      if (!ok) {
+        process.stderr.write(`Verify failed: skill not installed at ${skillPath}
+`);
+        return 1;
+      }
+      process.stdout.write(`Verify passed: skill installed at ${skillPath}
+`);
+      return 0;
+    }
+    if (parsed.dryRun) {
+      process.stdout.write(`Dry run: would write ${skillPath}
+`);
+      return 0;
+    }
+    const alreadyExists = await skillFileExists(skillPath);
+    if (alreadyExists && !parsed.assumeYes) {
+      const approved = await confirmOverwrite(skillPath);
+      if (!approved) {
+        process.stderr.write(
+          `Skill already exists at ${skillPath}. Re-run with --yes or confirm overwrite interactively.
+`
+        );
+        await writeTrackingEvent({
+          track: parsed.track,
+          scope: parsed.scope,
+          mode: "apply",
+          success: false
+        });
+        return 1;
+      }
+    }
+    const skillContent = await loadSetupSkillContent();
+    await mkdir(dirname(skillPath), { recursive: true });
+    await writeFile(skillPath, skillContent, "utf8");
+    process.stdout.write(`Setup complete: wrote ${skillPath}
+`);
+    process.stdout.write("Try: ghx capabilities list\n");
+    await writeTrackingEvent({
+      track: parsed.track,
+      scope: parsed.scope,
+      mode: "apply",
+      success: true
+    });
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Setup failed: ${message}
+`);
+    return 1;
+  }
+}
+
+// src/cli/index.ts
+function usage3() {
   return [
     "Usage:",
-    "  ghx run <task> --input '<json>'",
+    "  ghx run <task> --input '<json>' [--check-gh-preflight]",
     "  ghx setup --scope <user|project> [--yes] [--dry-run] [--verify] [--track]",
     "  ghx capabilities list",
     "  ghx capabilities explain <capability_id>"
@@ -53,7 +385,7 @@ function usage() {
 async function main(argv = process.argv.slice(2)) {
   const [command, ...rest] = argv;
   if (!command || command === "--help" || command === "-h") {
-    process.stdout.write(`${usage()}
+    process.stdout.write(`${usage3()}
 `);
     return 0;
   }
@@ -67,7 +399,7 @@ async function main(argv = process.argv.slice(2)) {
     const [subcommand, ...subcommandArgs] = rest;
     if (!subcommand) {
       process.stderr.write(`Missing capabilities subcommand.
-${usage()}
+${usage3()}
 `);
       return 1;
     }
@@ -78,12 +410,12 @@ ${usage()}
       return capabilitiesExplainCommand(subcommandArgs);
     }
     process.stderr.write(`Unknown capabilities subcommand: ${subcommand}
-${usage()}
+${usage3()}
 `);
     return 1;
   }
   process.stderr.write(`Unknown command: ${command}
-${usage()}
+${usage3()}
 `);
   return 1;
 }