@ghx-dev/core 0.1.1 → 0.1.2

package/README.md

@@ -268,11 +268,11 @@ const result = await executeTask(
 
 ## 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)
-- [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)
+- [Documentation Hub](https://github.com/aryeko/ghx/blob/main/docs/README.md)
+- [Architecture](https://github.com/aryeko/ghx/blob/main/docs/architecture/README.md)
+- [Capabilities Reference](https://github.com/aryeko/ghx/blob/main/docs/capabilities/README.md)
+- [Operation Cards](https://github.com/aryeko/ghx/blob/main/docs/architecture/operation-cards.md)
+- [Publishing Guide](https://github.com/aryeko/ghx/blob/main/docs/contributing/publishing.md)
 
 ## License
 

package/dist/agent.js

@@ -1,8 +1,8 @@
 import {
   explainCapability,
   listCapabilities
-} from "./chunk-SCIJMW5P.js";
-import "./chunk-OL4ARD3R.js";
+} from "./chunk-2FCPR3XZ.js";
+import "./chunk-UN5YHUNK.js";
 
 // src/agent-interface/prompt/main-skill.ts
 var MAIN_SKILL_TEXT = `
@@ -23,9 +23,7 @@ function createExecuteTool(deps) {
         input: params,
         ...options ? { options } : {}
       };
-      return deps.executeTask({
-        ...request
-      });
+      return deps.executeTask(request);
     }
   };
 }

package/dist/agent.js.map

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

package/dist/cards/project_v2.fields.list.yaml

@@ -31,7 +31,7 @@ output_schema:
       additionalProperties: false
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project field-list

package/dist/cards/project_v2.item.add_issue.yaml

@@ -17,7 +17,7 @@ output_schema:
     added: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project item-add

package/dist/cards/project_v2.item.field.update.yaml

@@ -23,7 +23,7 @@ output_schema:
     updated: { type: boolean }
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project item-edit

package/dist/cards/project_v2.items.list.yaml

@@ -33,7 +33,7 @@ output_schema:
       additionalProperties: false
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project item-list

package/dist/cards/project_v2.org.get.yaml

@@ -20,7 +20,7 @@ output_schema:
     url: { type: [string, "null"] }
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project view

package/dist/cards/project_v2.user.get.yaml

@@ -20,7 +20,7 @@ output_schema:
     url: { type: [string, "null"] }
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: project view

package/dist/cards/repo.issue_types.list.yaml

@@ -34,7 +34,7 @@ output_schema:
       additionalProperties: false
   additionalProperties: false
 routing:
-  preferred: graphql
-  fallbacks: [cli]
+  preferred: cli
+  fallbacks: []
 cli:
   command: api graphql

package/dist/{chunk-SCIJMW5P.js → chunk-2FCPR3XZ.js}

@@ -1,7 +1,7 @@
 import {
   getOperationCard,
   listOperationCards
-} from "./chunk-OL4ARD3R.js";
+} from "./chunk-UN5YHUNK.js";
 
 // src/agent-interface/tools/explain-tool.ts
 function extractRequiredInputs(inputSchema) {
@@ -51,4 +51,4 @@ export {
   explainCapability,
   listCapabilities
 };
-//# sourceMappingURL=chunk-SCIJMW5P.js.map
+//# sourceMappingURL=chunk-2FCPR3XZ.js.map

package/dist/{chunk-PJ2JKKQE.js → chunk-RDUPMVHG.js}

@@ -1,6 +1,7 @@
 import {
+  ajv,
   getOperationCard
-} from "./chunk-OL4ARD3R.js";
+} from "./chunk-UN5YHUNK.js";
 
 // src/core/execution/cli/safe-runner.ts
 import { spawn } from "child_process";
@@ -146,11 +147,6 @@ function normalizeError(error, route, options) {
 }
 
 // src/core/registry/schema-validator.ts
-import { Ajv } from "ajv";
-var ajv = new Ajv({
-  allErrors: true,
-  strict: false
-});
 var validatorCache = /* @__PURE__ */ new WeakMap();
 function mapAjvErrors(errors) {
   if (!errors) {
@@ -422,17 +418,20 @@ function toMessage(error) {
 }
 function mapErrorToCode(error) {
   const message = toMessage(error).toLowerCase();
-  if (message.includes("rate limit") || message.includes(" 429") || message.includes("too many requests")) {
+  if (message.includes("rate limit") || /\b429\b/.test(message) || message.includes("too many requests")) {
     return errorCodes.RateLimit;
   }
+  if (/\b(500|502|503|504)\b/.test(message)) {
+    return errorCodes.Server;
+  }
   if (message.includes("timeout")) {
     return errorCodes.Network;
   }
   if (message.includes("econn") || message.includes("enotfound") || message.includes("eai_again") || message.includes("network") || message.includes("connection reset")) {
     return errorCodes.Network;
   }
-  if (message.includes(" 500") || message.includes(" 502") || message.includes(" 503") || message.includes(" 504")) {
-    return errorCodes.Server;
+  if (message.includes("not found") || /\b404\b/.test(message)) {
+    return errorCodes.NotFound;
   }
   if (message.includes("auth") || message.includes("forbidden") || message.includes("unauthorized")) {
     return errorCodes.Auth;
@@ -440,9 +439,6 @@ function mapErrorToCode(error) {
   if (message.includes("validation") || message.includes("invalid") || message.includes("required") || message.includes("positive integer")) {
     return errorCodes.Validation;
   }
-  if (message.includes("not found") || message.includes(" 404")) {
-    return errorCodes.NotFound;
-  }
   return errorCodes.Unknown;
 }
 
@@ -1362,7 +1358,7 @@ function isCheckPassBucket(bucket) {
   }
   return normalized === "pass";
 }
-function normalizeCliData(capabilityId, data, params) {
+function normalizeCliData(capabilityId, data, params, context) {
   const normalizeRelease = (input) => {
     if (typeof input !== "object" || input === null || Array.isArray(input)) {
       return {
@@ -1567,7 +1563,7 @@ function normalizeCliData(capabilityId, data, params) {
     };
   }
   if (capabilityId === "pr.checks.rerun_failed" || capabilityId === "pr.checks.rerun_all") {
-    const effectiveMode = params.__effectiveRerunMode === "all" ? "all" : capabilityId === "pr.checks.rerun_failed" ? "failed" : "all";
+    const effectiveMode = context?.effectiveRerunMode === "all" ? "all" : capabilityId === "pr.checks.rerun_failed" ? "failed" : "all";
     return {
       prNumber: Number(params.prNumber),
       runId: Number(params.runId),
@@ -1880,7 +1876,7 @@ function normalizeCliData(capabilityId, data, params) {
     const release = normalizeRelease(data);
     return {
       ...release,
-      wasDraft: Boolean(params.__wasDraft)
+      wasDraft: Boolean(context?.wasDraft)
     };
   }
   if (capabilityId === "workflow_dispatch.run") {
@@ -1956,9 +1952,8 @@ async function runCliCapability(runner, capabilityId, params, card) {
           { capabilityId, reason: "CARD_FALLBACK" }
         );
       }
-      const normalized2 = normalizeCliData(capabilityId, parseCliData(result2.stdout), {
-        ...params,
-        __wasDraft: true
+      const normalized2 = normalizeCliData(capabilityId, parseCliData(result2.stdout), params, {
+        wasDraft: true
       });
       return normalizeResult(normalized2, "cli", { capabilityId, reason: "CARD_FALLBACK" });
     }
@@ -1971,9 +1966,8 @@ async function runCliCapability(runner, capabilityId, params, card) {
         const rerunAllResult = await runner.run("gh", rerunAllArgs, DEFAULT_TIMEOUT_MS);
         if (rerunAllResult.exitCode === 0) {
           const rerunData = NON_JSON_STDOUT_CAPABILITIES.has(capabilityId) ? {} : parseCliData(rerunAllResult.stdout);
-          const fallbackData = normalizeCliData(capabilityId, rerunData, {
-            ...params,
-            __effectiveRerunMode: "all"
+          const fallbackData = normalizeCliData(capabilityId, rerunData, params, {
+            effectiveRerunMode: "all"
           });
           return normalizeResult(fallbackData, "cli", { capabilityId, reason: "CARD_FALLBACK" });
         }
@@ -2271,7 +2265,7 @@ function preflightCheck(input) {
   if (input.route === "cli" && input.ghCliAvailable === false) {
     return {
       ok: false,
-      code: errorCodes.Validation,
+      code: errorCodes.AdapterUnsupported,
       message: "GitHub CLI is required for cli route",
       retryable: false,
       details: { route: input.route }
@@ -2305,9 +2299,6 @@ function preflightCheck(input) {
 var routePreferenceOrder = ["cli", "graphql"];
 
 // src/core/routing/engine.ts
-function chooseRoute() {
-  return routePreferenceOrder[0];
-}
 var DEFAULT_REASON = "DEFAULT_POLICY";
 var CLI_ENV_CACHE_TTL_MS = 3e4;
 var cliEnvironmentCache = /* @__PURE__ */ new WeakMap();
@@ -2368,7 +2359,7 @@ async function executeTask(request, deps) {
         message: `Unsupported task: ${request.task}`,
         retryable: false
       },
-      chooseRoute(),
+      routePreferenceOrder[0],
       { capabilityId: request.task, reason }
     );
   }
@@ -4145,4 +4136,4 @@ export {
   createGithubClientFromToken,
   createGithubClient
 };
-//# sourceMappingURL=chunk-PJ2JKKQE.js.map
+//# sourceMappingURL=chunk-RDUPMVHG.js.map