@neta-art/neta-search-cli 0.2.14 → 0.2.16

package/README.md

@@ -7,10 +7,14 @@ npx -y @neta-art/neta-search-cli@0.2 skills find "generate video"     # search (
 npx -y @neta-art/neta-search-cli@0.2 skills find "browser automation" --json
 npx -y @neta-art/neta-search-cli@0.2 skills use  <id>                 # print the SKILL.md (pulled into a temp dir; no project files written)
 npx -y @neta-art/neta-search-cli@0.2 skills add  <id>                 # install into .agents/skills/
+npx -y @neta-art/neta-search-cli@0.2 skills list                      # what's in .agents/skills/, and which installed ones have updates
+npx -y @neta-art/neta-search-cli@0.2 skills update                    # update installed skills to their current release
 npx -y @neta-art/neta-search-cli@0.2 skills init <name>               # scaffold your own skill
 ```
 
-`<id>` comes from `find` results, e.g. `cohub:<spaceId>/<name>`.
+`<id>` comes from `find` results, e.g. `cohub:<spaceId>/<name>`; a handle such as `neta-skills/holo-pack-opening` works too.
+
+`skills remove <name>` deletes an installed skill from `.agents/skills/`. Skills you wrote yourself (no install record) are left alone unless you pass `--force`.
 
 `use` prints the skill directory and the full SKILL.md, so an agent can follow it right away; relative paths in SKILL.md resolve against that directory. If the local entry is a pointer (frontmatter `metadata.neta-skill-id`), `use` fetches the full skill it points to.
 

package/neta-search.mjs

@@ -2660,7 +2660,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const negativeNumberArg = (arg) => {
           if (!/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(arg)) return false;
           return !this._getCommandAndAncestors().some(
-            (cmd) => cmd.options.map((opt) => opt.short).some((short) => /^-\d$/.test(short))
+            (cmd) => cmd.options.map((opt) => opt.short).some((short2) => /^-\d$/.test(short2))
           );
         };
         let activeVariadicOption = null;
@@ -27077,6 +27077,14 @@ async function fetchArchive(env, id) {
   if (got !== digest) throw new Error(`\u4E0B\u8F7D\u7684 ${id} \u5185\u5BB9\u6821\u9A8C\u5931\u8D25\uFF08\u671F\u671B ${digest}\uFF0C\u5B9E\u9645 ${got}\uFF09`);
   return { id, name, digest, files };
 }
+async function archiveHead(env, id) {
+  const url = `${env.apiBase}${ARCHIVE_PATH}?id=${encodeURIComponent(id)}`;
+  const res = await fetch(url, { method: "HEAD", redirect: "manual", signal: AbortSignal.timeout(1e4) });
+  if (res.status === 404) return null;
+  const digest = res.headers.get("x-skill-digest") ?? "";
+  if (res.status < 300 || res.status >= 400 || !digest) throw new Error(`\u67E5\u8BE2 ${id} \u5931\u8D25\uFF1AHTTP ${res.status}`);
+  return { id: res.headers.get("x-skill-id") ?? id, name: res.headers.get("x-skill-name") ?? id.split("/").pop(), digest };
+}
 async function download(url, id) {
   for (let attempt = 1; ; attempt++) {
     const res = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS) });
@@ -27156,6 +27164,21 @@ function parseId(s) {
   const m = ID_RE.exec(s);
   return m ? { spaceId: m[1], name: m[2] } : null;
 }
+var HANDLE_RE = /^(@[a-z0-9_.-]{1,64}|[a-z0-9][a-z0-9-]{0,31})\/[a-z0-9][a-z0-9-]{0,63}$/i;
+function isHandle(s) {
+  return !parseId(s) && HANDLE_RE.test(s);
+}
+async function resolveRef(env, input) {
+  if (!isHandle(input)) return input;
+  try {
+    const r = await fetch(`${env.apiBase}/v1/skills/resolve?handle=${encodeURIComponent(input)}`, { signal: AbortSignal.timeout(5e3) });
+    if (!r.ok) return input;
+    const out = await r.json();
+    return typeof out.id === "string" && parseId(out.id) ? out.id : input;
+  } catch {
+    return input;
+  }
+}
 function ownId(env, name) {
   return `cohub:${env.spaceId}/${name}`;
 }
@@ -27228,6 +27251,7 @@ function shareNotice(id, dir, draft, reported) {
 // cli/src/skills/add.ts
 async function cmdAdd(idOrName, opts) {
   const env = detectEnv();
+  idOrName = await resolveRef(env, idOrName);
   const parsed = parseId(idOrName);
   const name = parsed?.name ?? idOrName;
   const target = join3(opts.dir, name);
@@ -27279,19 +27303,9 @@ import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as
 import { randomUUID } from "node:crypto";
 import { join as join4 } from "node:path";
 var FETCH_ROOT = process.env["NETASEARCH_FETCH_ROOT"] ?? join4("/tmp", "neta-skills");
-var HANDLE_RE = /^(@[a-z0-9_.-]{1,64}|[a-z0-9][a-z0-9-]{0,31})\/[a-z0-9][a-z0-9-]{0,63}$/i;
-async function resolveHandle(env, input) {
-  const r = await fetch(`${env.apiBase}/v1/skills/resolve?handle=${encodeURIComponent(input)}`, { signal: AbortSignal.timeout(5e3) });
-  if (!r.ok) return null;
-  const out = await r.json();
-  return typeof out.id === "string" && parseId(out.id) ? out.id : null;
-}
 async function cmdUse(idOrName, opts) {
   const env = detectEnv();
-  if (!parseId(idOrName) && HANDLE_RE.test(idOrName)) {
-    const resolved = await resolveHandle(env, idOrName).catch(() => null);
-    if (resolved) idOrName = resolved;
-  }
+  idOrName = await resolveRef(env, idOrName);
   const parsed = parseId(idOrName);
   const name = parsed?.name ?? idOrName;
   const mine = !parsed || parsed.spaceId === env.spaceId;
@@ -27443,6 +27457,153 @@ metadata:
 `;
 }
 
