@neta-art/neta-search-cli 0.2.45 → 0.2.47

package/README.md

@@ -29,7 +29,7 @@ Use `@latest` (or an exact version): with a range such as `@0.2`, npx keeps runn
 
 `submit` publishes one of your skills and works inside a Cohub sandbox only, from a chat started by the space owner: it runs the static check first (see `lint`), sends this version, and waits for the result: published (with its digest) or why not. Nothing is shared until you submit: `use` only runs a skill. `submit --withdraw <name>` takes it down again; deleting the directory does not.
 
-`lint [name-or-dir]` checks a skill folder locally and sends nothing. **Errors** are what the skills site would reject (a missing frontmatter or description, a SKILL.md saved with Windows line endings or a byte-order mark, size limits, a SKILL.md or skill folder that is a symbolic link, anything that looks like a secret, a folder installed from someone else); `submit` stops on them. **Warnings** are suggestions and never block: other symbolic links (skipped when publishing), paths the skill mentions that are not in it, hard-coded `/workspace/...` paths (use paths relative to the skill folder or the current folder), missing or incomplete test declarations (`evals/matrix.json`), common writing problems (no rule that replies follow the user's language, no hand-off card, no `--work-title`, no out-of-scope section, non-English text hard-coded in the deliverable), ready-made non-English words for the agent to say to users, instructions not written in English (recommended, not required), and the optional `listing.json` (your skill's name and description in `en` / `zh` and up to 6 showcase Works for Studio; only Works made in Studio and shared publicly are shown, not links to other sites). It is a static check, not a review: passing it says nothing about how well the skill works. `--json` for agents.
+`lint [name-or-dir]` checks a skill folder locally and sends nothing. **Errors** are what the skills site would reject (a missing frontmatter or description, a SKILL.md saved with Windows line endings or a byte-order mark, size limits, a SKILL.md or skill folder that is a symbolic link, anything that looks like a secret, a folder installed from someone else); `submit` stops on them. **Warnings** are suggestions and never block: other symbolic links (skipped when publishing), paths the skill mentions that are not in it, hard-coded `/workspace/...` paths (use paths relative to the skill folder or the current folder), missing or incomplete test declarations (`evals/matrix.json`), common writing problems (no rule that replies follow the user's language, no hand-off card, no `--work-title`, no out-of-scope section, non-English text hard-coded in the deliverable), ready-made non-English words for the agent to say to users, instructions not written in English (recommended, not required), and the optional `listing.json` (your skill's name and description in `en` / `zh` and up to 6 showcase Works for Studio; only Works made in Studio and shared publicly are shown, not links to other sites; refer to a Work by its id or its `https://neta.art/w/<id>` link). After `submit`, the result says which languages of the name and description were read and which showcase Works can be shown, and why not. It is a static check, not a review: passing it says nothing about how well the skill works. `--json` for agents.
 
 `feedback [name]` reads Neta's review feedback on your own skills (Neta reviews skills it nominates; when one needs changes, the feedback says what, where in the files, and how to fix it). Like `submit`, it works only inside a Cohub sandbox, in a chat the space owner started in that space: the server checks that you are the author before showing anything. `skills list` also marks your own skills that have feedback (it does the same check while it looks for updates; if it cannot check, it just shows the list). Without a name, `feedback` lists your skills that have feedback; with a name it saves the latest feedback to `.neta-search/skill-feedback/<name>/<version>/` (`fix-pack.json` for agents, `feedback.md` for people) and prints it. `--digest` picks a version.
 

package/neta-search.mjs

@@ -29381,13 +29381,14 @@ var MAX_LISTING_NAME = 80;
 var MAX_LISTING_DESC = 300;
 var MAX_LISTING_WORKS = 6;
 var WORK_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-var WORK_LINK = /^https:\/\/(?:www\.)?neta\.art\/w\/[^\s]+$/i;
