@ghx-dev/core 0.1.0 → 0.1.2

package/README.md

@@ -111,10 +111,22 @@ Need a custom GraphQL transport? Use `createGithubClient(transport)` instead --
 Install ghx as a project skill for Claude Code:
 
 ```bash
-npx @ghx-dev/core setup --platform claude-code --scope project --yes
-npx @ghx-dev/core setup --platform claude-code --scope project --verify
+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
@@ -256,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.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,32 @@
 import {
-  createExecuteTool
-} from "./chunk-DJIEG6K7.js";
-import {
-  explainCapability
-} from "./chunk-4PLVKNCF.js";
-import {
+  explainCapability,
   listCapabilities
-} from "./chunk-GMTG7X2L.js";
-import "./chunk-JH6GM6XU.js";
-import "./chunk-2W4L5YCC.js";
-import {
-  MAIN_SKILL_TEXT
-} from "./chunk-FXN6IIT5.js";
+} from "./chunk-2FCPR3XZ.js";
+import "./chunk-UN5YHUNK.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(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-4PLVKNCF.js → chunk-2FCPR3XZ.js}

@@ -1,6 +1,7 @@
 import {
-  getOperationCard
-} from "./chunk-JH6GM6XU.js";
+  getOperationCard,
+  listOperationCards
+} from "./chunk-UN5YHUNK.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-2FCPR3XZ.js.map

package/dist/chunk-2FCPR3XZ.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":[]}