skild 0.1.4 → 0.2.0

package/README.md

@@ -33,3 +33,8 @@ skild uninstall pdf -t codex --local
 # Create a new Skill
 skild init my-skill
 ```
+
+Full user guide (CLI + registry + console):
+
+- `docs/usage.md`
+- `docs/usage.zh-CN.md`

package/dist/index.js

@@ -7,7 +7,7 @@ import { createRequire } from "module";
 
 // src/commands/install.ts
 import chalk2 from "chalk";
-import { installRegistrySkill, installSkill, SkildError } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, resolveRegistryUrl, SkildError } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -95,6 +95,7 @@ async function install(source, options = {}) {
     } else if (record.skill?.validation?.ok) {
       logger.installDetail(`Validation: ${chalk2.green("ok")}`);
     }
+    void reportDownload(record, options.registry);
   } catch (error) {
     spinner.fail(`Failed to install ${chalk2.red(source)}`);
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
@@ -102,6 +103,36 @@ async function install(source, options = {}) {
     process.exitCode = 1;
   }
 }
+async function reportDownload(record, registryOverride) {
+  try {
+    if (record.sourceType === "local") return;
+    const registryUrl = resolveRegistryUrl(record.registryUrl || registryOverride);
+    const endpoint = `${registryUrl}/stats/downloads`;
+    const payload = { source: "cli" };
+    if (record.sourceType === "registry") {
+      payload.entityType = "registry";
+      payload.entityId = record.canonicalName || record.source;
+    } else if (record.sourceType === "github-url") {
+      payload.entityType = "linked";
+      payload.sourceInput = { provider: "github", url: record.source };
+    } else if (record.sourceType === "degit-shorthand") {
+      payload.entityType = "linked";
+      payload.sourceInput = { provider: "github", spec: record.source };
+    } else {
+      return;
+    }
+    await fetchWithTimeout(
+      endpoint,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(payload)
+      },
+      3e3
+    );
+  } catch {
+  }
+}
 
 // src/commands/list.ts
 import chalk3 from "chalk";
@@ -298,7 +329,7 @@ async function init(name, options = {}) {
 
 // src/commands/signup.ts
 import chalk9 from "chalk";
-import { fetchWithTimeout, resolveRegistryUrl, SkildError as SkildError6 } from "@skild/core";
+import { fetchWithTimeout as fetchWithTimeout2, resolveRegistryUrl as resolveRegistryUrl2, SkildError as SkildError6 } from "@skild/core";
 
 // src/utils/prompt.ts
 import readline from "readline";
@@ -332,7 +363,7 @@ async function promptPassword(question) {
 
 // src/commands/signup.ts
 async function signup(options) {
-  const registry = resolveRegistryUrl(options.registry);
+  const registry = resolveRegistryUrl2(options.registry);
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
   const email = options.email?.trim() || "";
   const handle = options.handle?.trim() || "";
@@ -347,7 +378,7 @@ async function signup(options) {
   const finalPassword = password || await promptPassword("Password");
   let text = "";
   try {
-    const res = await fetchWithTimeout(
+    const res = await fetchWithTimeout2(
       `${registry}/auth/signup`,
       {
         method: "POST",
@@ -377,14 +408,31 @@ async function signup(options) {
     return;
   }
   console.log(chalk9.green("Signup successful."));
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed.verification?.requiredForPublish) {
+      if (parsed.verification.mode === "log") {
+        console.log(chalk9.dim("Dev mode: email sending is disabled. Check the registry dev logs for the verification link."));
+      } else if (parsed.verification.sent) {
+        console.log(chalk9.dim("Verification email sent. Check your inbox (and spam)."));
+      } else {
+        console.log(chalk9.yellow("Verification email was not sent. You may need to resend from the Console."));
+      }
+      console.log(chalk9.dim(`Verify/resend in Console: ${(parsed.verification.consoleUrl || "https://console.skild.sh").replace(/\/+$/, "")}/verify-email/request`));
+    } else if (parsed.verification) {
+      console.log(chalk9.dim("Email verification is recommended. Publishing may be restricted in the future."));
+      console.log(chalk9.dim(`Verify/resend in Console: ${(parsed.verification.consoleUrl || "https://console.skild.sh").replace(/\/+$/, "")}/verify-email/request`));
+    }
+  } catch {
+  }
   console.log(chalk9.dim("Next: run `skild login`"));
 }
 
 // src/commands/login.ts
 import chalk10 from "chalk";
-import { fetchWithTimeout as fetchWithTimeout2, resolveRegistryUrl as resolveRegistryUrl2, saveRegistryAuth, SkildError as SkildError7 } from "@skild/core";
+import { fetchWithTimeout as fetchWithTimeout3, resolveRegistryUrl as resolveRegistryUrl3, saveRegistryAuth, SkildError as SkildError7 } from "@skild/core";
 async function login(options) {
-  const registry = resolveRegistryUrl2(options.registry);
+  const registry = resolveRegistryUrl3(options.registry);
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
   const handleOrEmail = options.handleOrEmail?.trim() || "";
   const password = options.password || "";
@@ -398,7 +446,7 @@ async function login(options) {
   const finalTokenName = options.tokenName?.trim() || void 0;
   let text = "";
   try {
-    const res = await fetchWithTimeout2(
+    const res = await fetchWithTimeout3(
       `${registry}/auth/login`,
       {
         method: "POST",
@@ -436,6 +484,10 @@ async function login(options) {
     return;
   }
   console.log(chalk10.green(`Logged in as ${chalk10.cyan(json.publisher.handle)}.`));
+  if (json.publisher.emailVerified === false) {
+    console.log(chalk10.yellow("Email not verified. Publishing may be restricted by server policy."));
+    console.log(chalk10.dim("Open the Publisher Console to verify: https://console.skild.sh/verify-email/request"));
+  }
 }
 
 // src/commands/logout.ts
@@ -448,7 +500,7 @@ async function logout() {
 
 // src/commands/whoami.ts
 import chalk12 from "chalk";
-import { fetchWithTimeout as fetchWithTimeout3, loadRegistryAuth, resolveRegistryUrl as resolveRegistryUrl3, SkildError as SkildError8 } from "@skild/core";
+import { fetchWithTimeout as fetchWithTimeout4, loadRegistryAuth, resolveRegistryUrl as resolveRegistryUrl4, SkildError as SkildError8 } from "@skild/core";
 async function whoami() {
   const auth = loadRegistryAuth();
   if (!auth) {
@@ -456,9 +508,9 @@ async function whoami() {
     process.exitCode = 1;
     return;
   }
-  const registryUrl = resolveRegistryUrl3(auth.registryUrl);
+  const registryUrl = resolveRegistryUrl4(auth.registryUrl);
   try {
-    const res = await fetchWithTimeout3(
+    const res = await fetchWithTimeout4(
       `${registryUrl}/auth/me`,
       { headers: { authorization: `Bearer ${auth.token}`, accept: "application/json" } },
       5e3
@@ -486,7 +538,7 @@ import path from "path";
 import crypto from "crypto";
 import * as tar from "tar";
 import chalk13 from "chalk";
-import { fetchWithTimeout as fetchWithTimeout4, loadRegistryAuth as loadRegistryAuth2, resolveRegistryUrl as resolveRegistryUrl4, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
+import { fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth2, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
 function sha256Hex(buf) {
   const h = crypto.createHash("sha256");
   h.update(buf);
@@ -498,7 +550,7 @@ function parseTargets(raw) {
 }
 async function publish(options = {}) {
   const auth = loadRegistryAuth2();
-  const registry = resolveRegistryUrl4(options.registry || auth?.registryUrl);
+  const registry = resolveRegistryUrl5(options.registry || auth?.registryUrl);
   const token = auth?.token;
   if (!token) {
     console.error(chalk13.red("Not logged in. Run `skild login` first."));
@@ -531,7 +583,7 @@ async function publish(options = {}) {
       process.exitCode = 1;
       return;
     }
-    const meRes = await fetchWithTimeout4(
+    const meRes = await fetchWithTimeout5(
       `${registry}/auth/me`,
       { headers: { authorization: `Bearer ${token}` } },
       1e4
@@ -584,7 +636,7 @@ async function publish(options = {}) {
     form.set("tag", tag);
     form.append("tarball", new Blob([buf], { type: "application/gzip" }), "skill.tgz");
     const { scope, name: skillName } = splitCanonicalName(name);
-    const res = await fetchWithTimeout4(
+    const res = await fetchWithTimeout5(
       `${registry}/skills/${encodeURIComponent(scope)}/${encodeURIComponent(skillName)}/publish`,
       {
         method: "POST",
@@ -605,6 +657,12 @@ async function publish(options = {}) {
       return;
     }
     spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)} (sha256:${integrity.slice(0, 12)}\u2026)`);