+var WORK_LINK = /^https:\/\/(?:[a-z0-9-]+\.)?neta\.art\/w\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\/?$/i;
+var APP_LINK = /^https:\/\/(?:[a-z0-9-]+\.)?neta\.art\/w\/[^\s/]+\/[^\s/]+\/[^\s/]+\/?$/i;
 function checkListing(files, add) {
   const F = "listing.json";
   const w = (message, fix) => add({ level: "warn", check: "listing", file: F, line: 0, message, fix });
   const lf = files.find((f) => f.rel === F);
   if (!lf) {
-    w("no listing.json (optional): if the Neta team features this skill in Studio, the name, description and showcase you write here are used first.", 'Add {"en": {"name", "description"}, "zh": {...}, "media": {"works": ["<id or https://neta.art/w/... link of a Work made with this skill and shared publicly>"]}}. skill-creator can write it.');
+    w("no listing.json (optional): if the Neta team features this skill in Studio, the name, description and showcase you write here are used first.", 'Add {"en": {"name", "description"}, "zh": {...}, "media": {"works": ["<id or https://neta.art/w/<id> link of a Work made with this skill and shared publicly>"]}}. skill-creator can write it.');
     return;
   }
   let j;
@@ -29423,13 +29424,17 @@ function checkListing(files, add) {
   if (j.media == null) return;
   const works = j.media?.works;
   if (!Array.isArray(works)) {
-    w('media.works must be a list of Works: ["<id or https://neta.art/w/... link>"].');
+    w('media.works must be a list of Works: ["<id or https://neta.art/w/<id> link>"].');
     return;
   }
   if (works.length > MAX_LISTING_WORKS) w(`media.works has ${works.length} Works; at most ${MAX_LISTING_WORKS} (the Neta team picks one).`);
   for (const x of works) {
     if (typeof x === "string" && (WORK_ID.test(x) || WORK_LINK.test(x))) continue;
-    w(`media.works: "${String(x).slice(0, 80)}" is not a Studio Work. Only Works made in Studio are shown (not links to other sites): they show the skill works in Studio, and sharing them publicly is how you agree to have them shown.`, "Use the id or the https://neta.art/w/... link of a Work made with this skill and shared publicly.");
+    if (typeof x === "string" && APP_LINK.test(x)) {
+      w(`media.works: "${x.slice(0, 80)}" is the Work's page address; the skills site cannot match it to a Work.`, "Use the Work's id, or its https://neta.art/w/<id> link (from the share menu in Studio).");
+      continue;
+    }
+    w(`media.works: "${String(x).slice(0, 80)}" is not a Studio Work. Only Works made in Studio are shown (not links to other sites): they show the skill works in Studio, and sharing them publicly is how you agree to have them shown.`, "Use the id or the https://neta.art/w/<id> link of a Work made with this skill and shared publicly.");
   }
 }
 function lintSkill(dir) {
@@ -29715,11 +29720,55 @@ function finish(opts, id, digest, name, s) {
       } else {
         lines.push("It appears on the public skills site and in find at the next publish (within a few minutes), marked as a community skill. Getting into Studio needs a review.");
       }
+      lines.push(...listingLines(s.listing));
       lines.push(`To take it down later: neta-search skills submit --withdraw ${name} (deleting the directory does not withdraw it).`);
-      return done(opts, base, lines.join("\n"), 0);
+      return done(opts, s.listing ? { ...base, listing: s.listing } : base, lines.join("\n"), 0);
     }
   }
 }
+function listingLines(l) {
+  if (!l) return [];
+  const out = [];
+  const text = Object.entries(l.text ?? {});
+  const okLangs = text.filter(([, c]) => c.ok).map(([lang]) => lang);
+  const badLangs = text.filter(([, c]) => !c.ok);
+  const works = l.works ?? [];
+  const hidden = works.filter((w) => !w.shown);
+  const noted = works.filter((w) => w.shown && w.note);
+  out.push(`listing.json: ${okLangs.length ? `name and description read for ${okLangs.join(", ")}` : "no usable name and description"}${works.length ? `; ${works.length - hidden.length} of ${works.length} showcase Work(s) can be shown` : ""}. This does not affect publishing.`);
+  for (const [lang, c] of badLangs) out.push(`  - ${lang}: ${textProblem(c.reason)}`);
+  for (const w of hidden) out.push(`  - ${w.work}: ${workProblem(w.reason)}`);
+  for (const w of noted) out.push(`  - ${w.work}: ${workNote(w.note)}`);
+  return out;
+}
+function textProblem(r) {
+  switch (r) {
+    case "too_long":
+      return "too long (name at most 80 characters, description at most 300), not used";
+    case "empty":
+      return "name or description is empty, not used";
+    case "invalid":
+      return "not a name and a description (or has control characters), not used";
+    default:
+      return r || "not usable";
+  }
+}
+function workProblem(r) {
+  switch (r) {
+    // 作品进作品表有大约一分钟的延迟；skill-creator 的流程正好是先分享、马上提交（PR #570 review）
+    case "not_found":
+      return "not shown: not found yet. A Work you just shared takes a few minutes to show up, so submit again later; refer to it by its id or its https://neta.art/w/<id> link";
+    case "not_public":
+      return "not shown: not shared publicly yet; choose Public in the Work's share menu in Studio";
+    case "not_yours":
+      return "not shown: it is someone else's Work";
+    default:
+      return `not shown${r ? `: ${r}` : ""}`;
+  }
+}
+function workNote(n) {
+  return n === "not_made_with_this_skill" ? "can be shown, but it does not look like it was made with this skill; the Neta team will check" : n || "";
+}
 function done(opts, json, text, code) {
   if (opts.json) console.log(JSON.stringify(json));
   else (code === 0 ? console.log : console.error)(text);

package/package.json

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