@vltpkg/cli-js 1.4.0 → 1.5.0

package/{setup-TFM4GJF7.js → setup-XPAM5U3Z.js}

@@ -11,38 +11,39 @@ import {createRequire as _vlt_createRequire} from "node:module";
 var require = _vlt_createRequire(import.meta.filename);
 import {
   stdout
-} from "./chunk-FZUYGJZU.js";
-import "./chunk-QCSUWACA.js";
-import "./chunk-G2YT2GWF.js";
-import "./chunk-5Y4SYLJ2.js";
+} from "./chunk-WHWPAYZY.js";
+import "./chunk-X6JKMIOU.js";
+import "./chunk-4TSHLSRK.js";
+import {
+  commandUsage
+} from "./chunk-CW56EJIL.js";
 import {
   configWriteTarget,
   registrySelectionFields
-} from "./chunk-5RHABCYI.js";
-import "./chunk-TO23PR7J.js";
+} from "./chunk-XCQCYB6G.js";
+import "./chunk-VR7NRWAD.js";
 import "./chunk-SRWDPPLX.js";
+import "./chunk-IFEZ6BFV.js";
+import "./chunk-C6ZVVEFV.js";
+import "./chunk-4KCU2KZL.js";
 import "./chunk-WGDTG44V.js";
 import {
   normalizeRegistryURL
-} from "./chunk-THSYN5EK.js";
-import {
-  commandUsage
-} from "./chunk-LHPEBLOU.js";
-import "./chunk-I7UMHYZX.js";
-import "./chunk-4KCU2KZL.js";
-import "./chunk-PLG3OYCX.js";
-import "./chunk-5IJTPZXP.js";
-import "./chunk-WF6KLKRN.js";
+} from "./chunk-UZ6ICZE3.js";
+import "./chunk-CMLDLZZ3.js";
+import "./chunk-F7NPYSI2.js";
+import "./chunk-LUVDMEW4.js";
 import "./chunk-HTOTG4TS.js";
 import {
   RegistryClient,
   getKC,
   normalizeRegistryKey
-} from "./chunk-OAJ3PO3Z.js";
-import "./chunk-APMYKJI2.js";
-import "./chunk-SR2VOY5J.js";
-import "./chunk-ZJMJ7MCT.js";
-import "./chunk-U7TEQCBN.js";
+} from "./chunk-35EG6T3J.js";
+import "./chunk-QNHBAGXQ.js";
+import "./chunk-G3FZ2ZJK.js";
+import "./chunk-5KW6AOTT.js";
+import "./chunk-SUU2WETN.js";
+import "./chunk-B6RIGNEO.js";
 import "./chunk-XNLSTHDK.js";
 import "./chunk-6IF3RJND.js";
 import "./chunk-PDWPFR5T.js";
@@ -52,7 +53,7 @@ import {
   defaultRegistries,
   isErrorWithCause,
   isObject
-} from "./chunk-FLH4YC6W.js";
+} from "./chunk-6LZM3I4Q.js";
 import {
   error
 } from "./chunk-WZWDS3W4.js";

package/skills-LR6GXW3X.js

