@feastalytics/cli 0.1.15 → 0.1.16

package/README.md

@@ -88,6 +88,17 @@ npx skills add feastalytics/cli -g -a '*' -y
 
 To refresh from a local checkout instead of GitHub, run `npx skills add ./feast -g -a '*' -y` from the repo root.
 
+### Playbook skills from Feastalytics
+
+Feastalytics also publishes playbook skills that build on this one. They are served by the API to logged-in users and installed by the CLI itself, so no GitHub access is needed:
+
+```bash
+feast skill list                       # what is published, with versions
+feast skill install feast-playbooks    # writes ~/.claude/skills/feast-playbooks/
+```
+
+`--dir <path>` installs somewhere else (zip that directory to upload it to claude.ai under Settings > Capabilities > Skills). A re-install replaces the previous copy; `--force` is required to replace a directory the CLI did not create. Skills belong to the organization you act on, so pass `--org` when you belong to several.
+
 ## Environment
 
 - `FEAST_API_URL` — override the API base URL (e.g. a local dev server)

package/dist/cli.js

@@ -3221,8 +3221,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path3) {
-      let input = path3;
+    function removeDotSegments(path5) {
+      let input = path5;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3474,8 +3474,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path3, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path3 && path3 !== "/" ? path3 : void 0;
+        const [path5, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path5 && path5 !== "/" ? path5 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6836,22 +6836,22 @@ var TRPC_ERROR_CODES_BY_NUMBER = invert(TRPC_ERROR_CODES_BY_KEY);
 var TRPC_ERROR_CODES_BY_NUMBER2 = invert(TRPC_ERROR_CODES_BY_KEY);
 var noop = () => {
 };
-function createInnerProxy(callback, path3) {
+function createInnerProxy(callback, path5) {
   const proxy = new Proxy(noop, {
     get(_obj, key) {
       if (typeof key !== "string" || key === "then") {
         return void 0;
       }
       return createInnerProxy(callback, [
-        ...path3,
+        ...path5,
         key
       ]);
     },
     apply(_1, _2, args) {
-      const isApply = path3[path3.length - 1] === "apply";
+      const isApply = path5[path5.length - 1] === "apply";
       return callback({
         args: isApply ? args.length >= 2 ? args[1] : [] : args,
-        path: isApply ? path3.slice(0, -1) : path3
+        path: isApply ? path5.slice(0, -1) : path5
       });
     }
   });
@@ -7263,13 +7263,13 @@ function createHTTPBatchLink(requester) {
           if (maxURLLength === Infinity) {
             return true;
           }
-          const path3 = batchOps.map((op) => op.path).join(",");
+          const path5 = batchOps.map((op) => op.path).join(",");
           const inputs = batchOps.map((op) => op.input);
           const url = getUrl({
             ...resolvedOpts,
             runtime,
             type,
-            path: path3,
+            path: path5,
             inputs
           });
           return url.length <= maxURLLength;
@@ -7327,11 +7327,11 @@ function createHTTPBatchLink(requester) {
 }
 var batchRequester = (requesterOpts) => {
   return (batchOps) => {
-    const path3 = batchOps.map((op) => op.path).join(",");
+    const path5 = batchOps.map((op) => op.path).join(",");
     const inputs = batchOps.map((op) => op.input);
     const { promise, cancel } = jsonHttpRequester({
       ...requesterOpts,
-      path: path3,
+      path: path5,
       inputs,
       headers() {
         if (!requesterOpts.opts.headers) {
@@ -7365,12 +7365,12 @@ function httpLinkFactory(factoryOpts) {
   return (opts) => {
     const resolvedOpts = resolveHTTPLinkOptions(opts);
     return (runtime) => ({ op }) => observable((observer) => {
-      const { path: path3, input, type } = op;
+      const { path: path5, input, type } = op;
       const { promise, cancel } = factoryOpts.requester({
         ...resolvedOpts,
         runtime,
         type,
-        path: path3,
+        path: path5,
         input,
         headers() {
           if (!opts.headers) {
@@ -7416,13 +7416,13 @@ var httpLink = httpLinkFactory({
 
 // node_modules/@trpc/client/dist/index.mjs
 var TRPCUntypedClient = class {
-  $request({ type, input, path: path3, context = {} }) {
+  $request({ type, input, path: path5, context = {} }) {
     const chain$ = createChain({
       links: this.links,
       op: {
         id: ++this.requestId,
         type,
-        path: path3,
+        path: path5,
         input,
         context
       }
@@ -7442,28 +7442,28 @@ var TRPCUntypedClient = class {
     });
     return abortablePromise;
   }
-  query(path3, input, opts) {
+  query(path5, input, opts) {
     return this.requestAsPromise({
       type: "query",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context,
       signal: opts?.signal
     });
   }
-  mutation(path3, input, opts) {
+  mutation(path5, input, opts) {
     return this.requestAsPromise({
       type: "mutation",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context,
       signal: opts?.signal
     });
   }
-  subscription(path3, input, opts) {
+  subscription(path5, input, opts) {
     const observable$ = this.$request({
       type: "subscription",
-      path: path3,
+      path: path5,
       input,
       context: opts?.context
     });
@@ -7535,10 +7535,10 @@ function createTRPCClientProxy(client) {
     if (key === "__untypedClient") {
       return client;
     }
-    return createRecursiveProxy(({ path: path3, args }) => {
+    return createRecursiveProxy(({ path: path5, args }) => {
       const pathCopy = [
         key,
-        ...path3
+        ...path5
       ];
       const procedureType = clientCallTypeToProcedureType(pathCopy.pop());
       const fullPath = pathCopy.join(".");
@@ -7647,12 +7647,12 @@ var streamingJsonHttpRequester = (opts, onSingle) => {
 var streamRequester = (requesterOpts) => {
   const textDecoder = getTextDecoder(requesterOpts.opts.textDecoder);
   return (batchOps, unitResolver) => {
-    const path3 = batchOps.map((op) => op.path).join(",");
+    const path5 = batchOps.map((op) => op.path).join(",");
     const inputs = batchOps.map((op) => op.input);
     const { cancel, promise } = streamingJsonHttpRequester({
       ...requesterOpts,
       textDecoder,
-      path: path3,
+      path: path5,
       inputs,
       headers() {
         if (!requesterOpts.opts.headers) {
@@ -7866,7 +7866,7 @@ var isURL = (payload) => payload instanceof URL;
 
 // node_modules/superjson/dist/pathstringifier.js
 var escapeKey = (key) => key.replace(/\\/g, "\\\\").replace(/\./g, "\\.");
-var stringifyPath = (path3) => path3.map(String).map(escapeKey).join(".");
+var stringifyPath = (path5) => path5.map(String).map(escapeKey).join(".");
 var parsePath = (string, legacyPaths) => {
   const result = [];
   let segment = "";
@@ -8113,26 +8113,26 @@ var getNthKey = (value, n) => {
   }
   return keys.next().value;
 };
-function validatePath(path3) {
-  if (includes(path3, "__proto__")) {
+function validatePath(path5) {
+  if (includes(path5, "__proto__")) {
     throw new Error("__proto__ is not allowed as a property");
   }
-  if (includes(path3, "prototype")) {
+  if (includes(path5, "prototype")) {
     throw new Error("prototype is not allowed as a property");
   }
-  if (includes(path3, "constructor")) {
+  if (includes(path5, "constructor")) {
     throw new Error("constructor is not allowed as a property");
   }
 }
-var getDeep = (object, path3) => {
-  validatePath(path3);
-  for (let i = 0; i < path3.length; i++) {
-    const key = path3[i];
+var getDeep = (object, path5) => {
+  validatePath(path5);
+  for (let i = 0; i < path5.length; i++) {
+    const key = path5[i];
     if (isSet(object)) {
       object = getNthKey(object, +key);
     } else if (isMap(object)) {
       const row = +key;
-      const type = +path3[++i] === 0 ? "key" : "value";
+      const type = +path5[++i] === 0 ? "key" : "value";
       const keyOfRow = getNthKey(object, row);
       switch (type) {
         case "key":
@@ -8148,14 +8148,14 @@ var getDeep = (object, path3) => {
   }
   return object;
 };
-var setDeep = (object, path3, mapper) => {
-  validatePath(path3);
-  if (path3.length === 0) {
+var setDeep = (object, path5, mapper) => {
+  validatePath(path5);
+  if (path5.length === 0) {
     return mapper(object);
   }
   let parent = object;
-  for (let i = 0; i < path3.length - 1; i++) {
-    const key = path3[i];
+  for (let i = 0; i < path5.length - 1; i++) {
+    const key = path5[i];
     if (isArray(parent)) {
       const index = +key;
       parent = parent[index];
@@ -8165,12 +8165,12 @@ var setDeep = (object, path3, mapper) => {
       const row = +key;
       parent = getNthKey(parent, row);
     } else if (isMap(parent)) {
-      const isEnd = i === path3.length - 2;
+      const isEnd = i === path5.length - 2;
       if (isEnd) {
         break;
       }
       const row = +key;
-      const type = +path3[++i] === 0 ? "key" : "value";
+      const type = +path5[++i] === 0 ? "key" : "value";
       const keyOfRow = getNthKey(parent, row);
       switch (type) {
         case "key":
@@ -8182,7 +8182,7 @@ var setDeep = (object, path3, mapper) => {
       }
     }
   }
-  const lastKey = path3[path3.length - 1];
+  const lastKey = path5[path5.length - 1];
   if (isArray(parent)) {
     parent[+lastKey] = mapper(parent[+lastKey]);
   } else if (isPlainObject(parent)) {
@@ -8197,7 +8197,7 @@ var setDeep = (object, path3, mapper) => {
     }
   }
   if (isMap(parent)) {
-    const row = +path3[path3.length - 2];
+    const row = +path5[path5.length - 2];
     const keyToRow = getNthKey(parent, row);
     const type = +lastKey === 0 ? "key" : "value";
     switch (type) {
@@ -8244,16 +8244,16 @@ function traverse(tree, walker2, version, origin = []) {
   walker2(nodeValue, origin);
 }
 function applyValueAnnotations(plain, annotations, version, superJson) {
-  traverse(annotations, (type, path3) => {
-    plain = setDeep(plain, path3, (v) => untransformValue(v, type, superJson));
+  traverse(annotations, (type, path5) => {
+    plain = setDeep(plain, path5, (v) => untransformValue(v, type, superJson));
   }, version);
   return plain;
 }
 function applyReferentialEqualityAnnotations(plain, annotations, version) {
   const legacyPaths = enableLegacyPaths(version);
-  function apply(identicalPaths, path3) {
-    const object = getDeep(plain, parsePath(path3, legacyPaths));
-    identicalPaths.map((path4) => parsePath(path4, legacyPaths)).forEach((identicalObjectPath) => {
+  function apply(identicalPaths, path5) {
+    const object = getDeep(plain, parsePath(path5, legacyPaths));
+    identicalPaths.map((path6) => parsePath(path6, legacyPaths)).forEach((identicalObjectPath) => {
       plain = setDeep(plain, identicalObjectPath, () => object);
     });
   }
@@ -8271,12 +8271,12 @@ function applyReferentialEqualityAnnotations(plain, annotations, version) {
   return plain;
 }
 var isDeep = (object, superJson) => isPlainObject(object) || isArray(object) || isMap(object) || isSet(object) || isError(object) || isInstanceOfRegisteredClass(object, superJson);
-function addIdentity(object, path3, identities) {
+function addIdentity(object, path5, identities) {
   const existingSet = identities.get(object);
   if (existingSet) {
-    existingSet.push(path3);
+    existingSet.push(path5);
   } else {
-    identities.set(object, [path3]);
+    identities.set(object, [path5]);
   }
 }
 function generateReferentialEqualityAnnotations(identitites, dedupe) {
@@ -8287,7 +8287,7 @@ function generateReferentialEqualityAnnotations(identitites, dedupe) {
       return;
     }
     if (!dedupe) {
-      paths = paths.map((path3) => path3.map(String)).sort((a, b) => a.length - b.length);
+      paths = paths.map((path5) => path5.map(String)).sort((a, b) => a.length - b.length);
     }
     const [representativePath, ...identicalPaths] = paths;
     if (representativePath.length === 0) {
@@ -8306,10 +8306,10 @@ function generateReferentialEqualityAnnotations(identitites, dedupe) {
     return isEmptyObject(result) ? void 0 : result;
   }
 }
-var walker = (object, identities, superJson, dedupe, path3 = [], objectsInThisPath = [], seenObjects = /* @__PURE__ */ new Map()) => {
+var walker = (object, identities, superJson, dedupe, path5 = [], objectsInThisPath = [], seenObjects = /* @__PURE__ */ new Map()) => {
   const primitive = isPrimitive(object);
   if (!primitive) {
-    addIdentity(object, path3, identities);
+    addIdentity(object, path5, identities);
     const seen = seenObjects.get(object);
     if (seen) {
       return dedupe ? {
@@ -8343,7 +8343,7 @@ var walker = (object, identities, superJson, dedupe, path3 = [], objectsInThisPa
     if (index === "__proto__" || index === "constructor" || index === "prototype") {
       throw new Error(`Detected property ${index}. This is a prototype pollution risk, please remove it from your object.`);
     }
-    const recursiveResult = walker(value, identities, superJson, dedupe, [...path3, index], [...objectsInThisPath, object], seenObjects);
+    const recursiveResult = walker(value, identities, superJson, dedupe, [...path5, index], [...objectsInThisPath, object], seenObjects);
     transformedValue[index] = recursiveResult.transformedValue;
     if (isArray(recursiveResult.annotations)) {
       innerAnnotations[escapeKey(index)] = recursiveResult.annotations;
@@ -8654,7 +8654,8 @@ function errorMessage(error) {
 }
 
 // src/main.ts
-import fs2 from "fs";
+import fs3 from "fs";
+import path3 from "path";
 
 // src/generated/manifest.ts
 var CLI_MANIFEST = {
@@ -26494,6 +26495,90 @@ function validateToolInput(tool, input) {
   );
 }
 
+// src/skills.ts
+import fs2 from "fs";
+import os2 from "os";
+import path2 from "path";
+var MARKER_FILE = ".feast-skill.json";
+var SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+function defaultSkillsDir() {
+  return path2.join(os2.homedir(), ".claude", "skills");
+}
+async function createClient(orgFlag, roleFlag) {
+  const acting = await resolveActingContext(orgFlag, roleFlag);
+  return createHttpCaller({
+    accessToken: acting.accessToken,
+    preferredRole: acting.preferredRole
+  });
+}
+async function listSkills(orgFlag, roleFlag) {
+  const client = await createClient(orgFlag, roleFlag);
+  const entries = await callProcedure(client, ["api", "skills", "list"], "query", void 0);
+  return Array.isArray(entries) ? entries : [];
+}
+async function fetchSkill(name, orgFlag, roleFlag) {
+  if (!SKILL_NAME_PATTERN.test(name)) {
+    throw new Error(`Invalid skill name "${name}". Run: feast skill list`);
+  }
+  const client = await createClient(orgFlag, roleFlag);
+  return callProcedure(client, ["api", "skills", "get"], "query", { name });
+}
+function assertInsideDir(root, relative) {
+  const target = path2.resolve(root, relative);
+  if (target !== root && !target.startsWith(`${root}${path2.sep}`)) {
+    throw new Error(`Refusing to write outside the skill directory: ${relative}`);
+  }
+  return target;
+}
+function readMarker(dir) {
+  const markerPath = path2.join(dir, MARKER_FILE);
+  if (!fs2.existsSync(markerPath)) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(fs2.readFileSync(markerPath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeSkill(bundle, targetDir, force) {
+  const dir = path2.resolve(targetDir);
+  const exists = fs2.existsSync(dir);
+  const marker = exists ? readMarker(dir) : void 0;
+  if (exists && marker == null && !force) {
+    throw new Error(
+      `${dir} exists and was not installed by feast. Pass --force to replace it.`
+    );
+  }
+  if (exists) {
+    fs2.rmSync(dir, { recursive: true, force: true });
+  }
+  fs2.mkdirSync(dir, { recursive: true });
+  for (const file of bundle.files) {
+    const target = assertInsideDir(dir, file.path);
+    fs2.mkdirSync(path2.dirname(target), { recursive: true });
+    fs2.writeFileSync(target, file.content);
+  }
+  fs2.writeFileSync(
+    path2.join(dir, MARKER_FILE),
+    `${JSON.stringify(
+      {
+        name: bundle.name,
+        version: bundle.version,
+        publishedAt: bundle.publishedAt,
+        installedAt: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      null,
+      2
+    )}
+`
+  );
+  return { dir, written: bundle.files.length, replaced: exists };
+}
+function shortVersion(version) {
+  return version.slice(0, 7);
+}
+
 // src/main.ts
 var USAGE = `Usage: feast <command> [options]
 
@@ -26505,6 +26590,12 @@ Commands:
   tools [--domain <domain>] [--json]    List available tools
   describe <tool>                       Show a tool's description and input JSON schema
   call <tool> [options]                 Invoke a tool
+  skill list                            List the skills you can install
+  skill install <name> [options]        Install a skill into ~/.claude/skills/<name>
+
+Skill install options:
+  --dir <path>              Install into this directory instead of ~/.claude/skills/<name>
+  --force                   Replace a directory that feast did not install
 
 Call options:
   --org <organizationId>    Organization to act on (required unless you belong to exactly one)
@@ -26526,7 +26617,14 @@ Non-interactive credentials (for sandboxed agents):
 function parseArgs(argv) {
   const positional = [];
   const flags = {};
-  const valueFlags = /* @__PURE__ */ new Set(["org", "role", "input", "input-file", "domain"]);
+  const valueFlags = /* @__PURE__ */ new Set([
+    "org",
+    "role",
+    "input",
+    "input-file",
+    "domain",
+    "dir"
+  ]);
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
     if (!arg.startsWith("--")) {
@@ -26674,7 +26772,7 @@ function readCallInput(args) {
   }
   let raw = inputJson;
   if (inputFile != null) {
-    raw = fs2.readFileSync(inputFile, "utf-8");
+    raw = fs3.readFileSync(inputFile, "utf-8");
   }
   if (raw == null) {
     return {};
@@ -26742,6 +26840,41 @@ Run: feast describe ${tool.id}`
   const result = await callProcedure(client, tool.path, tool.type, input);
   console.info(JSON.stringify(result ?? null, null, 2));
 }
+async function commandSkill(args) {
+  const [subcommand, name] = args.positional;
+  const orgFlag = args.flags["org"];
+  const roleFlag = args.flags["role"];
+  if (subcommand === "list") {
+    const entries = await listSkills(orgFlag, roleFlag);
+    if (entries.length === 0) {
+      console.info("No skills are published for your organization yet.");
+      return;
+    }
+    for (const entry of entries) {
+      console.info(
+        `${entry.name}  ${entry.displayTitle}  (version ${shortVersion(entry.version)})`
+      );
+      console.info(`    ${entry.description.split("\n")[0]}`);
+    }
+    return;
+  }
+  if (subcommand === "install") {
+    if (name == null) {
+      throw new Error("Usage: feast skill install <name> [--dir <path>] [--force]");
+    }
+    const bundle = await fetchSkill(name, orgFlag, roleFlag);
+    const targetDir = args.flags["dir"] ?? path3.join(defaultSkillsDir(), bundle.name);
+    const result = writeSkill(bundle, targetDir, args.flags["force"] === true);
+    console.info(
+      `${result.replaced ? "Updated" : "Installed"} ${bundle.name} (version ${shortVersion(bundle.version)}, ${result.written} files) in ${result.dir}`
+    );
+    console.info(
+      "Claude Code picks it up on the next session. For claude.ai, zip that directory and upload it under Settings > Capabilities > Skills."
+    );
+    return;
+  }
+  throw new Error("Usage: feast skill <list|install <name>>");
+}
 async function runCli(argv) {
   const [command, ...rest] = argv;
   const args = parseArgs(rest);
@@ -26765,6 +26898,9 @@ async function runCli(argv) {
     case "call":
       await commandCall(args);
       break;
+    case "skill":
+      await commandSkill(args);
+      break;
     default:
       console.info(USAGE);
       if (command != null && command !== "help") {
@@ -26774,16 +26910,16 @@ async function runCli(argv) {
 }
 
 // src/updateNotifier.ts
-import fs3 from "fs";
+import fs4 from "fs";
 import { createRequire as createRequire2 } from "module";
-import os2 from "os";
-import path2 from "path";
+import os3 from "os";
+import path4 from "path";
 var PACKAGE_NAME = "@feastalytics/cli";
 var REGISTRY_URL = "https://registry.npmjs.org";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var FETCH_TIMEOUT_MS = 1500;
-var CACHE_DIR = path2.join(os2.homedir(), ".config", "feast-cli");
-var CACHE_PATH = path2.join(CACHE_DIR, "update-check.json");
+var CACHE_DIR = path4.join(os3.homedir(), ".config", "feast-cli");
+var CACHE_PATH = path4.join(CACHE_DIR, "update-check.json");
 function readPackageVersion2() {
   try {
     const require2 = createRequire2(import.meta.url);
@@ -26820,7 +26956,7 @@ function isDisabled() {
 function readCache() {
   try {
     const parsed = JSON.parse(
-      fs3.readFileSync(CACHE_PATH, "utf-8")
+      fs4.readFileSync(CACHE_PATH, "utf-8")
     );
     return typeof parsed.latest === "string" && typeof parsed.checkedAt === "number" ? parsed : void 0;
   } catch {
@@ -26829,8 +26965,8 @@ function readCache() {
 }
 function writeCache(cache) {
   try {
-    fs3.mkdirSync(CACHE_DIR, { recursive: true, mode: 448 });
-    fs3.writeFileSync(CACHE_PATH, JSON.stringify(cache));
+    fs4.mkdirSync(CACHE_DIR, { recursive: true, mode: 448 });
+    fs4.writeFileSync(CACHE_PATH, JSON.stringify(cache));
   } catch {
     return;
   }

package/feast/references/setup.md

@@ -44,6 +44,17 @@ If you've been invoking the CLI through `npx` rather than a global install, skip
 
 Update the skill whenever you update the CLI: the two ship from the same repo but on different triggers, so a new CLI version usually means this skill's guidance has moved too.
 
+## Playbook skills
+
+Feastalytics publishes further skills that build on this one (campaign diagnosis and other playbooks). They come from the API, not from GitHub:
+
+```bash
+feast skill list                       # what is published for your organization
+feast skill install feast-playbooks    # install or refresh one into ~/.claude/skills/
+```
+
+Install what `feast skill list` offers when the user asks for a playbook this skill does not cover, and re-run the install when the CLI prints an update notice.
+
 ## Which organization
 
 Most tools act on one organization. A user often belongs to several, so which one you target matters and must be explicit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feastalytics/cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Command-line client for the Feastalytics platform — list, create, and update campaigns, automations, offers, and members-program rewards from the terminal.",
   "type": "module",
   "bin": {