@ghx-dev/core 0.1.0 → 0.1.1

package/dist/{chunk-4PLVKNCF.js → chunk-SCIJMW5P.js}

@@ -1,6 +1,7 @@
 import {
-  getOperationCard
-} from "./chunk-JH6GM6XU.js";
+  getOperationCard,
+  listOperationCards
+} from "./chunk-OL4ARD3R.js";
 
 // src/agent-interface/tools/explain-tool.ts
 function extractRequiredInputs(inputSchema) {
@@ -38,7 +39,16 @@ function explainCapability(capabilityId) {
   };
 }
 
+// src/agent-interface/tools/list-capabilities-tool.ts
+function listCapabilities() {
+  return listOperationCards().map((card) => ({
+    capability_id: card.capability_id,
+    description: card.description
+  }));
+}
+
 export {
-  explainCapability
+  explainCapability,
+  listCapabilities
 };
-//# sourceMappingURL=chunk-4PLVKNCF.js.map
+//# sourceMappingURL=chunk-SCIJMW5P.js.map

package/dist/chunk-SCIJMW5P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-interface/tools/explain-tool.ts","../src/agent-interface/tools/list-capabilities-tool.ts"],"sourcesContent":["import { getOperationCard } from \"../../core/registry/index.js\"\n\nexport type CapabilityExplanation = {\n  capability_id: string\n  purpose: string\n  required_inputs: string[]\n  preferred_route: \"cli\" | \"graphql\" | \"rest\"\n  fallback_routes: Array<\"cli\" | \"graphql\" | \"rest\">\n  output_fields: string[]\n}\n\nfunction extractRequiredInputs(inputSchema: Record<string, unknown> | null | undefined): string[] {\n  if (!inputSchema || typeof inputSchema !== \"object\") {\n    return []\n  }\n\n  const required = (inputSchema as Record<string, unknown>).required\n  if (!Array.isArray(required)) {\n    return []\n  }\n\n  return required.filter((entry): entry is string => typeof entry === \"string\")\n}\n\nfunction extractOutputFields(outputSchema: Record<string, unknown> | null | undefined): string[] {\n  if (!outputSchema || typeof outputSchema !== \"object\") {\n    return []\n  }\n\n  const properties = (outputSchema as Record<string, unknown>).properties\n  if (!properties || typeof properties !== \"object\") {\n    return []\n  }\n\n  return Object.keys(properties)\n}\n\nexport function explainCapability(capabilityId: string): CapabilityExplanation {\n  const card = getOperationCard(capabilityId)\n  if (!card) {\n    throw new Error(`Unknown capability: ${capabilityId}`)\n  }\n\n  return {\n    capability_id: card.capability_id,\n    purpose: card.description,\n    required_inputs: extractRequiredInputs(card.input_schema),\n    preferred_route: card.routing.preferred,\n    fallback_routes: [...card.routing.fallbacks],\n    output_fields: extractOutputFields(card.output_schema),\n  }\n}\n","import { listOperationCards } from \"../../core/registry/index.js\"\n\nexport type CapabilityListItem = {\n  capability_id: string\n  description: string\n}\n\nexport function listCapabilities(): CapabilityListItem[] {\n  return listOperationCards().map((card) => ({\n    capability_id: card.capability_id,\n    description: card.description,\n  }))\n}\n"],"mappings":";;;;;;AAWA,SAAS,sBAAsB,aAAmE;AAChG,MAAI,CAAC,eAAe,OAAO,gBAAgB,UAAU;AACnD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAY,YAAwC;AAC1D,MAAI,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC5B,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,SAAS,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ;AAC9E;AAEA,SAAS,oBAAoB,cAAoE;AAC/F,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAAU;AACrD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,aAAc,aAAyC;AAC7D,MAAI,CAAC,cAAc,OAAO,eAAe,UAAU;AACjD,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,OAAO,KAAK,UAAU;AAC/B;AAEO,SAAS,kBAAkB,cAA6C;AAC7E,QAAM,OAAO,iBAAiB,YAAY;AAC1C,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,MAAM,uBAAuB,YAAY,EAAE;AAAA,EACvD;AAEA,SAAO;AAAA,IACL,eAAe,KAAK;AAAA,IACpB,SAAS,KAAK;AAAA,IACd,iBAAiB,sBAAsB,KAAK,YAAY;AAAA,IACxD,iBAAiB,KAAK,QAAQ;AAAA,IAC9B,iBAAiB,CAAC,GAAG,KAAK,QAAQ,SAAS;AAAA,IAC3C,eAAe,oBAAoB,KAAK,aAAa;AAAA,EACvD;AACF;;;AC5CO,SAAS,mBAAyC;AACvD,SAAO,mBAAmB,EAAE,IAAI,CAAC,UAAU;AAAA,IACzC,eAAe,KAAK;AAAA,IACpB,aAAa,KAAK;AAAA,EACpB,EAAE;AACJ;","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-SCIJMW5P.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-PJ2JKKQE.js";
+import "../chunk-OL4ARD3R.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;
 }

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { realpathSync } from \"node:fs\"\nimport { pathToFileURL } from \"node:url\"\n\nimport { capabilitiesExplainCommand } from \"./commands/capabilities-explain.js\"\nimport { capabilitiesListCommand } from \"./commands/capabilities-list.js\"\nimport { runCommand } from \"./commands/run.js\"\nimport { setupCommand } from \"./commands/setup.js\"\n\nfunction usage(): string {\n  return [\n    \"Usage:\",\n    \"  ghx run <task> --input '<json>'\",\n    \"  ghx setup --scope <user|project> [--yes] [--dry-run] [--verify] [--track]\",\n    \"  ghx capabilities list\",\n    \"  ghx capabilities explain <capability_id>\"\n  ].join(\"\\n\")\n}\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<number> {\n  const [command, ...rest] = argv\n\n  if (!command || command === \"--help\" || command === \"-h\") {\n    process.stdout.write(`${usage()}\\n`)\n    return 0\n  }\n\n  if (command === \"run\") {\n    return runCommand(rest)\n  }\n\n  if (command === \"setup\") {\n    return setupCommand(rest)\n  }\n\n  if (command === \"capabilities\") {\n    const [subcommand, ...subcommandArgs] = rest\n\n    if (!subcommand) {\n      process.stderr.write(`Missing capabilities subcommand.\\n${usage()}\\n`)\n      return 1\n    }\n\n    if (subcommand === \"list\") {\n      return capabilitiesListCommand(subcommandArgs)\n    }\n\n    if (subcommand === \"explain\") {\n      return capabilitiesExplainCommand(subcommandArgs)\n    }\n\n    process.stderr.write(`Unknown capabilities subcommand: ${subcommand}\\n${usage()}\\n`)\n    return 1\n  }\n\n  process.stderr.write(`Unknown command: ${command}\\n${usage()}\\n`)\n  return 1\n}\n\nconst isDirectRun = (() => {\n  if (!process.argv[1]) {\n    return false\n  }\n\n  try {\n    const currentEntry = realpathSync(new URL(import.meta.url))\n    const invokedEntry = realpathSync(process.argv[1])\n    return currentEntry === invokedEntry || import.meta.url === pathToFileURL(process.argv[1]).href\n  } catch {\n    return import.meta.url === pathToFileURL(process.argv[1]).href\n  }\n})()\n\nif (isDirectRun) {\n  main().then(\n    (exitCode) => {\n      process.exitCode = exitCode\n    },\n    (error: unknown) => {\n      const message = error instanceof Error ? error.message : String(error)\n      process.stderr.write(`${message}\\n`)\n      process.exit(1)\n    }\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAO9B,SAAS,QAAgB;AACvB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,eAAsB,KAAK,OAAiB,QAAQ,KAAK,MAAM,CAAC,GAAoB;AAClF,QAAM,CAAC,SAAS,GAAG,IAAI,IAAI;AAE3B,MAAI,CAAC,WAAW,YAAY,YAAY,YAAY,MAAM;AACxD,YAAQ,OAAO,MAAM,GAAG,MAAM,CAAC;AAAA,CAAI;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,OAAO;AACrB,WAAO,WAAW,IAAI;AAAA,EACxB;AAEA,MAAI,YAAY,SAAS;AACvB,WAAO,aAAa,IAAI;AAAA,EAC1B;AAEA,MAAI,YAAY,gBAAgB;AAC9B,UAAM,CAAC,YAAY,GAAG,cAAc,IAAI;AAExC,QAAI,CAAC,YAAY;AACf,cAAQ,OAAO,MAAM;AAAA,EAAqC,MAAM,CAAC;AAAA,CAAI;AACrE,aAAO;AAAA,IACT;AAEA,QAAI,eAAe,QAAQ;AACzB,aAAO,wBAAwB,cAAc;AAAA,IAC/C;AAEA,QAAI,eAAe,WAAW;AAC5B,aAAO,2BAA2B,cAAc;AAAA,IAClD;AAEA,YAAQ,OAAO,MAAM,oCAAoC,UAAU;AAAA,EAAK,MAAM,CAAC;AAAA,CAAI;AACnF,WAAO;AAAA,EACT;AAEA,UAAQ,OAAO,MAAM,oBAAoB,OAAO;AAAA,EAAK,MAAM,CAAC;AAAA,CAAI;AAChE,SAAO;AACT;AAEA,IAAM,eAAe,MAAM;AACzB,MAAI,CAAC,QAAQ,KAAK,CAAC,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,eAAe,aAAa,IAAI,IAAI,YAAY,GAAG,CAAC;AAC1D,UAAM,eAAe,aAAa,QAAQ,KAAK,CAAC,CAAC;AACjD,WAAO,iBAAiB,gBAAgB,YAAY,QAAQ,cAAc,QAAQ,KAAK,CAAC,CAAC,EAAE;AAAA,EAC7F,QAAQ;AACN,WAAO,YAAY,QAAQ,cAAc,QAAQ,KAAK,CAAC,CAAC,EAAE;AAAA,EAC5D;AACF,GAAG;AAEH,IAAI,aAAa;AACf,OAAK,EAAE;AAAA,IACL,CAAC,aAAa;AACZ,cAAQ,WAAW;AAAA,IACrB;AAAA,IACA,CAAC,UAAmB;AAClB,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,cAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/capabilities-explain.ts","../../src/cli/commands/capabilities-list.ts","../../src/cli/commands/run.ts","../../src/cli/commands/setup.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { realpathSync } from \"node:fs\"\nimport { pathToFileURL } from \"node:url\"\n\nimport { capabilitiesExplainCommand } from \"./commands/capabilities-explain.js\"\nimport { capabilitiesListCommand } from \"./commands/capabilities-list.js\"\nimport { runCommand } from \"./commands/run.js\"\nimport { setupCommand } from \"./commands/setup.js\"\n\nfunction usage(): string {\n  return [\n    \"Usage:\",\n    \"  ghx run <task> --input '<json>' [--check-gh-preflight]\",\n    \"  ghx setup --scope <user|project> [--yes] [--dry-run] [--verify] [--track]\",\n    \"  ghx capabilities list\",\n    \"  ghx capabilities explain <capability_id>\",\n  ].join(\"\\n\")\n}\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<number> {\n  const [command, ...rest] = argv\n\n  if (!command || command === \"--help\" || command === \"-h\") {\n    process.stdout.write(`${usage()}\\n`)\n    return 0\n  }\n\n  if (command === \"run\") {\n    return runCommand(rest)\n  }\n\n  if (command === \"setup\") {\n    return setupCommand(rest)\n  }\n\n  if (command === \"capabilities\") {\n    const [subcommand, ...subcommandArgs] = rest\n\n    if (!subcommand) {\n      process.stderr.write(`Missing capabilities subcommand.\\n${usage()}\\n`)\n      return 1\n    }\n\n    if (subcommand === \"list\") {\n      return capabilitiesListCommand(subcommandArgs)\n    }\n\n    if (subcommand === \"explain\") {\n      return capabilitiesExplainCommand(subcommandArgs)\n    }\n\n    process.stderr.write(`Unknown capabilities subcommand: ${subcommand}\\n${usage()}\\n`)\n    return 1\n  }\n\n  process.stderr.write(`Unknown command: ${command}\\n${usage()}\\n`)\n  return 1\n}\n\nconst isDirectRun = (() => {\n  if (!process.argv[1]) {\n    return false\n  }\n\n  try {\n    const currentEntry = realpathSync(new URL(import.meta.url))\n    const invokedEntry = realpathSync(process.argv[1])\n    return currentEntry === invokedEntry || import.meta.url === pathToFileURL(process.argv[1]).href\n  } catch {\n    return import.meta.url === pathToFileURL(process.argv[1]).href\n  }\n})()\n\nif (isDirectRun) {\n  main().then(\n    (exitCode) => {\n      process.exitCode = exitCode\n    },\n    (error: unknown) => {\n      const message = error instanceof Error ? error.message : String(error)\n      process.stderr.write(`${message}\\n`)\n      process.exit(1)\n    },\n  )\n}\n","import { explainCapability } from \"../../agent-interface/tools/explain-tool.js\"\n\nfunction usage(): string {\n  return \"Usage: ghx capabilities explain <capability_id> [--json]\"\n}\n\nfunction parseArgs(argv: string[]): { capabilityId: string | undefined; asJson: boolean } {\n  const asJson = argv.includes(\"--json\")\n  const capabilityId = argv.find((arg) => !arg.startsWith(\"-\"))\n  return { capabilityId, asJson }\n}\n\nexport async function capabilitiesExplainCommand(argv: string[] = []): Promise<number> {\n  const { capabilityId, asJson } = parseArgs(argv)\n\n  if (!capabilityId) {\n    process.stderr.write(`${usage()}\\n`)\n    return 1\n  }\n\n  try {\n    const explained = explainCapability(capabilityId)\n\n    if (asJson) {\n      process.stdout.write(`${JSON.stringify(explained)}\\n`)\n      return 0\n    }\n\n    process.stdout.write(`${JSON.stringify(explained, null, 2)}\\n`)\n    return 0\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    process.stderr.write(`${message}\\n`)\n    return 1\n  }\n}\n","import { listCapabilities } from \"../../agent-interface/tools/list-capabilities-tool.js\"\n\nfunction parseArgs(argv: string[]): { asJson: boolean } {\n  return {\n    asJson: argv.includes(\"--json\"),\n  }\n}\n\nexport async function capabilitiesListCommand(argv: string[] = []): Promise<number> {\n  const { asJson } = parseArgs(argv)\n  const capabilities = listCapabilities()\n\n  if (asJson) {\n    process.stdout.write(`${JSON.stringify(capabilities)}\\n`)\n    return 0\n  }\n\n  const lines = capabilities.map((item) => `${item.capability_id} - ${item.description}`)\n  process.stdout.write(`${lines.join(\"\\n\")}\\n`)\n  return 0\n}\n","import type { TaskRequest } from \"../../core/contracts/task.js\"\nimport { executeTask } from \"../../core/routing/engine.js\"\nimport { createGithubClient } from \"../../gql/client.js\"\n\nconst GITHUB_GRAPHQL_ENDPOINT = \"https://api.github.com/graphql\"\n\nfunction parseRunArgs(argv: string[]): {\n  task: string\n  input: Record<string, unknown>\n  skipGhPreflight: boolean\n} {\n  const [task, ...rest] = argv\n  if (!task || task.trim().length === 0) {\n    throw new Error(\"Usage: ghx run <task> --input '<json>' [--check-gh-preflight]\")\n  }\n\n  const inputIndex = rest.findIndex((arg) => arg === \"--input\")\n  const inlineInput = rest.find((arg) => arg.startsWith(\"--input=\"))\n  const inputCandidate = inputIndex >= 0 ? rest[inputIndex + 1] : undefined\n  const inputRaw =\n    inputCandidate && !inputCandidate.startsWith(\"--\")\n      ? inputCandidate\n      : inlineInput\n        ? inlineInput.slice(\"--input=\".length)\n        : undefined\n\n  if (!inputRaw) {\n    throw new Error(\"Missing --input JSON\")\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(inputRaw)\n  } catch {\n    throw new Error(\"Invalid JSON for --input\")\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new Error(\"--input must be a JSON object\")\n  }\n\n  const skipGhPreflight = !rest.includes(\"--check-gh-preflight\")\n\n  return { task, input: parsed as Record<string, unknown>, skipGhPreflight }\n}\n\nfunction resolveGithubToken(): string {\n  const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN\n  if (!token || token.trim().length === 0) {\n    throw new Error(\"Missing GITHUB_TOKEN or GH_TOKEN for GraphQL transport\")\n  }\n\n  return token\n}\n\nasync function executeGraphqlRequest<TData>(\n  token: string,\n  query: string,\n  variables?: Record<string, unknown>,\n): Promise<TData> {\n  const response = await fetch(GITHUB_GRAPHQL_ENDPOINT, {\n    method: \"POST\",\n    headers: {\n      \"content-type\": \"application/json\",\n      accept: \"application/json\",\n      authorization: `Bearer ${token}`,\n      \"user-agent\": \"ghx\",\n    },\n    body: JSON.stringify({ query, variables: variables ?? {} }),\n  })\n\n  const payload = (await response.json()) as {\n    data?: TData\n    errors?: Array<{ message?: string }>\n    message?: string\n  }\n\n  if (!response.ok) {\n    const message =\n      payload.message ?? `GitHub GraphQL request failed with status ${response.status}`\n    throw new Error(message)\n  }\n\n  if (Array.isArray(payload.errors) && payload.errors.length > 0) {\n    const message = payload.errors[0]?.message ?? \"GitHub GraphQL returned errors\"\n    throw new Error(message)\n  }\n\n  if (payload.data === undefined) {\n    throw new Error(\"GitHub GraphQL response missing data\")\n  }\n\n  return payload.data\n}\n\nexport async function runCommand(argv: string[] = []): Promise<number> {\n  if (argv.length === 0) {\n    process.stdout.write(\"Usage: ghx run <task> --input '<json>' [--check-gh-preflight]\\n\")\n    return 1\n  }\n\n  const { task, input, skipGhPreflight } = parseRunArgs(argv)\n  const githubToken = resolveGithubToken()\n\n  const githubClient = createGithubClient({\n    async execute<TData>(query: string, variables?: Record<string, unknown>): Promise<TData> {\n      return executeGraphqlRequest<TData>(githubToken, query, variables)\n    },\n  })\n\n  const request: TaskRequest = {\n    task,\n    input,\n  }\n\n  const result = await executeTask(request, {\n    githubClient,\n    githubToken,\n    skipGhPreflight,\n  })\n\n  process.stdout.write(`${JSON.stringify(result)}\\n`)\n  return 0\n}\n","import { access, appendFile, mkdir, readFile, writeFile } from \"node:fs/promises\"\nimport { homedir } from \"node:os\"\nimport { dirname, join } from \"node:path\"\nimport readline from \"node:readline/promises\"\nimport { fileURLToPath } from \"node:url\"\n\nimport { Ajv } from \"ajv\"\nimport type { ErrorCode } from \"../../core/errors/codes.js\"\nimport { errorCodes } from \"../../core/errors/codes.js\"\n\ntype SetupScope = \"user\" | \"project\"\n\ntype SetupOptions = {\n  scope: SetupScope\n  assumeYes: boolean\n  dryRun: boolean\n  verifyOnly: boolean\n  track: boolean\n}\n\ntype SetupError = Error & { code?: ErrorCode }\n\nconst ajv = new Ajv({ allErrors: true, strict: false })\n\nconst setupOptionsSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"scope\", \"assumeYes\", \"dryRun\", \"verifyOnly\", \"track\"],\n  properties: {\n    scope: {\n      type: \"string\",\n      enum: [\"user\", \"project\"],\n    },\n    assumeYes: { type: \"boolean\" },\n    dryRun: { type: \"boolean\" },\n    verifyOnly: { type: \"boolean\" },\n    track: { type: \"boolean\" },\n  },\n} as const\n\nconst validateSetupOptions = ajv.compile(setupOptionsSchema)\n\nconst setupCommandDirectory = dirname(fileURLToPath(import.meta.url))\nconst setupSkillAssetPathCandidates = [\n  join(setupCommandDirectory, \"..\", \"assets\", \"skills\", \"ghx\", \"SKILL.md\"),\n  join(setupCommandDirectory, \"assets\", \"skills\", \"ghx\", \"SKILL.md\"),\n  join(setupCommandDirectory, \"cli\", \"assets\", \"skills\", \"ghx\", \"SKILL.md\"),\n]\n\nfunction isENOENT(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === \"ENOENT\"\n  )\n}\n\nfunction createSetupError(message: string, code: ErrorCode): SetupError {\n  const error = new Error(message) as SetupError\n  error.code = code\n  return error\n}\n\nasync function loadSetupSkillContent(): Promise<string> {\n  for (const candidatePath of setupSkillAssetPathCandidates) {\n    try {\n      return await readFile(candidatePath, \"utf8\")\n    } catch (error) {\n      if (isENOENT(error)) {\n        continue\n      }\n\n      throw error\n    }\n  }\n\n  throw createSetupError(\n    `Setup skill asset not found. Checked: ${setupSkillAssetPathCandidates.join(\", \")}`,\n    errorCodes.NotFound,\n  )\n}\n\nfunction usage(): string {\n  return \"Usage: ghx setup --scope <user|project> [--yes] [--dry-run] [--verify] [--track]\"\n}\n\nfunction parseScope(argv: string[]): SetupScope | undefined {\n  const inline = argv.find((arg) => arg.startsWith(\"--scope=\"))\n  if (inline) {\n    const raw = inline.slice(\"--scope=\".length)\n    if (raw === \"user\" || raw === \"project\") {\n      return raw\n    }\n    return undefined\n  }\n\n  const scopeIndex = argv.findIndex((arg) => arg === \"--scope\")\n  if (scopeIndex < 0) {\n    return undefined\n  }\n\n  const value = argv[scopeIndex + 1]\n  if (value === \"user\" || value === \"project\") {\n    return value\n  }\n\n  return undefined\n}\n\nfunction parseArgs(argv: string[]): SetupOptions | null {\n  const scope = parseScope(argv)\n  if (!scope) {\n    return null\n  }\n\n  const options: SetupOptions = {\n    scope,\n    assumeYes: argv.includes(\"--yes\"),\n    dryRun: argv.includes(\"--dry-run\"),\n    verifyOnly: argv.includes(\"--verify\"),\n    track: argv.includes(\"--track\"),\n  }\n\n  if (!validateSetupOptions(options)) {\n    return null\n  }\n\n  return options\n}\n\nfunction resolveSkillPath(scope: SetupScope): string {\n  const base = scope === \"user\" ? homedir() : process.cwd()\n  return join(base, \".agents\", \"skills\", \"ghx\", \"SKILL.md\")\n}\n\nfunction resolveTrackingPath(): string {\n  return join(homedir(), \".agents\", \"ghx\", \"setup-events.jsonl\")\n}\n\nasync function writeTrackingEvent(options: {\n  track: boolean\n  scope: SetupScope\n  mode: \"apply\"\n  success: boolean\n}): Promise<void> {\n  if (!options.track) {\n    return\n  }\n\n  const trackingPath = resolveTrackingPath()\n  await mkdir(join(homedir(), \".agents\", \"ghx\"), { recursive: true })\n  await appendFile(\n    trackingPath,\n    `${JSON.stringify({\n      command: \"setup\",\n      scope: options.scope,\n      mode: options.mode,\n      success: options.success,\n      timestamp: new Date().toISOString(),\n    })}\\n`,\n    \"utf8\",\n  )\n}\n\nasync function confirmOverwrite(skillPath: string): Promise<boolean> {\n  if (!process.stdin.isTTY || !process.stdout.isTTY) {\n    return false\n  }\n\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  })\n\n  try {\n    const answer = await rl.question(`Skill already exists at ${skillPath}. Overwrite? [y/N] `)\n    const normalized = answer.trim().toLowerCase()\n    return normalized === \"y\" || normalized === \"yes\"\n  } finally {\n    rl.close()\n  }\n}\n\nasync function verifySkill(skillPath: string): Promise<boolean> {\n  try {\n    const content = await readFile(skillPath, \"utf8\")\n    return content.includes(\"ghx capabilities\")\n  } catch (error) {\n    if (isENOENT(error)) {\n      return false\n    }\n\n    throw error\n  }\n}\n\nasync function skillFileExists(skillPath: string): Promise<boolean> {\n  try {\n    await access(skillPath)\n    return true\n  } catch (error) {\n    if (isENOENT(error)) {\n      return false\n    }\n\n    throw error\n  }\n}\n\nexport async function setupCommand(argv: string[] = []): Promise<number> {\n  const parsed = parseArgs(argv)\n  if (!parsed) {\n    process.stderr.write(`${usage()}\\n`)\n    return 1\n  }\n\n  const skillPath = resolveSkillPath(parsed.scope)\n\n  try {\n    if (parsed.verifyOnly) {\n      const ok = await verifySkill(skillPath)\n      if (!ok) {\n        process.stderr.write(`Verify failed: skill not installed at ${skillPath}\\n`)\n        return 1\n      }\n\n      process.stdout.write(`Verify passed: skill installed at ${skillPath}\\n`)\n      return 0\n    }\n\n    if (parsed.dryRun) {\n      process.stdout.write(`Dry run: would write ${skillPath}\\n`)\n      return 0\n    }\n\n    const alreadyExists = await skillFileExists(skillPath)\n    if (alreadyExists && !parsed.assumeYes) {\n      const approved = await confirmOverwrite(skillPath)\n      if (!approved) {\n        process.stderr.write(\n          `Skill already exists at ${skillPath}. Re-run with --yes or confirm overwrite interactively.\\n`,\n        )\n        await writeTrackingEvent({\n          track: parsed.track,\n          scope: parsed.scope,\n          mode: \"apply\",\n          success: false,\n        })\n        return 1\n      }\n    }\n\n    const skillContent = await loadSetupSkillContent()\n    await mkdir(dirname(skillPath), { recursive: true })\n    await writeFile(skillPath, skillContent, \"utf8\")\n\n    process.stdout.write(`Setup complete: wrote ${skillPath}\\n`)\n    process.stdout.write(\"Try: ghx capabilities list\\n\")\n    await writeTrackingEvent({\n      track: parsed.track,\n      scope: parsed.scope,\n      mode: \"apply\",\n      success: true,\n    })\n    return 0\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    process.stderr.write(`Setup failed: ${message}\\n`)\n    return 1\n  }\n}\n"],"mappings":"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","names":["parseArgs","usage","parseArgs","usage"]}