+    try {
+      const parsed = JSON.parse(text);
+      const warnings = Array.isArray(parsed.warnings) ? parsed.warnings.map(String).filter(Boolean) : [];
+      for (const w of warnings) console.warn(chalk13.yellow(`Warning: ${w}`));
+    } catch {
+    }
   } catch (error) {
     spinner.fail("Publish failed");
     const message = error instanceof SkildError9 ? error.message : error instanceof Error ? error.message : String(error);
@@ -617,9 +675,9 @@ async function publish(options = {}) {
 
 // src/commands/search.ts
 import chalk14 from "chalk";
-import { resolveRegistryUrl as resolveRegistryUrl5, searchRegistrySkills, SkildError as SkildError10 } from "@skild/core";
+import { resolveRegistryUrl as resolveRegistryUrl6, searchRegistrySkills, SkildError as SkildError10 } from "@skild/core";
 async function search(query, options = {}) {
-  const registryUrl = resolveRegistryUrl5(options.registry);
+  const registryUrl = resolveRegistryUrl6(options.registry);
   const limit = Math.min(Math.max(Number.parseInt(options.limit || "50", 10) || 50, 1), 100);
   try {
     const skills = await searchRegistrySkills(registryUrl, query, limit);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "commander": "^12.1.0",
     "ora": "^8.0.1",
     "tar": "^7.4.3",
-    "@skild/core": "^0.1.4"
+    "@skild/core": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",