rrskill 0.1.0

package/dist/index.js

@@ -0,0 +1,1264 @@
+import * as c from "node:path";
+import * as u from "node:fs/promises";
+import { fileURLToPath as x, pathToFileURL as ht } from "node:url";
+import { readFileSync as mt } from "node:fs";
+import { createHash as gt } from "node:crypto";
+import * as G from "node:os";
+import * as kt from "node:zlib";
+import { promisify as wt } from "node:util";
+const V = ["search", "install", "list", "upgrade", "bootstrap", "doctor", "version"], Z = new Set(V), yt = "--host", vt = "--output", St = /* @__PURE__ */ new Set([yt, vt]), Dt = /* @__PURE__ */ new Set(["--openclaw", "--codex", "--claude-code"]);
+function Q(t) {
+  const s = [];
+  for (let e = 0; e < t.length; e += 1) {
+    const r = t[e];
+    if (r) {
+      if (St.has(r)) {
+        const i = t[e + 1];
+        i && !i.startsWith("--") && !Z.has(i) && (e += 1);
+        continue;
+      }
+      Dt.has(r) || r.startsWith("--") || s.push(r);
+    }
+  }
+  return s;
+}
+function Et(t) {
+  const s = Q(t)[0] ?? "";
+  return s ? Z.has(s) ? { command: s } : { command: "install", slug: s } : { command: "help" };
+}
+async function b(t) {
+  const s = t.fsImpl ?? u;
+  try {
+    return (await s.stat(t.path)).isFile();
+  } catch {
+    return !1;
+  }
+}
+async function Ct(t) {
+  const s = t.fsImpl ?? u;
+  let e;
+  try {
+    e = await s.readFile(t.path, "utf8");
+  } catch {
+    return { ok: !1, issue: { code: "missing_host_config", path: t.path } };
+  }
+  try {
+    const r = JSON.parse(e);
+    return r && typeof r == "object" && !Array.isArray(r) ? { ok: !0, value: r } : {
+      ok: !1,
+      issue: { code: "invalid_host_config_json", path: t.path, error: "root is not a JSON object" }
+    };
+  } catch (r) {
+    return {
+      ok: !1,
+      issue: { code: "invalid_host_config_json", path: t.path, error: r instanceof Error ? r.message : String(r) }
+    };
+  }
+}
+function z(t, s) {
+  let e = t;
+  for (const r of s) {
+    if (!e || typeof e != "object")
+      return;
+    e = e[r];
+  }
+  return e;
+}
+async function X(t, s = {}) {
+  const e = s.fs ?? u, r = [], i = ["find-skills", "rrskill-preference"];
+  for (const d of i) {
+    const f = c.join(t.skillsDir, d, "SKILL.md");
+    await b({ fsImpl: e, path: f }) || r.push({ code: "missing_builtin_skill", slug: d, path: f });
+  }
+  if (t.host !== "openclaw")
+    return r.push({ code: "unsupported_host_bootstrap", host: t.host }), { ok: !1, issues: r };
+  const o = c.join(t.pluginDir, "index.ts"), n = c.join(t.pluginDir, "openclaw.plugin.json");
+  await b({ fsImpl: e, path: o }) || r.push({ code: "missing_plugin_file", path: o }), await b({ fsImpl: e, path: n }) || r.push({ code: "missing_plugin_file", path: n });
+  const l = await Ct({ fsImpl: e, path: t.hostConfigPath });
+  if (!l.ok)
+    return r.push(l.issue), { ok: !1, issues: r };
+  const a = z(l.value, ["plugins", "entries", "rrskill"]);
+  if (!a || typeof a != "object")
+    r.push({ code: "missing_host_plugin_entry", path: t.hostConfigPath });
+  else {
+    const d = [
+      { key: ["plugins", "entries", "rrskill", "enabled"], expected: !0 },
+      { key: ["plugins", "entries", "rrskill", "config", "primaryCli"], expected: "rrskill" },
+      { key: ["plugins", "entries", "rrskill", "config", "primaryLabel"], expected: "official-registry" }
+    ];
+    for (const f of d) {
+      const m = z(l.value, f.key);
+      m !== f.expected && r.push({
+        code: "host_plugin_policy_mismatch",
+        path: t.hostConfigPath,
+        key: f.key.join("."),
+        expected: f.expected,
+        actual: m
+      });
+    }
+  }
+  return { ok: r.length === 0, issues: r };
+}
+function P(t, s) {
+  const e = c.dirname(x(t));
+  return [
+    c.resolve(e, "..", "builtins", s),
+    c.resolve(e, "..", "src", "builtins", s),
+    c.resolve(e, "..", "..", "src", "builtins", s)
+  ];
+}
+async function U(t) {
+  const s = t.fsImpl ?? u;
+  let e;
+  for (const r of t.candidates)
+    try {
+      return await s.readFile(r, "utf8");
+    } catch (i) {
+      e = i;
+    }
+  throw new Error(`Failed to load ${t.assetLabel} from candidates: ${t.candidates.join(", ")} (${String(e)})`);
+}
+async function $(t) {
+  const s = t.fsImpl ?? u, e = t.content.endsWith(`
+`) ? t.content : `${t.content}
+`;
+  try {
+    if (await s.readFile(t.path, "utf8") === e)
+      return !1;
+  } catch {
+  }
+  return await s.mkdir(c.dirname(t.path), { recursive: !0 }), await s.writeFile(t.path, e, "utf8"), !0;
+}
+const J = ["find-skills", "rrskill-preference"];
+function _t(t) {
+  return t === "find-skills" ? "skills/find-skills.md" : "skills/rrskill-preference.md";
+}
+async function Lt(t, s = {}) {
+  const e = s.fs ?? u;
+  let r = !1;
+  for (const i of J) {
+    const o = await U({
+      candidates: P(import.meta.url, _t(i)),
+      fsImpl: e,
+      assetLabel: "built-in skill asset"
+    }), n = c.join(t.skillsDir, i, "SKILL.md"), l = await $({ path: n, content: o, fsImpl: e });
+    r = r || l;
+  }
+  return { installed: [...J], changed: r };
+}
+async function xt(t, s = {}) {
+  const e = s.fs ?? u;
+  if (t.host !== "openclaw")
+    return { installed: !1, changed: !1 };
+  const r = await U({
+    candidates: P(import.meta.url, "plugins/openclaw/index.ts"),
+    fsImpl: e,
+    assetLabel: "built-in plugin asset"
+  }), i = await U({
+    candidates: P(import.meta.url, "plugins/openclaw/openclaw.plugin.json"),
+    fsImpl: e,
+    assetLabel: "built-in plugin asset"
+  }), o = c.join(t.pluginDir, "index.ts"), n = c.join(t.pluginDir, "openclaw.plugin.json"), l = await $({ path: o, content: r, fsImpl: e }), a = await $({ path: n, content: i, fsImpl: e });
+  return { installed: !0, changed: l || a };
+}
+function Y(t) {
+  return !!t && typeof t == "object" && !Array.isArray(t);
+}
+function E(t, s) {
+  const e = t[s];
+  if (Y(e))
+    return e;
+  const r = {};
+  return t[s] = r, r;
+}
+async function jt(t) {
+  const s = t.fsImpl ?? u;
+  try {
+    const e = await s.readFile(t.path, "utf8");
+    try {
+      const r = JSON.parse(e);
+      return Y(r) ? { object: r, exists: !0, parseOk: !0, rawText: e } : { object: {}, exists: !0, parseOk: !1, rawText: e, parseError: "root is not a JSON object" };
+    } catch (r) {
+      return {
+        object: {},
+        exists: !0,
+        parseOk: !1,
+        rawText: e,
+        parseError: r instanceof Error ? r.message : String(r)
+      };
+    }
+  } catch {
+    return { object: {}, exists: !1, parseOk: !1 };
+  }
+}
+async function bt(t) {
+  const s = t.fsImpl ?? u, e = `${JSON.stringify(t.value, null, 2)}
+`;
+  return t.prevRawText !== void 0 && t.prevRawText === e ? !1 : (await s.mkdir(c.dirname(t.path), { recursive: !0 }), await s.writeFile(t.path, e, "utf8"), !0);
+}
+async function Ot(t) {
+  const s = t.fsImpl ?? u, e = await jt({ fsImpl: s, path: t.hostConfigPath });
+  if (e.exists && !e.parseOk)
+    throw new Error(
+      `Invalid OpenClaw config JSON at ${t.hostConfigPath}: ${e.parseError ?? "unknown parse error"}`
+    );
+  const r = e.object, i = E(r, "plugins"), o = E(i, "entries"), n = E(o, "rrskill"), l = E(n, "config");
+  let a = !e.exists || !e.parseOk;
+  return n.enabled !== !0 && (n.enabled = !0, a = !0), l.primaryCli !== "rrskill" && (l.primaryCli = "rrskill", a = !0), l.primaryLabel !== "official-registry" && (l.primaryLabel = "official-registry", a = !0), a ? bt({
+    fsImpl: s,
+    path: t.hostConfigPath,
+    value: r,
+    prevRawText: e.rawText
+  }) : !1;
+}
+async function It(t, s = {}) {
+  const e = s.fs ?? u, r = await Lt({ skillsDir: t.skillsDir }, { fs: e }), i = await xt({ host: t.host, pluginDir: t.pluginDir }, { fs: e });
+  let o = !1;
+  return t.host === "openclaw" && (o = await Ot({ fsImpl: e, hostConfigPath: t.hostConfigPath })), {
+    builtinsInstalled: r.installed,
+    pluginInstalled: i.installed,
+    hostConfigRepaired: o
+  };
+}
+async function tt(t, s = {}) {
+  const e = s.fs ?? u, r = await It(
+    {
+      host: t.host,
+      skillsDir: t.skillsDir,
+      pluginDir: t.pluginDir,
+      hostConfigPath: t.hostConfigPath
+    },
+    { fs: e }
+  ), i = await X(
+    {
+      host: t.host,
+      skillsDir: t.skillsDir,
+      pluginDir: t.pluginDir,
+      hostConfigPath: t.hostConfigPath
+    },
+    { fs: e }
+  );
+  return {
+    builtinsInstalled: r.builtinsInstalled,
+    pluginInstalled: r.pluginInstalled,
+    hostConfigRepaired: r.hostConfigRepaired,
+    verification: i
+  };
+}
+function C(t, s) {
+  const e = new Set(s.map((n) => n.code)), r = new Set(
+    s.filter((n) => n.code === "missing_builtin_skill").map((n) => n.slug)
+  ), i = new Set(
+    s.filter((n) => n.code === "missing_plugin_file").map((n) => n.path)
+  ), o = s.some(
+    (n) => [
+      "missing_host_config",
+      "invalid_host_config_json",
+      "missing_host_plugin_entry",
+      "host_plugin_policy_mismatch"
+    ].includes(n.code)
+  );
+  return [
+    {
+      name: "builtin_find-skills",
+      ok: !r.has("find-skills"),
+      message: r.has("find-skills") ? "missing built-in skill" : "built-in skill installed",
+      path: c.join(t.skillsDir, "find-skills", "SKILL.md")
+    },
+    {
+      name: "builtin_rrskill-preference",
+      ok: !r.has("rrskill-preference"),
+      message: r.has("rrskill-preference") ? "missing built-in skill" : "built-in skill installed",
+      path: c.join(t.skillsDir, "rrskill-preference", "SKILL.md")
+    },
+    {
+      name: "plugin_index",
+      ok: !i.has(c.join(t.pluginDir, "index.ts")),
+      message: i.has(c.join(t.pluginDir, "index.ts")) ? "missing OpenClaw plugin entry file" : "OpenClaw plugin entry file present",
+      path: c.join(t.pluginDir, "index.ts")
+    },
+    {
+      name: "plugin_manifest",
+      ok: !i.has(c.join(t.pluginDir, "openclaw.plugin.json")),
+      message: i.has(c.join(t.pluginDir, "openclaw.plugin.json")) ? "missing OpenClaw plugin manifest" : "OpenClaw plugin manifest present",
+      path: c.join(t.pluginDir, "openclaw.plugin.json")
+    },
+    {
+      name: "host_config",
+      ok: !o,
+      message: o ? "OpenClaw host config is missing or does not match rrskill policy" : "OpenClaw host config matches rrskill policy",
+      path: t.hostConfigPath
+    },
+    {
+      name: "bootstrap_supported",
+      ok: !e.has("unsupported_host_bootstrap"),
+      message: "bootstrap integration is supported for openclaw"
+    }
+  ];
+}
+async function Pt(t, s = {}, e = {}) {
+  const r = e.fs ?? u, i = {
+    skillsDir: t.skillsDir,
+    pluginDir: t.pluginDir,
+    hostConfigPath: t.hostConfigPath
+  };
+  if (t.host !== "openclaw")
+    return {
+      ok: !0,
+      host: t.host,
+      bootstrapSupported: !1,
+      fixed: !1,
+      dryRun: s.dryRun ?? !1,
+      checks: [
+        {
+          name: "cli_available",
+          ok: !0,
+          message: "rrskill CLI is running"
+        },
+        {
+          name: "bootstrap_supported",
+          ok: !0,
+          message: `${t.host} currently uses CLI-only initialization; bootstrap repair is not implemented`
+        }
+      ],
+      issues: [],
+      nextCommands: ["rrskill search <query>", "rrskill install <slug>"],
+      paths: i
+    };
+  const o = await X(t, {
+    fs: r
+  });
+  if (o.ok)
+    return {
+      ok: !0,
+      host: t.host,
+      bootstrapSupported: !0,
+      fixed: !1,
+      dryRun: s.dryRun ?? !1,
+      checks: C(t, []),
+      issues: [],
+      nextCommands: [],
+      paths: i,
+      verification: o
+    };
+  if (s.dryRun)
+    return {
+      ok: !1,
+      host: t.host,
+      bootstrapSupported: !0,
+      fixed: !1,
+      dryRun: !0,
+      checks: C(t, o.issues),
+      issues: o.issues,
+      nextCommands: ["rrskill bootstrap --host openclaw"],
+      paths: i,
+      verification: o
+    };
+  if (s.fix) {
+    const n = await tt(t, {
+      fs: r
+    });
+    return {
+      ok: n.verification.ok,
+      host: t.host,
+      bootstrapSupported: !0,
+      fixed: !0,
+      dryRun: !1,
+      checks: C(
+        t,
+        n.verification.ok ? [] : n.verification.issues
+      ),
+      issues: n.verification.ok ? [] : n.verification.issues,
+      nextCommands: n.verification.ok ? [] : ["rrskill bootstrap --host openclaw"],
+      paths: i,
+      verification: n.verification
+    };
+  }
+  return {
+    ok: !1,
+    host: t.host,
+    bootstrapSupported: !0,
+    fixed: !1,
+    dryRun: !1,
+    checks: C(t, o.issues),
+    issues: o.issues,
+    nextCommands: ["rrskill bootstrap --host openclaw"],
+    paths: i,
+    verification: o
+  };
+}
+function Ut(t) {
+  return t.HOME ?? t.USERPROFILE ?? process.env.HOME ?? process.env.USERPROFILE ?? process.cwd();
+}
+function M(t, s) {
+  const e = t?.trim();
+  if (e)
+    return e === "~" ? s : e.startsWith("~/") ? c.resolve(s, e.slice(2)) : c.resolve(e);
+}
+function O(t, s) {
+  for (const e of s) {
+    const r = t[e];
+    if (typeof r == "string" && r.trim())
+      return r.trim();
+  }
+}
+function $t(t, s) {
+  if (typeof t != "object" || t === null || Array.isArray(t))
+    throw new Error(
+      `Invalid rrskill config at ${s}: root must be a JSON object`
+    );
+  return t;
+}
+async function At(t) {
+  const s = Ut(t.env), e = M(t.env.RRSKILL_CONFIG_PATH, s) ?? c.resolve(s, ".rrskill", "config.json");
+  try {
+    const r = await u.readFile(e, "utf8"), i = $t(JSON.parse(r), e);
+    return {
+      configPath: e,
+      host: O(i, ["host"]),
+      stateDir: M(
+        O(i, ["stateDir", "state_dir"]),
+        s
+      ),
+      skillsSearchUrl: O(i, [
+        "skillsSearchUrl",
+        "skills_search_url"
+      ])
+    };
+  } catch (r) {
+    if ((typeof r == "object" && r !== null && "code" in r ? String(r.code) : void 0) === "ENOENT")
+      return { configPath: e };
+    throw r instanceof SyntaxError ? new Error(
+      `Invalid rrskill config JSON at ${e}: ${r.message}`
+    ) : r;
+  }
+}
+const Rt = "openclaw", Ft = "--host", q = {
+  "--openclaw": "openclaw",
+  "--codex": "codex",
+  "--claude-code": "claude-code"
+}, st = [
+  "openclaw",
+  "codex",
+  "claude-code"
+], Ht = new Set(st), Nt = new Set(V);
+function Tt(t) {
+  if (!t)
+    return;
+  const s = t.trim().toLowerCase();
+  if (s && Ht.has(s))
+    return s;
+}
+function I(t, s) {
+  if (t === void 0)
+    return;
+  const e = Tt(t);
+  if (e)
+    return e;
+  const r = t.trim();
+  if (r)
+    throw new Error(
+      `Unsupported host "${r}" from ${s}. Supported hosts: ${st.join(", ")}`
+    );
+}
+function zt(t) {
+  const s = t.indexOf(Ft);
+  if (s < 0)
+    return;
+  const e = t[s + 1];
+  if (!(!e || e.startsWith("--") || Nt.has(e)))
+    return e;
+}
+function Jt(t) {
+  const s = t.filter((r) => r in q).map((r) => q[r]);
+  if (s.length === 0)
+    return;
+  const e = Array.from(new Set(s));
+  if (e.length > 1)
+    throw new Error(`Conflicting host flags: ${e.join(", ")}`);
+  return e[0];
+}
+function Mt(t) {
+  const s = Jt(t.argv), e = I(
+    zt(t.argv),
+    "--host"
+  );
+  if (s && e && s !== e)
+    throw new Error(
+      `Conflicting host flags: ${s} vs ${e}`
+    );
+  const r = e ?? s;
+  if (r)
+    return r;
+  const i = I(t.env.RRSKILL_HOST, "RRSKILL_HOST");
+  if (i)
+    return i;
+  const o = t.config.configPath ? `config ${t.config.configPath}` : "config", n = I(t.config.host, o);
+  return n || Rt;
+}
+function qt(t) {
+  const s = t.env.HOME ?? t.env.USERPROFILE ?? process.env.HOME ?? process.env.USERPROFILE ?? process.cwd(), e = t.config.stateDir ?? `${s}/.rrskill`;
+  return { homeDir: s, stateDir: e };
+}
+const Kt = {
+  name: "openclaw",
+  getDefaultPaths({ homeDir: t }) {
+    return {
+      skillsDir: `${t}/.openclaw/workspace/skills`,
+      pluginDir: `${t}/.openclaw/extensions/rrskill`,
+      hostConfigPath: `${t}/.openclaw/openclaw.json`
+    };
+  }
+}, Wt = {
+  name: "codex",
+  getDefaultPaths({ homeDir: t, stateDir: s }) {
+    const e = s ?? `${t}/.rrskill`;
+    return {
+      skillsDir: `${e}/hosts/codex/skills`,
+      pluginDir: `${e}/hosts/codex/plugin`,
+      hostConfigPath: `${t}/.codex/config.toml`
+    };
+  }
+}, Bt = {
+  name: "claude-code",
+  getDefaultPaths({ homeDir: t, stateDir: s }) {
+    const e = s ?? `${t}/.rrskill`;
+    return {
+      skillsDir: `${e}/hosts/claude-code/skills`,
+      pluginDir: `${e}/hosts/claude-code/plugin`,
+      hostConfigPath: `${t}/.claude/settings.json`
+    };
+  }
+};
+async function K(t) {
+  const s = await At({ env: t.env }), e = Mt({ argv: t.argv, env: t.env, config: s }), r = qt({ env: t.env, config: s }), i = e === "openclaw" ? Kt.getDefaultPaths({ homeDir: r.homeDir, stateDir: r.stateDir }) : e === "codex" ? Wt.getDefaultPaths({ homeDir: r.homeDir, stateDir: r.stateDir }) : Bt.getDefaultPaths({ homeDir: r.homeDir, stateDir: r.stateDir });
+  return {
+    argv: t.argv,
+    env: t.env,
+    host: e,
+    distribution: "npm",
+    stateDir: r.stateDir,
+    skillsDir: i.skillsDir,
+    pluginDir: i.pluginDir,
+    hostConfigPath: i.hostConfigPath,
+    paths: r,
+    config: s
+  };
+}
+const Gt = ".rrskill_lock.json";
+function A() {
+  return { version: 1, skills: {} };
+}
+function et(t) {
+  return c.join(t, Gt);
+}
+function rt(t, s) {
+  const e = c.resolve(t), r = c.resolve(e, s), i = e.endsWith(c.sep) ? e : `${e}${c.sep}`;
+  if (!r.startsWith(i))
+    throw new Error(`Refusing to write outside skillsDir: slug="${s}"`);
+  return r;
+}
+function k(t) {
+  return typeof t == "object" && t !== null;
+}
+function W(t, s) {
+  if (!k(s)) return;
+  const e = typeof s.slug == "string" ? s.slug : t, r = typeof s.installedAt == "string" ? s.installedAt : void 0, i = typeof s.version == "string" ? s.version : void 0, o = k(s.source) || i ? {
+    type: "registry",
+    version: (k(s.source) && typeof s.source.version == "string" ? s.source.version : void 0) ?? i
+  } : void 0;
+  return { slug: e, installedAt: r, source: o };
+}
+function Vt(t) {
+  if (!k(t)) return A();
+  if (t.version === 1 && k(t.skills)) {
+    const i = {};
+    for (const [o, n] of Object.entries(t.skills)) {
+      const l = W(o, n);
+      l && (i[o] = l);
+    }
+    return { version: 1, skills: i };
+  }
+  const s = Object.hasOwn(t, "version"), e = Object.hasOwn(t, "skills");
+  if (s || e)
+    return A();
+  const r = {};
+  for (const [i, o] of Object.entries(t)) {
+    const n = W(i, o);
+    n && (r[i] = n);
+  }
+  return { version: 1, skills: r };
+}
+async function F(t) {
+  const s = et(t.skillsDir);
+  try {
+    const e = await t.fs.readFile(s, "utf8"), r = JSON.parse(e);
+    return Vt(r);
+  } catch (e) {
+    if ((k(e) && typeof e.code == "string" ? e.code : void 0) === "ENOENT") return A();
+    throw e;
+  }
+}
+async function it(t) {
+  const s = et(t.skillsDir);
+  await t.fs.mkdir(t.skillsDir, { recursive: !0 });
+  const e = `${s}.tmp`, r = `${JSON.stringify(t.lockfile, null, 2)}
+`;
+  await t.fs.writeFile(e, r, "utf8"), await t.fs.rename(e, s);
+}
+function nt(t, s) {
+  return {
+    version: 1,
+    skills: {
+      ...t.skills,
+      [s.slug]: s
+    }
+  };
+}
+function Zt() {
+  return /* @__PURE__ */ new Date();
+}
+async function Qt(t) {
+  const s = t.fsImpl ?? u;
+  await s.mkdir(t.targetDir, { recursive: !0 });
+  const e = c.join(t.targetDir, "rrskill.json");
+  await s.writeFile(
+    e,
+    `${JSON.stringify({ slug: t.slug, installedBy: "rrskill-cli", schema: 1 }, null, 2)}
+`,
+    "utf8"
+  );
+}
+async function Xt(t, s, e = {}) {
+  const r = e.fs ?? u, i = e.now ?? Zt;
+  let o;
+  if (e.searchSkills && (o = (await e.searchSkills({ query: s })).results.find((m) => m.slug === s), !o))
+    throw new Error(`No exact registry match for slug "${s}"`);
+  const n = rt(t.skillsDir, s);
+  let l = o?.version;
+  e.downloadSkill ? (await r.mkdir(n, { recursive: !0 }), l = (await e.downloadSkill({ slug: s, targetDir: n, registrySkill: o })).version ?? l) : await Qt({ slug: s, targetDir: n, fsImpl: r });
+  const a = await F({ skillsDir: t.skillsDir, fs: r }), d = nt(a, {
+    slug: s,
+    installedAt: i().toISOString(),
+    source: { type: "registry", version: l }
+  });
+  return await it({ skillsDir: t.skillsDir, fs: r, lockfile: d }), {
+    slug: s,
+    targetDir: n,
+    registryMatch: o
+  };
+}
+async function Yt(t, s = {}) {
+  const e = s.fs ?? u, r = await F({ skillsDir: t.skillsDir, fs: e });
+  return Object.keys(r.skills).sort();
+}
+async function ts(t, s, e) {
+  return e.searchSkills({ query: s });
+}
+async function ss(t, s = {}) {
+  const e = s.fs ?? u, r = s.now ?? (() => /* @__PURE__ */ new Date()), i = await F({ skillsDir: t.skillsDir, fs: e }), o = Object.keys(i.skills).sort();
+  if (!s.downloadSkill)
+    return { upgraded: [] };
+  const n = [];
+  let l = i;
+  for (const a of o) {
+    const d = rt(t.skillsDir, a);
+    await e.mkdir(d, { recursive: !0 });
+    const f = await s.downloadSkill({ slug: a, targetDir: d });
+    n.push(a);
+    const m = l.skills[a];
+    l = nt(l, {
+      slug: a,
+      installedAt: r().toISOString(),
+      source: {
+        type: "registry",
+        version: f.version ?? m?.source?.version
+      }
+    }), await it({ skillsDir: t.skillsDir, fs: e, lockfile: l });
+  }
+  return { upgraded: n };
+}
+function es(t) {
+  let s = c.dirname(x(t));
+  for (; ; ) {
+    const e = c.join(s, "package.json");
+    try {
+      return JSON.parse(mt(e, "utf8"));
+    } catch {
+      const r = c.dirname(s);
+      if (r === s)
+        return {};
+      s = r;
+    }
+  }
+}
+function rs(t = {}) {
+  const s = es(import.meta.url);
+  return {
+    packageName: t.packageName ?? s.name ?? "rrskill",
+    version: t.version ?? s.version ?? "0.0.0-dev",
+    updateVia: "npm",
+    instructions: ["npm install -g rrskill@latest", "npm install -g @rrskill/cli@latest"]
+  };
+}
+const is = wt(kt.inflateRaw), ns = "https://api.rrskill.ai/skills?page=1&size={limit}&search={query}&orderBy=downloadCount&order=desc", os = 20;
+function _(t) {
+  return typeof t == "object" && t !== null && !Array.isArray(t);
+}
+function p(t, s) {
+  for (const e of s) {
+    const r = t[e];
+    if (typeof r == "string" && r.trim())
+      return r.trim();
+  }
+}
+function j(t) {
+  try {
+    return new URL(t);
+  } catch {
+    return;
+  }
+}
+function as(t, s, e, r) {
+  const i = s.RRSKILL_SKILLS_SEARCH_URL?.trim() || s.RRSKILL_SEARCH_URL?.trim() || t.skillsSearchUrl?.trim() || ns, o = i.replaceAll("{query}", encodeURIComponent(e)).replaceAll("{limit}", String(r)), n = j(o);
+  return n && ["http:", "https:"].includes(n.protocol) ? (i.includes("{query}") || ["search", "q", "keyword", "slug"].some(
+    (l) => n.searchParams.has(l)
+  ) || n.searchParams.set("search", e), i.includes("{limit}") || ["limit", "size"].some((l) => n.searchParams.has(l)) || n.searchParams.set("limit", String(r)), n.toString()) : o;
+}
+async function ls(t) {
+  const s = j(t);
+  if (s?.protocol === "http:" || s?.protocol === "https:") {
+    const r = await fetch(t, {
+      headers: {
+        accept: "application/json"
+      }
+    });
+    if (!r.ok)
+      throw new Error(
+        `Search request failed: ${r.status} ${r.statusText}`
+      );
+    return {
+      payload: await r.text(),
+      reference: r.url || t
+    };
+  }
+  if (s?.protocol === "file:") {
+    const r = x(s);
+    return {
+      payload: await u.readFile(r, "utf8"),
+      reference: s.toString()
+    };
+  }
+  const e = c.resolve(t);
+  return {
+    payload: await u.readFile(e, "utf8"),
+    reference: ht(e).toString()
+  };
+}
+function cs(t, s) {
+  if (t)
+    try {
+      return new URL(t, s).toString();
+    } catch {
+      return;
+    }
+}
+function ot(t, s, e) {
+  const r = s?.trim().toLowerCase();
+  if (!r)
+    return;
+  const i = gt("sha256").update(t).digest("hex").toLowerCase();
+  if (i !== r)
+    throw new Error(
+      `SHA256 mismatch for ${e}: expected ${r}, got ${i}`
+    );
+}
+function us(t, s) {
+  const e = p(t, ["slug"]);
+  if (!e)
+    return;
+  const r = _(t.currentVersion) ? t.currentVersion : {}, i = cs(
+    p(r, [
+      "skillUrl",
+      "downloadUrl",
+      "packageUrl",
+      "url"
+    ]) ?? p(t, ["skillUrl", "downloadUrl", "packageUrl", "url"]),
+    s
+  );
+  return {
+    slug: e,
+    title: p(t, ["displayName", "name", "title"]) ?? e,
+    description: p(t, ["summary", "description"]),
+    version: p(r, ["version"]) ?? p(t, ["version"]),
+    skillUrl: i,
+    sha256: p(r, ["sha256"]) ?? p(t, ["sha256", "checksum"]),
+    source: p(t, ["source", "platform"])
+  };
+}
+function fs(t, s, e) {
+  let r;
+  try {
+    r = JSON.parse(t);
+  } catch (a) {
+    throw new Error(
+      `Search response is not valid JSON: ${a instanceof Error ? a.message : String(a)}`
+    );
+  }
+  if (!_(r))
+    throw new Error("Search API response must be a JSON object.");
+  let i = r.results;
+  if (!Array.isArray(i)) {
+    const a = _(r.data) ? r.data : void 0;
+    a && Array.isArray(a.records) && (i = a.records);
+  }
+  if (!Array.isArray(i))
+    throw new Error(
+      'Search API response must include "results" or "data.records" array.'
+    );
+  const o = e.trim().toLowerCase(), n = !["http:", "https:"].includes(
+    j(s)?.protocol ?? ""
+  ), l = i.filter(_).map((a) => us(a, s)).filter((a) => a !== void 0).filter((a) => n && o ? [a.slug, a.title, a.description].filter(
+    (f) => !!f
+  ).some(
+    (f) => f.toLowerCase().includes(o)
+  ) : !0);
+  return { query: e, results: l };
+}
+function ds(t) {
+  return async ({ query: s }) => {
+    const e = as(
+      t.config,
+      t.env,
+      s,
+      os
+    ), { payload: r, reference: i } = await ls(e);
+    return fs(r, i, s);
+  };
+}
+async function at(t, s) {
+  const e = [];
+  let n = -1;
+  for (let d = t.length - 22; d >= Math.max(0, t.length - 65557); d -= 1)
+    if (t.readUInt32LE(d) === 101010256) {
+      n = d;
+      break;
+    }
+  if (n < 0)
+    throw new Error("Downloaded skill package is not a valid zip archive.");
+  const l = t.readUInt16LE(n + 10);
+  let a = t.readUInt32LE(n + 16);
+  await u.mkdir(s, { recursive: !0 });
+  for (let d = 0; d < l; d += 1) {
+    if (t.readUInt32LE(a) !== 33639248)
+      throw new Error(
+        "Downloaded skill package has an invalid zip central directory."
+      );
+    const f = t.readUInt16LE(a + 10), m = t.readUInt32LE(a + 20), lt = t.readUInt32LE(a + 24), H = t.readUInt16LE(a + 28), ct = t.readUInt16LE(a + 30), ut = t.readUInt16LE(a + 32), v = t.readUInt32LE(a + 42), S = t.toString(
+      "utf8",
+      a + 46,
+      a + 46 + H
+    );
+    a += 46 + H + ct + ut;
+    const g = S.replaceAll("\\", "/");
+    if (!g || g.startsWith("/") || g.includes("../"))
+      throw new Error(`Unsafe zip path entry detected: ${S}`);
+    const y = c.resolve(s, g), ft = s.endsWith(c.sep) ? s : `${s}${c.sep}`;
+    if (y !== s && !y.startsWith(ft))
+      throw new Error(`Unsafe zip path entry detected: ${S}`);
+    if (t.readUInt32LE(v) !== 67324752)
+      throw new Error(
+        "Downloaded skill package has an invalid zip local header."
+      );
+    const dt = t.readUInt16LE(v + 26), pt = t.readUInt16LE(v + 28), N = v + 30 + dt + pt, T = t.subarray(
+      N,
+      N + m
+    );
+    if (g.endsWith("/")) {
+      await u.mkdir(y, { recursive: !0 });
+      continue;
+    }
+    let D;
+    if (f === 0)
+      D = Buffer.from(T);
+    else if (f === 8)
+      D = Buffer.from(await is(T));
+    else
+      throw new Error(
+        `Unsupported zip compression method: ${f}`
+      );
+    if (D.length !== lt)
+      throw new Error(`Zip entry size mismatch for ${S}`);
+    await u.mkdir(c.dirname(y), { recursive: !0 }), await u.writeFile(y, D), e.push(g);
+  }
+  return e;
+}
+async function R(t, s) {
+  await u.rm(s, { recursive: !0, force: !0 }), await u.mkdir(c.dirname(s), { recursive: !0 }), await u.cp(t, s, { recursive: !0 });
+}
+async function ps(t, s, e) {
+  if ((await u.stat(t)).isDirectory())
+    return await R(t, s), [];
+  const i = await u.readFile(t);
+  ot(i, e, t);
+  const o = await u.mkdtemp(
+    c.join(G.tmpdir(), "rrskill-registry-stage-")
+  );
+  try {
+    const n = await at(i, o);
+    return await R(o, s), n;
+  } finally {
+    await u.rm(o, { recursive: !0, force: !0 });
+  }
+}
+async function hs(t, s, e) {
+  const r = await fetch(t, {
+    headers: {
+      accept: "application/zip,application/octet-stream,*/*"
+    }
+  });
+  if (!r.ok)
+    throw new Error(
+      `Skill download failed: ${r.status} ${r.statusText}`
+    );
+  const i = Buffer.from(await r.arrayBuffer());
+  ot(i, e, t);
+  const o = await u.mkdtemp(
+    c.join(G.tmpdir(), "rrskill-registry-stage-")
+  );
+  try {
+    const n = await at(i, o);
+    return await R(o, s), n;
+  } finally {
+    await u.rm(o, { recursive: !0, force: !0 });
+  }
+}
+async function ms(t, s) {
+  const r = (await t({ query: s })).results.find((i) => i.slug === s);
+  if (!r)
+    throw new Error(`No exact registry match for slug "${s}"`);
+  return r;
+}
+async function gs(t, s) {
+  const e = s.registrySkill?.slug === s.slug ? s.registrySkill : await ms(t, s.slug), r = e.skillUrl;
+  if (!r)
+    throw new Error(
+      `Registry skill "${s.slug}" does not define a skillUrl/packageUrl`
+    );
+  const i = j(r), o = e.sha256, n = i?.protocol === "http:" || i?.protocol === "https:" ? await hs(
+    r,
+    s.targetDir,
+    o
+  ) : await ps(
+    i?.protocol === "file:" ? x(i) : c.resolve(r),
+    s.targetDir,
+    o
+  );
+  return {
+    slug: s.slug,
+    targetDir: s.targetDir,
+    writtenFiles: n,
+    version: e.version
+  };
+}
+function ks(t) {
+  return async (s) => gs(t, s);
+}
+class w extends Error {
+  code;
+  hint;
+  nextCommands;
+  constructor(s) {
+    super(s.message), this.code = s.code, this.hint = s.hint, this.nextCommands = s.nextCommands ?? [];
+  }
+}
+function ws() {
+  const t = process.argv[1] ?? "";
+  return t ? c.basename(t) === "rrskill.js" ? !0 : import.meta.url === `file://${t}` : !1;
+}
+function ys() {
+  return [
+    "rrskill CLI",
+    "",
+    "Usage:",
+    "  rrskill <slug>",
+    "  rrskill <command> [options]",
+    "",
+    "Commands:",
+    "  rrskill <slug>",
+    "  rrskill install <slug>",
+    "  rrskill search <query>",
+    "  rrskill list",
+    "  rrskill upgrade",
+    "  rrskill bootstrap --host <openclaw|codex|claude-code>",
+    "  rrskill doctor --host <openclaw|codex|claude-code>",
+    "  rrskill version",
+    "",
+    "Global options:",
+    "  --host <name>",
+    "  --openclaw",
+    "  --codex",
+    "  --claude-code",
+    "  --output <json|text>",
+    "  --json",
+    "  -h, --help",
+    "",
+    "Examples:",
+    "  rrskill doctor --host openclaw",
+    "  rrskill doctor --host openclaw --fix",
+    "  rrskill bootstrap --host openclaw",
+    "  rrskill search react",
+    "  rrskill install web-search --host codex"
+  ].join(`
+`);
+}
+function vs(t) {
+  const s = [
+    "",
+    "Global options:",
+    "  --host <name>",
+    "  --openclaw",
+    "  --codex",
+    "  --claude-code",
+    "  --output <json|text>",
+    "  --json"
+  ];
+  return t === "search" ? [
+    "rrskill search",
+    "",
+    "Usage:",
+    "  rrskill search <query>",
+    "",
+    "Examples:",
+    "  rrskill search react",
+    "  rrskill search browser automation --host codex",
+    ...s
+  ].join(`
+`) : t === "install" ? [
+    "rrskill install",
+    "",
+    "Usage:",
+    "  rrskill install <slug>",
+    "  rrskill <slug>",
+    "",
+    "Examples:",
+    "  rrskill install web-search",
+    "  rrskill web-search --host codex",
+    ...s
+  ].join(`
+`) : t === "list" ? [
+    "rrskill list",
+    "",
+    "Usage:",
+    "  rrskill list",
+    "",
+    "Examples:",
+    "  rrskill list",
+    "  rrskill list --host claude-code",
+    ...s
+  ].join(`
+`) : t === "upgrade" ? [
+    "rrskill upgrade",
+    "",
+    "Usage:",
+    "  rrskill upgrade",
+    "",
+    "Examples:",
+    "  rrskill upgrade",
+    "  rrskill upgrade --host codex",
+    ...s
+  ].join(`
+`) : t === "bootstrap" ? [
+    "rrskill bootstrap",
+    "",
+    "Usage:",
+    "  rrskill bootstrap --host <openclaw|codex|claude-code>",
+    "",
+    "Examples:",
+    "  rrskill bootstrap --host openclaw",
+    "  rrskill bootstrap --openclaw",
+    ...s
+  ].join(`
+`) : t === "doctor" ? [
+    "rrskill doctor",
+    "",
+    "Usage:",
+    "  rrskill doctor --host <openclaw|codex|claude-code> [--fix] [--dry-run]",
+    "",
+    "Options:",
+    "  --fix      Attempt host repair when bootstrap support exists",
+    "  --dry-run  Show the verification plan without making changes",
+    "",
+    "Examples:",
+    "  rrskill doctor --host openclaw",
+    "  rrskill doctor --host openclaw --fix",
+    "  rrskill doctor --host openclaw --dry-run --output json",
+    ...s
+  ].join(`
+`) : [
+    "rrskill version",
+    "",
+    "Usage:",
+    "  rrskill version",
+    "",
+    "Examples:",
+    "  rrskill version",
+    "  rrskill version --output json",
+    ...s
+  ].join(`
+`);
+}
+function h(t) {
+  process.stdout.write(`${JSON.stringify(t, null, 2)}
+`);
+}
+function L(t, ...s) {
+  return t.some((e) => s.includes(e));
+}
+function Ss(t, s) {
+  const e = t.indexOf(s);
+  if (e < 0)
+    return;
+  const r = t[e + 1];
+  if (!(!r || r.startsWith("--")))
+    return r;
+}
+function Ds(t) {
+  if (L(t, "--json"))
+    return "json";
+  const s = Ss(t, "--output");
+  if (!s) {
+    if (t.includes("--output"))
+      throw new w({
+        code: "missing_output_mode",
+        message: "--output requires a value.",
+        hint: "rrskill --output <json|text>",
+        nextCommands: ["rrskill --help"]
+      });
+    return "text";
+  }
+  if (s === "json" || s === "text")
+    return s;
+  throw new w({
+    code: "invalid_output_mode",
+    message: `Unsupported output mode "${s}".`,
+    hint: "rrskill --output <json|text>",
+    nextCommands: ["rrskill --help"]
+  });
+}
+function B(t, s) {
+  if (t instanceof w && s === "json") {
+    h({
+      ok: !1,
+      error: {
+        code: t.code,
+        message: t.message,
+        hint: t.hint
+      },
+      next_commands: t.nextCommands
+    });
+    return;
+  }
+  if (t instanceof w) {
+    const r = [`Error: ${t.message}`];
+    if (t.hint && r.push(`  ${t.hint}`), t.nextCommands.length > 0) {
+      r.push("Next commands:");
+      for (const i of t.nextCommands)
+        r.push(`  ${i}`);
+    }
+    process.stderr.write(`${r.join(`
+`)}
+`);
+    return;
+  }
+  const e = t instanceof Error ? t.message : String(t);
+  if (s === "json") {
+    h({
+      ok: !1,
+      error: {
+        code: "unexpected_error",
+        message: e
+      },
+      next_commands: ["rrskill --help"]
+    });
+    return;
+  }
+  process.stderr.write(`${e}
+`);
+}
+async function Es(t) {
+  const s = Et(t), e = Q(t), r = L(t, "--help", "-h");
+  if (s.command === "help" || r)
+    return s.command !== "help" && s.command !== "install" ? (process.stdout.write(`${vs(s.command)}
+`), 0) : (process.stdout.write(`${ys()}
+`), 0);
+  if (s.command === "doctor") {
+    const l = await K({ argv: t, env: process.env }), a = await Pt(
+      l,
+      {
+        fix: L(t, "--fix"),
+        dryRun: L(t, "--dry-run")
+      }
+    );
+    return h(a), a.ok ? 0 : 1;
+  }
+  if (s.command === "version")
+    return h(rs()), 0;
+  const i = await K({ argv: t, env: process.env }), o = ds({ config: i.config, env: i.env }), n = ks(o);
+  if (s.command === "bootstrap") {
+    const l = await tt(i);
+    return h(l), l.verification.ok ? 0 : 1;
+  }
+  if (s.command === "search") {
+    const l = e.slice(1).join(" ").trim();
+    if (!l)
+      throw new w({
+        code: "missing_search_query",
+        message: "Search query is required.",
+        hint: "rrskill search <query>",
+        nextCommands: ["rrskill search react"]
+      });
+    const a = await ts(i, l, { searchSkills: o });
+    return h(a), 0;
+  }
+  if (s.command === "install") {
+    const l = "slug" in s ? s.slug : e[1]?.trim();
+    if (!l)
+      throw new w({
+        code: "missing_skill_slug",
+        message: "Skill slug is required.",
+        hint: "rrskill install <slug>",
+        nextCommands: ["rrskill install web-search"]
+      });
+    const a = await Xt(i, l, { searchSkills: o, downloadSkill: n });
+    return h(a), 0;
+  }
+  if (s.command === "list") {
+    const l = await Yt(i);
+    return h(l), 0;
+  }
+  if (s.command === "upgrade") {
+    const l = await ss(i, { downloadSkill: n });
+    return h(l), 0;
+  }
+  return process.stderr.write(`Command "${s.command}" is not implemented yet.
+`), 1;
+}
+if (ws()) {
+  const t = process.argv.slice(2);
+  Es(t).then((s) => {
+    process.exitCode = s;
+  }).catch((s) => {
+    let e = "text";
+    try {
+      e = Ds(t);
+    } catch (r) {
+      B(r, "text"), process.exitCode = 1;
+      return;
+    }
+    B(s, e), process.exitCode = 1;
+  });
+}
+export {
+  Et as buildCliArgv
+};