package/dist/{core/contracts/envelope.d.ts → envelope-BpF6MNCv.d.ts}

@@ -1,5 +1,17 @@
-import { RouteReasonCode } from '../routing/reason-codes.js';
-import { ErrorCode } from '../errors/codes.js';
+declare const errorCodes: {
+    readonly Auth: "AUTH";
+    readonly NotFound: "NOT_FOUND";
+    readonly Validation: "VALIDATION";
+    readonly RateLimit: "RATE_LIMIT";
+    readonly Network: "NETWORK";
+    readonly Server: "SERVER";
+    readonly AdapterUnsupported: "ADAPTER_UNSUPPORTED";
+    readonly Unknown: "UNKNOWN";
+};
+type ErrorCode = (typeof errorCodes)[keyof typeof errorCodes];
+
+declare const routeReasonCodes: readonly ["INPUT_VALIDATION", "OUTPUT_VALIDATION", "CARD_PREFERRED", "CARD_FALLBACK", "PREFLIGHT_FAILED", "ENV_CONSTRAINT", "CAPABILITY_LIMIT", "DEFAULT_POLICY"];
+type RouteReasonCode = (typeof routeReasonCodes)[number];
 
 type RouteSource = "cli" | "rest" | "graphql";
 interface ResultError {
@@ -40,4 +52,4 @@ interface ResultEnvelope<TData = unknown> {
     meta: ResultMeta;
 }
 
-export type { AttemptMeta, ResultEnvelope, ResultError, ResultMeta, RouteSource };
+export type { AttemptMeta as A, ResultEnvelope as R, RouteSource as a, RouteReasonCode as b, ResultError as c, ResultMeta as d };