+// cli/src/skills/manage.ts
+import { existsSync as existsSync5, readdirSync as readdirSync3, rmSync as rmSync2 } from "node:fs";
+import { join as join6 } from "node:path";
+function scanLocal(dir) {
+  if (!existsSync5(dir)) return [];
+  const out = [];
+  for (const e of readdirSync3(dir, { withFileTypes: true })) {
+    if (!e.isDirectory() || e.name.startsWith(".")) continue;
+    const path = join6(dir, e.name);
+    if (!skillDirExists(path)) continue;
+    const src = readSource(path);
+    if (src) {
+      out.push({ name: e.name, path, kind: "installed", id: src.id, digest: src.digest });
+      continue;
+    }
+    const ptr = pointerTarget(path);
+    out.push(ptr ? { name: e.name, path, kind: "pointer", id: ptr } : { name: e.name, path, kind: "own" });
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function statusOf(env, s) {
+  if (s.kind !== "installed" || !s.id) return { status: "unknown" };
+  try {
+    const head = await archiveHead(env, s.id);
+    if (!head) return { status: "unavailable" };
+    return { status: head.digest === s.digest ? "latest" : "outdated", latest: head.digest };
+  } catch (e) {
+    return { status: "unknown", error: e instanceof Error ? e.message : String(e) };
+  }
+}
+var KIND_LABEL = { installed: "\u88C5\u6765\u7684", pointer: "\u6307\u9488", own: "\u81EA\u5DF1\u5199\u7684" };
+var STATUS_LABEL = { latest: "\u6700\u65B0", outdated: "\u6709\u66F4\u65B0", unavailable: "\u5DF2\u4E0B\u67B6", unknown: "" };
+async function cmdList(opts) {
+  const env = detectEnv();
+  const local = scanLocal(opts.dir);
+  const rows = await Promise.all(
+    local.map(async (s) => ({ ...s, ...opts.offline ? { status: "unknown" } : await statusOf(env, s) }))
+  );
+  if (opts.json) {
+    console.log(JSON.stringify({ dir: opts.dir, count: rows.length, skills: rows }));
+    return 0;
+  }
+  if (rows.length === 0) {
+    console.log(`${opts.dir}/ \u91CC\u6CA1\u6709 skill\u3002\u7528 neta-search skills find <\u610F\u56FE> \u627E\uFF0C\u518D add \u5B89\u88C5\u3002`);
+    return 0;
+  }
+  console.log(`${opts.dir}/\uFF08${rows.length} \u4E2A\uFF09\uFF1A`);
+  for (const r of rows) {
+    const st = STATUS_LABEL[r.status] ? `  [${STATUS_LABEL[r.status]}]` : "";
+    const from = r.id ? `  ${r.id}` : "";
+    console.log(`  ${r.name.padEnd(28)} ${KIND_LABEL[r.kind]}${st}${from}`);
+  }
+  const outdated = rows.filter((r) => r.status === "outdated").length;
+  if (outdated > 0) console.log(`
+${outdated} \u4E2A\u6709\u66F4\u65B0\uFF1Aneta-search skills update`);
+  return 0;
+}
+async function cmdUpdate(names, opts) {
+  const env = detectEnv();
+  const local = scanLocal(opts.dir);
+  const byName = new Map(local.map((s) => [s.name, s]));
+  const targets = [];
+  const results = [];
+  let failed = 0;
+  if (names.length === 0) {
+    targets.push(...local.filter((s) => s.kind === "installed"));
+  } else {
+    for (const n of names) {
+      const s = byName.get(n);
+      if (!s) {
+        results.push({ name: n, result: "not_found" });
+        failed++;
+      } else if (s.kind !== "installed") {
+        results.push({ name: n, result: s.kind === "own" ? "own_skipped" : "pointer_skipped" });
+      } else targets.push(s);
+    }
+  }
+  for (const s of targets) {
+    const st = await statusOf(env, s);
+    if (st.status === "latest") {
+      results.push({ name: s.name, result: "latest" });
+      continue;
+    }
+    if (st.status === "unavailable") {
+      results.push({ name: s.name, result: "unavailable" });
+      continue;
+    }
+    if (st.status === "unknown") {
+      results.push({ name: s.name, result: "error", from: st.error });
+      failed++;
+      continue;
+    }
+    try {
+      const a = await fetchArchive(env, s.id);
+      writeSkill(s.path, a.files, { id: s.id, digest: a.digest });
+      await reportSkillEvent(env, "install", s.id, a.digest, s.name);
+      results.push({ name: s.name, result: "updated", from: s.digest, to: a.digest });
+    } catch (e) {
+      results.push({ name: s.name, result: e instanceof ArchiveNotFound ? "unavailable" : "error", from: e instanceof Error ? e.message : String(e) });
+      if (!(e instanceof ArchiveNotFound)) failed++;
+    }
+  }
+  if (opts.json) {
+    console.log(JSON.stringify({ results }));
+    return failed > 0 ? 1 : 0;
+  }
+  if (results.length === 0) console.log(`${opts.dir}/ \u91CC\u6CA1\u6709\u88C5\u6765\u7684 skill\uFF0C\u4E0D\u7528\u66F4\u65B0\u3002`);
+  const say = {
+    updated: (r) => `\u5DF2\u66F4\u65B0 ${r.name}\uFF08${short(r.from)} \u2192 ${short(r.to)}\uFF09`,
+    latest: (r) => `${r.name} \u5DF2\u662F\u6700\u65B0`,
+    unavailable: (r) => `${r.name} \u6765\u6E90\u5DF2\u4E0B\u67B6\u6216\u64A4\u56DE\uFF0C\u4FDD\u7559\u672C\u5730\u526F\u672C`,
+    own_skipped: (r) => `${r.name} \u662F\u4F60\u81EA\u5DF1\u5199\u7684\uFF0C\u4E0D\u7528\u66F4\u65B0`,
+    pointer_skipped: (r) => `${r.name} \u662F\u6307\u9488\uFF0Cuse \u65F6\u603B\u662F\u53D6\u6700\u65B0\uFF0C\u4E0D\u7528\u66F4\u65B0`,
+    not_found: (r) => `${opts.dir}/${r.name} \u4E0D\u5B58\u5728`,
+    error: (r) => `${r.name} \u66F4\u65B0\u5931\u8D25\uFF1A${r.from ?? ""}`
+  };
+  for (const r of results) console.log(say[r.result](r));
+  return failed > 0 ? 1 : 0;
+}
+function short(d) {
+  return (d ?? "").replace(/^sha256:/, "").slice(0, 12) || "?";
+}
+async function cmdRemove(names, opts) {
+  const byName = new Map(scanLocal(opts.dir).map((s) => [s.name, s]));
+  const results = [];
+  for (const n of names) {
+    const s = byName.get(n);
+    if (!s || n.includes("/") || n.startsWith(".")) {
+      results.push({ name: n, result: "not_found" });
+    } else if (s.kind === "own" && !opts.force) {
+      results.push({ name: n, result: "own_refused" });
+    } else {
+      rmSync2(s.path, { recursive: true, force: true });
+      results.push({ name: n, result: "removed" });
+    }
+  }
+  const failed = results.filter((r) => r.result !== "removed").length;
+  if (opts.json) console.log(JSON.stringify({ results }));
+  else
+    for (const r of results) {
+      if (r.result === "removed") console.log(`\u5DF2\u5220\u9664 ${join6(opts.dir, r.name)}`);
+      else if (r.result === "not_found") console.error(`${join6(opts.dir, r.name)} \u4E0D\u5B58\u5728`);
+      else console.error(`${r.name} \u662F\u4F60\u81EA\u5DF1\u5199\u7684 skill\uFF08\u6CA1\u6709\u5B89\u88C5\u6765\u6E90\uFF09\uFF0C\u6CA1\u5220\u3002\u786E\u5B9A\u8981\u5220\u5C31\u52A0 --force\u3002`);
+    }
+  return failed > 0 ? 1 : 0;
+}
+
 // cli/src/version.ts
 import { createRequire } from "node:module";
 var OUR_NAMES = /* @__PURE__ */ new Set(["@neta-search/cli", "@neta-art/neta-search-cli"]);
@@ -27461,16 +27622,25 @@ function cliVersion() {
 // cli/src/cli.ts
 var program2 = new Command();
 program2.name("neta-search").description("neta-search\u2014\u2014Cohub \u751F\u6001\u68C0\u7D22 CLI\uFF08\u8D44\u6E90\u5B50\u547D\u4EE4\uFF1Askills\uFF1B\u667A\u80FD\u5728 search-api\uFF0CCLI \u662F\u8584\u58F3\uFF09").version(cliVersion());
-var skills = program2.command("skills").description("skill \u57DF\uFF1Afind/add/use/init");
+var skills = program2.command("skills").description("skill \u57DF\uFF1Afind/add/use/list/update/remove/init");
 skills.command("find").description("\u627E skill\uFF08\u751F\u6001\u8D26\u672C+\u5916\u90E8\u6E90\u6DF7\u6392\u68C0\u7D22\uFF09").argument("<query>", "\u68C0\u7D22\u610F\u56FE\uFF08\u81EA\u7136\u8BED\u8A00/\u5173\u952E\u8BCD\uFF09").option("-n, --limit <n>", "\u5019\u9009\u6570\u4E0A\u9650", "20").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (query, opts) => {
   await run(cmdFind(query, { limit: Number(opts.limit) || 20, json: opts.json }));
 });
-skills.command("add").description("\u88C5 skill\uFF08find \u7ED3\u679C\u7684 id\uFF1A\u4E0B\u8F7D\u4F5C\u8005\u7528\u8FC7\u7684\u90A3\u4E00\u7248\uFF1B\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684\u540D\u5B57\uFF1A\u79FB\u5230 .agents/skills/\uFF09").argument("<id-or-name>", "find \u8FD4\u56DE\u7684 skill id\uFF0C\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684 skill \u540D").option("--dir <dir>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (idOrName, opts) => {
+skills.command("add").description("\u88C5 skill\uFF08find \u7ED3\u679C\u7684 id \u6216 handle\uFF1A\u4E0B\u8F7D\u5F53\u524D\u4E0A\u67B6\u7684\u7248\u672C\uFF1B\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684\u540D\u5B57\uFF1A\u79FB\u5230 .agents/skills/\uFF09").argument("<id-or-name>", "find \u8FD4\u56DE\u7684 skill id \u6216 handle\uFF08\u5982 neta-skills/holo-pack-opening\uFF09\uFF0C\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684 skill \u540D").option("--dir <dir>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (idOrName, opts) => {
   await run(cmdAdd(idOrName, opts));
 });
-skills.command("use").description("\u7528 skill\uFF08\u4E0D\u88C5\uFF1A\u6253\u5370 SKILL.md \u5168\u6587\u548C skill \u76EE\u5F55\uFF1B\u672C\u5730\u6709\u2192\u7528\u672C\u5730\u7684\uFF1B\u672C\u5730\u662F\u6307\u9488\u6216\u6CA1\u6709\u2192\u6309 id \u4E0B\u8F7D\u5230\u4E34\u65F6\u76EE\u5F55\uFF09").argument("<id-or-name>", "skill id \u6216 name").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").option("--via <channel>", "\u4ECE\u54EA\u4E2A\u6E20\u9053\u6765\u7684\uFF08\u8BB0\u8FDB\u4F7F\u7528\u8BB0\u5F55\uFF1Bhub mod \u7684\u6307\u9488\u5199 pointer\uFF09").action(async (idOrName, opts) => {
+skills.command("use").description("\u7528 skill\uFF08\u4E0D\u88C5\uFF1A\u6253\u5370 SKILL.md \u5168\u6587\u548C skill \u76EE\u5F55\uFF1B\u672C\u5730\u6709\u2192\u7528\u672C\u5730\u7684\uFF1B\u672C\u5730\u662F\u6307\u9488\u6216\u6CA1\u6709\u2192\u6309 id \u4E0B\u8F7D\u5230\u4E34\u65F6\u76EE\u5F55\uFF09").argument("<id-or-name>", "skill id\u3001handle\uFF08\u5982 neta-skills/holo-pack-opening\uFF09\u6216\u672C\u5730 skill \u540D").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").option("--via <channel>", "\u4ECE\u54EA\u4E2A\u6E20\u9053\u6765\u7684\uFF08\u8BB0\u8FDB\u4F7F\u7528\u8BB0\u5F55\uFF1Bhub mod \u7684\u6307\u9488\u5199 pointer\uFF09").action(async (idOrName, opts) => {
   await run(cmdUse(idOrName, opts));
 });