@@ -0,0 +1,413 @@
+var global = globalThis;
+import {Buffer} from "node:buffer";
+import {setTimeout as _vlt_setTimeout,clearTimeout as _vlt_clearTimeout,setImmediate as _vlt_setImmediate,clearImmediate as _vlt_clearImmediate,setInterval as _vlt_setInterval,clearInterval as _vlt_clearInterval} from "node:timers";
+globalThis.setTimeout = _vlt_setTimeout;
+globalThis.clearTimeout = _vlt_clearTimeout;
+globalThis.setImmediate = _vlt_setImmediate;
+globalThis.clearImmediate = _vlt_clearImmediate;
+globalThis.setInterval = _vlt_setInterval;
+globalThis.clearInterval = _vlt_clearInterval;
+import {createRequire as _vlt_createRequire} from "node:module";
+var require = _vlt_createRequire(import.meta.filename);
+import {
+  mermaidOutput
+} from "./chunk-4UH3KMTD.js";
+import {
+  assertQuery,
+  linkSkills,
+  listSkills
+} from "./chunk-2U4PVHP4.js";
+import "./chunk-SMXXFQPI.js";
+import {
+  styleTextStdout
+} from "./chunk-WHWPAYZY.js";
+import "./chunk-X6JKMIOU.js";
+import "./chunk-4TSHLSRK.js";
+import {
+  commandUsage
+} from "./chunk-CW56EJIL.js";
+import {
+  configLabel,
+  savedLine,
+  storedAllowSkills,
+  unmatchedLines,
+  unscannedLines
+} from "./chunk-W4T5CGCO.js";
+import {
+  configWriteTarget
+} from "./chunk-XCQCYB6G.js";
+import "./chunk-VR7NRWAD.js";
+import "./chunk-SRWDPPLX.js";
+import "./chunk-IFEZ6BFV.js";
+import "./chunk-C6ZVVEFV.js";
+import "./chunk-4KCU2KZL.js";
+import "./chunk-WGDTG44V.js";
+import "./chunk-UZ6ICZE3.js";
+import "./chunk-CMLDLZZ3.js";
+import "./chunk-F7NPYSI2.js";
+import "./chunk-LUVDMEW4.js";
+import "./chunk-HTOTG4TS.js";
+import "./chunk-G3FZ2ZJK.js";
+import "./chunk-5KW6AOTT.js";
+import "./chunk-SUU2WETN.js";
+import "./chunk-B6RIGNEO.js";
+import "./chunk-XNLSTHDK.js";
+import "./chunk-6IF3RJND.js";
+import "./chunk-PDWPFR5T.js";
+import "./chunk-Y5PA7DVK.js";
+import {
+  asError
+} from "./chunk-6LZM3I4Q.js";
+import {
+  error
+} from "./chunk-WZWDS3W4.js";
+import "./chunk-PZLD7RTK.js";
+
+// ../../src/cli-sdk/src/commands/skills.ts
+import { styleText } from "node:util";
+
+// ../../src/cli-sdk/src/skills-prompt.ts
+import { createInterface } from "node:readline/promises";
+var interactive = () => process.stdin.isTTY;
+var open = (s) => {
+  const rl = createInterface({
+    input: s.input ?? process.stdin,
+    output: s.output ?? process.stdout,
+    // prefill and line editing
+    terminal: true
+  });
+  rl.on("SIGINT", () => rl.close());
+  let done = false;
+  const closed = new Promise(
+    (r) => rl.once("close", () => {
+      done = true;
+      r(void 0);
+    })
+  );
+  const ask = async (query, prefill) => {
+    if (done) return void 0;
+    const q = rl.question(query).catch(() => void 0);
+    if (prefill) rl.write(prefill);
+    return Promise.race([q, closed]);
+  };
+  return { rl, ask };
+};
+var confirm = async (question, s = {}) => {
+  const { rl, ask } = open(s);
+  try {
+    const a = await ask(question);
+    return a === void 0 ? void 0 : /^y(es)?$/i.test(a.trim());
+  } finally {
+    rl.close();
+  }
+};
+var editQuery = async ({
+  current,
+  prefill,
+  check,
+  ...s
+}) => {
+  const output = s.output ?? process.stdout;
+  if (current !== void 0) {
+    output.write(
+      "\n\u26A0\uFE0F The new allow-skills replaces the current one. Make sure it still\nselects every skill you want: skills it no longer selects are unlinked.\n\n" + styleTextStdout(
+        "yellow",
+        `Current allow-skills: ${current}`
+      ) + "\n"
+    );
+  }
+  const prompt = styleTextStdout("cyan", "New allow-skills: ");
+  const { rl, ask } = open(s);
+  try {
+    let fill = prefill;
+    for (; ; ) {
+      const a = (await ask(prompt, fill))?.trim();
+      if (!a) return void 0;
+      try {
+        await check(a);
+        return a;
+      } catch (e) {
+        output.write(`${asError(e).message}
+`);
+        fill = a;
+      }
+    }
+  } finally {
+    rl.close();
+  }
+};
+
+// ../../src/cli-sdk/src/commands/skills.ts
+var needsRegistry = true;
+var usage = () => commandUsage({
+  command: "skills",
+  usage: ["", "list [<query>]", "link [<query>]"],
+  description: `Manage the agent skills shipped by installed packages.
+
+      A skill is a folder with a \`SKILL.md\` file
+      (https://agentskills.io/specification). Packages ship them as a
+      root \`SKILL.md\`, or at \`<name>/SKILL.md\` in \`skills/\`,
+      \`dist/skills/\` or \`.agents/skills/\`: the first skill of a name
+      wins.
+
+      Skills are linked into the project's agent skill dirs:
+      \`.agents/skills\`, plus \`<folder>/skills\` for each agent folder
+      at the project root (e.g. \`.claude/\`), or the \`skills-dir\`
+      config. When packages ship skills with the same name, one is
+      linked and the others are reported. Only links made by vlt
+      (pointing into \`node_modules/.vlt\`) are ever replaced or
+      removed; anything else in the way is skipped.
+
+      Use --target or a query after the subcommand to select packages
+      using DSS query syntax. End a selector with
+      \`:skill(<name>, \u2026)\` to pick single skills, e.g.
+      \`#skills:skill(find-skills)\`. Use
+      \`vlt install --allow-skills=<query>\` to link skills on install.`,
+  subcommands: {
+    list: {
+      usage: "[<query>]",
+      description: `List the skills of installed packages. The default.
+                      Selects all packages (\`*\`) by default. Applies
+                      \`:skill()\`: preview a query before \`link\` saves
+                      it.`
+    },
+    link: {
+      usage: "[<query>]",
+      description: `Set, save and apply \`allow-skills\`: link what the
+                      query selects and remove vlt links to other skills.
+                      With no query: the stored one, or
+                      \`:not(:malware)\`. Asks before replacing or editing
+                      a stored query (-y skips). Saves to the project
+                      vlt.json, or the user one with --config=user.`
+    }
+  },
+  options: {
+    target: {
+      value: "<query>",
+      description: "Query selector to filter packages using DSS syntax."
+    },
+    yes: {
+      description: "Skip the prompts: replace or keep the stored allow-skills without asking."
+    },
+    config: {
+      value: "user|project",
+      description: "vlt.json to save allow-skills to (default: project)."
+    },
+    view: {
+      value: "[human | json | mermaid]",
+      description: "Output format. mermaid: list only."
+    }
+  }
+});
+var plural = (n, s) => `${n} ${s}${n === 1 ? "" : "s"}`;
+var lines = (header, items) => [header, ...items.map((i) => `  ${i}`)].join("\n");
+var notes = (r) => [
+  ...r.skipped ? [`\u26A0\uFE0F Skipped ${r.skipped.join(", ")}`] : [],
+  ...r.gitignore ? [`\u26A0\uFE0F Could not update ${r.gitignore.join(", ")}`] : [],
+  ...unscannedLines(r)
+];
+var pkgLabel = (s) => {
+  const pkg = s.version ? `${s.name}@${s.version}` : s.name;
+  return s.alias ? `${s.alias} (${pkg})` : pkg;
+};
+var linkedSuffix = (s, dirs) => dirs.length && dirs.every((d) => s.linked.includes(d)) ? " (linked)" : s.linked.length ? ` (linked in ${s.linked.join(", ")})` : "";
+var row = (s, dirs) => `${s.skill} (${pkgLabel(s)})${linkedSuffix(s, dirs)}`;
+var listNotes = (r) => [
+  ...!r.dirs.length && !r.skipped ? ["No agent skill dirs: skills-dir is empty"] : [],
+  ...notes(r)
+];
+var humanList = (r, { colors } = {}) => {
+  const style = (format) => (s) => colors ? styleText(format, s, { validateStream: false }) : s;
+  const yellow = style("yellow");
+  const rows = r.skills.map((s) => {
+    const x = row(s, r.dirs);
+    return s.linked.length ? yellow(x) : x;
+  });
+  const last = rows.length - 1;
+  return [
+    ...rows.length ? [
+      style("reset")(
+        [
+          r.project,
+          ...rows.map(
+            (x, i) => `${i === last ? "\u2514\u2500\u2500" : "\u251C\u2500\u2500"} ${x}`
+          )
+        ].join("\n")
+      )
+    ] : ["No agent skills found in installed packages."],
+    ...listNotes(r)
+  ].join("\n");
+};
+var mermaidList = (r) => {
+  const children = /* @__PURE__ */ new Map();
+  for (const s of r.skills) {
+    const list = children.get(s.id) ?? [];
+    list.push({
+      edge: pkgLabel(s),
+      label: `${s.skill}${linkedSuffix(s, r.dirs)}`
+    });
+    children.set(s.id, list);
+  }
+  const { graph } = r;
+  return [
+    mermaidOutput({
+      edges: [],
+      importers: /* @__PURE__ */ new Set([graph.mainImporter]),
+      nodes: [...graph.nodes.values()].filter(
+        (n) => n === graph.mainImporter || children.has(n.id)
+      ),
+      children
+    }),
+    ...listNotes(r).map((n) => `%% ${n}`)
+  ].join("\n");
+};
+var jsonSkill = ({
+  skill,
+  name,
+  alias,
+  version,
+  id,
+  description,
+  ...rest
+}) => ({
+  name: skill,
+  description,
+  "dependency-name": alias ?? name,
+  "package-id": id,
+  ...rest
+});
+var count = (rows) => new Set(rows.map((r) => `${r.id}\0${r.skill}`)).size;
+var humanLink = (r) => {
+  const out = [];
+  if (r.linked.length) {
+    out.push(
+      lines(
+        `\u{1F517} Linked ${plural(count(r.linked), "agent skill")}:`,
+        r.linked.map((s) => s.mount)
+      )
+    );
+  } else if (r.unchanged.length) {
+    out.push(
+      `${plural(count(r.unchanged), "agent skill")} already linked.`
+    );
+  }
+  if (r.removed.length) {
+    out.push(
+      lines(
+        `\u{1F9F9} Removed ${plural(r.removed.length, "skill link")}:`,
+        r.removed
+      )
+    );
+  }
+  if (r.conflicts.length) {
+    out.push(
+      lines(
+        `\u26A0\uFE0F Skipped ${plural(r.conflicts.length, "skill")}, path in use or taken by another package:`,
+        r.conflicts
+      )
+    );
+  }
+  out.push(...notes(r));
+  return out.join("\n") || "No agent skills found to link.";
+};
+var human = (r, o) => r.action === "list" ? humanList(r, o) : r.action === "unchanged" ? "No changes made." : [
+  humanLink(r),
+  ...unmatchedLines(r.unmatched),
+  ...r.saved ? [savedLine(r.query, r.saved)] : []
+].join("\n");
+var views = {
+  human,
+  json: (r) => {
+    if (r.action !== "list") return r;
+    const { project, graph, ...rest } = r;
+    return { ...rest, skills: rest.skills.map(jsonSkill) };
+  },
+  mermaid: (r) => r.action === "list" ? mermaidList(r) : human(r)
+};
+var defaultQuery = ":not(:malware)";
+var where = (which) => which === "user" ? "in the user vlt.json" : "for this project (vlt.json)";
+var pickQuery = async (conf, given) => {
+  const check = (q) => assertQuery(q, "allow-skills", ["skill"]);
+  const stored = storedAllowSkills(conf);
+  const yes = !!conf.get("yes");
+  const tty = interactive();
+  if (given) {
+    await check(given);
+    if (!stored || stored.query === given || yes) return given;
+    if (!tty) {
+      throw error(
+        `allow-skills is already set (${configLabel(stored.which)}): "${stored.query}"; pass -y to replace it`,
+        { code: "EUSAGE", found: given, wanted: stored.query }
+      );
+    }
+    if (!await confirm(
+      `allow-skills is already set ${where(stored.which)}: "${stored.query}". Replace it? [y/N] `
+    )) {
+      return void 0;
+    }
+    return editQuery({ current: stored.query, prefill: given, check });
+  }
+  if (stored) {
+    if (yes || !tty) return stored.query;
+    const edit = await confirm(
+      `allow-skills is set ${where(stored.which)}: "${stored.query}". Edit it? [y/N] `
+    );
+    if (edit === void 0) return void 0;
+    return edit ? editQuery({
+      current: stored.query,
+      prefill: stored.query,
+      check
+    }) : stored.query;
+  }
+  if (yes || !tty) return defaultQuery;
+  return editQuery({ prefill: defaultQuery, check });
+};
+var command = async (conf) => {
+  const [sub = "list", query] = conf.positionals;
+  const target = conf.get("target") || query;
+  const opts = {
+    ...conf.options,
+    projectRoot: conf.projectRoot,
+    skillsDirs: conf.get("skills-dir")
+  };
+  switch (sub) {
+    case "list":
+    case "ls":
+      return {
+        action: "list",
+        ...await listSkills({ ...opts, target })
+      };
+    case "link": {
+      const query2 = await pickQuery(conf, target);
+      if (query2 === void 0) return { action: "unchanged" };
+      const res = await linkSkills({
+        ...opts,
+        target: query2,
+        apply: true
+      });
+      let saved;
+      if (storedAllowSkills(conf)?.query !== query2) {
+        saved = configWriteTarget(conf, "project");
+        await conf.addConfigToFile(saved, { "allow-skills": query2 });
+      }
+      return {
+        action: "link",
+        query: query2,
+        ...saved && { saved },
+        ...res
+      };
+    }
+    default:
+      throw error("Unknown skills subcommand", {
+        code: "EUSAGE",
+        found: sub,
+        validOptions: ["list", "ls", "link"]
+      });
+  }
+};
+export {
+  command,
+  needsRegistry,
+  usage,
+  views
+};