+skills.command("list").alias("ls").description("\u5217\u51FA\u672C\u5730\u7684 skill\uFF08\u88C5\u6765\u7684 / \u6307\u9488 / \u81EA\u5DF1\u5199\u7684\uFF09\uFF0C\u88C5\u6765\u7684\u987A\u5E26\u67E5\u6709\u6CA1\u6709\u66F4\u65B0").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--offline", "\u4E0D\u8054\u7F51\u67E5\u66F4\u65B0").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (opts) => {
+  await run(cmdList({ dir: opts.dir, offline: !!opts.offline, json: !!opts.json }));
+});
+skills.command("update").description("\u66F4\u65B0\u88C5\u6765\u7684 skill \u5230\u5F53\u524D\u4E0A\u67B6\u7684\u7248\u672C\uFF08\u4E0D\u7ED9\u540D\u5B57 = \u5168\u90E8\uFF1B\u81EA\u5DF1\u5199\u7684\u548C\u6307\u9488\u4E0D\u78B0\uFF09").argument("[names...]", "\u8981\u66F4\u65B0\u7684 skill \u540D\uFF08\u76EE\u5F55\u540D\uFF09").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (names, opts) => {
+  await run(cmdUpdate(names, { dir: opts.dir, json: !!opts.json }));
+});
+skills.command("remove").alias("rm").description("\u5220\u9664\u672C\u5730 skill\uFF08\u88C5\u6765\u7684 / \u6307\u9488\uFF1B\u81EA\u5DF1\u5199\u7684\u8981 --force\uFF09").argument("<names...>", "\u8981\u5220\u7684 skill \u540D\uFF08\u76EE\u5F55\u540D\uFF09").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--force", "\u8FDE\u81EA\u5DF1\u5199\u7684\u4E5F\u5220").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (names, opts) => {
+  await run(cmdRemove(names, { dir: opts.dir, force: !!opts.force, json: !!opts.json }));
+});
 skills.command("init").description("\u521B\u5EFA skill \u811A\u624B\u67B6\uFF08SKILL.md + frontmatter \u89C4\u8303\uFF09").argument("[name]", "skill \u540D\uFF08kebab-case\uFF09").option("--here", "\u5728\u5F53\u524D\u76EE\u5F55\u751F\u6210\uFF08\u9ED8\u8BA4\u751F\u6210\u5230 ./<name>/ \u5B50\u76EE\u5F55\uFF09").action(async (name, opts) => {
   await run(cmdInit(name, opts));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/neta-search-cli",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "neta-search CLI — find, try and install skills from the Cohub / Neta skill registry",
   "type": "module",
   "bin": {