yarkr-cli 1.0.1 → 1.0.3

package/README.md

@@ -16,7 +16,8 @@ harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and s
 
 ```sh
 yarkr arks                                    # list public arks
-yarkr sync acme/starter                       # install one into your home directory
+yarkr sync acme/starter                       # install one into this folder
+yarkr sync acme/starter -g                    # …or into your home directory
 yarkr sync acme/starter --harness claude-code # only write Claude Code's files
 yarkr ark                                     # what your arks give you, and which version
 ```

package/dist/yarkr.js

@@ -39519,6 +39519,25 @@ var ConnectRepoBody = external_exports.object({
   classification: Classification.optional(),
   root_path: external_exports.string().max(200).optional()
 });
+var AddRepoBody = external_exports.object({
+  /** `owner/repo` or a github.com URL. */
+  repo: external_exports.string().trim().min(3).max(300),
+  /** Only index below this folder, e.g. `skills` to skip a repo's templates and examples. */
+  root_path: external_exports.string().max(200).optional()
+});
+var BulkAddReposBody = external_exports.object({
+  /** `owner/repo` or github.com URLs; duplicates are added once. */
+  repos: external_exports.array(external_exports.string().trim().min(1).max(300)).min(1).max(100),
+  /** Applied to every repo added. */
+  root_path: external_exports.string().max(200).optional()
+});
+var BanRepoBody = external_exports.object({ reason: external_exports.string().trim().min(1).max(500) });
+var IndexJobQuery = external_exports.object({
+  status: external_exports.enum(["active", "queued", "running", "error", "done", "all"]).default("active"),
+  /** Part of the repo's `owner/repo`, any case. */
+  repo: external_exports.string().trim().max(200).optional(),
+  limit: external_exports.coerce.number().int().min(1).max(500).default(200)
+});
 var AuditQuery = external_exports.object({
   package: external_exports.string().optional(),
   /** `me`: only what you did yourself. Anyone may read their own events. */
@@ -41349,13 +41368,23 @@ async function detectAssets(input2) {
   const byName = /* @__PURE__ */ new Map();
   for (const a of found.sort((x, y) => x.path.localeCompare(y.path))) {
     const prev = byName.get(a.name);
-    if (prev)
-      problems.push({ path: a.path, message: `Another asset is already named "${a.name}" (${prev.path}). Rename one of them in its frontmatter.` });
-    else
+    if (!prev)
       byName.set(a.name, a);
+    else if (!await sameFiles(prev, a, input2.read))
+      problems.push({ path: a.path, message: `Another asset is already named "${a.name}" (${prev.path}) and its files differ. Rename one of them in its frontmatter, or make the copies identical.` });
   }
   return { assets: [...byName.values()], problems };
 }
+async function sameFiles(a, b, read) {
+  if (a.kind !== b.kind || a.files.size !== b.files.size)
+    return false;
+  for (const [pkgPath, repoPath] of a.files) {
+    const other = b.files.get(pkgPath);
+    if (other === void 0 || await read(repoPath) !== await read(other))
+      return false;
+  }
+  return true;
+}
 function toolsetServers2(text, path18, problems) {
   let doc;
   try {
@@ -41811,18 +41840,20 @@ async function context(flags = {}) {
   const cwd = process.cwd();
   const conn = await resolveConnection({ dir: cwd, registry: flags.registry });
   const api = new Api(conn);
-  const project = flags.user ? null : await loadProjectConfig(cwd, { required: false });
-  if (project) return { dir: cwd, config: project, conn, api, lock: await loadLock(cwd), userMode: false };
-  const dir = userStateDir();
+  const userMode = !!(flags.global || flags.user);
+  const dir = userMode ? userStateDir() : cwd;
   let config2 = await loadProjectConfig(dir, { required: false });
   if (!config2) {
-    const detected2 = detectHarnesses2(os5.homedir());
-    config2 = { channel: "stable", scope: "user", harnesses: detected2.length ? detected2 : ["claude-code"], packages: {}, arks: "auto" };
-    await mkdir3(dir, { recursive: true });
-    await saveProjectConfig(dir, config2);
-    ui.info(`No ${CONFIG_FILE} here, so yarkr installs your arks into your home directory (${config2.harnesses.join(", ")}). Settings: ${path5.join(dir, CONFIG_FILE)}.`);
+    const detected2 = detectHarnesses2(userMode ? os5.homedir() : cwd);
+    config2 = { channel: "stable", scope: userMode ? "user" : "project", harnesses: detected2.length ? detected2 : ["claude-code"], packages: {}, arks: "auto" };
+    if (!flags.dryRun && !flags.check && !flags.readOnly) {
+      await mkdir3(dir, { recursive: true });
+      await saveProjectConfig(dir, config2);
+      if (userMode) ui.info(`Installing your arks into your home directory (${config2.harnesses.join(", ")}). Settings: ${path5.join(dir, CONFIG_FILE)}.`);
+      else ui.info(`Created ${CONFIG_FILE} here for ${config2.harnesses.join(", ")}. Use -g to install into your home directory instead.`);
+    }
   }
-  return { dir, config: config2, conn, api, lock: await loadLock(dir), userMode: true };
+  return { dir, config: config2, conn, api, lock: await loadLock(dir), userMode };
 }
 async function sync(flags, update2, arkRefs = []) {
   const { dir, config: config2, conn, api, lock, userMode } = await context(flags);
@@ -42499,7 +42530,7 @@ async function mcpRemove(scopes, flags) {
   if (!flags.noSync) await sync(flags);
 }
 async function mcpList(flags) {
-  const { config: config2, conn } = await context(flags);
+  const { config: config2, conn } = await context({ ...flags, readOnly: true });
   const rows = (config2.mcp ?? []).map((m) => connectionFor(conn.server, m));
   if (flags.json) return console.log(JSON.stringify(rows, null, 2));
   if (!rows.length) {
@@ -45038,14 +45069,39 @@ async function repoLint(dir, opts) {
   return { assets, findings };
 }
 
+// src/banner.ts
+var WEBSITE = "https://yarkr.com";
+var WORDMARK = [
+  "\u2588\u2588    \u2588\u2588  \u2588\u2588\u2588\u2588\u2588  \u2588\u2588\u2588\u2588\u2588\u2588  \u2588\u2588   \u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588",
+  " \u2588\u2588  \u2588\u2588  \u2588\u2588   \u2588\u2588 \u2588\u2588   \u2588\u2588 \u2588\u2588  \u2588\u2588  \u2588\u2588   \u2588\u2588",
+  "  \u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588  \u2588\u2588\u2588\u2588\u2588   \u2588\u2588\u2588\u2588\u2588\u2588",
+  "   \u2588\u2588    \u2588\u2588   \u2588\u2588 \u2588\u2588   \u2588\u2588 \u2588\u2588  \u2588\u2588  \u2588\u2588   \u2588\u2588",
+  "   \u2588\u2588    \u2588\u2588   \u2588\u2588 \u2588\u2588   \u2588\u2588 \u2588\u2588   \u2588\u2588 \u2588\u2588   \u2588\u2588"
+];
+var rgb = (r, g, b) => (s) => kleur_default.enabled ? `\x1B[38;2;${r};${g};${b}m${s}\x1B[39m` : s;
+var petrol = rgb(74, 163, 191);
+function link(url2, text = url2) {
+  return kleur_default.enabled ? `\x1B]8;;${url2}\x1B\\${text}\x1B]8;;\x1B\\` : text;
+}
+function banner(version2) {
+  return [
+    "",
+    ...WORDMARK.map((l) => `  ${petrol(l)}`),
+    "",
+    `  ${kleur_default.bold("yarkr")} ${kleur_default.dim(`v${version2}`)}  ${kleur_default.dim("\xB7")}  skills, agents and MCP toolsets for every harness`,
+    `  ${petrol("\u2192")} ${kleur_default.underline(petrol(link(WEBSITE)))}`,
+    ""
+  ].join("\n");
+}
+
 // src/index.ts
-var VERSION = true ? "1.0.1" : "0.0.0-dev";
+var VERSION = true ? "1.0.3" : "0.0.0-dev";
 var act = (fn) => async (...a) => {
   await fn(...a);
 };
-var syncFlags = (c) => c.option("--harness <ids...>", `limit to some harnesses (${HARNESS_IDS.join(", ")})`).option("--dry-run", "show what would change; write nothing").option("--check", "exit 1 if anything is out of date (for CI)").option("--force", "overwrite files edited locally").option("--require-signatures", "refuse unsigned releases").option("--user", "use your arks and home directory even inside a project").option("--registry <url>", "registry to use (default: from .yarkrrc)");
+var syncFlags = (c) => c.option("--harness <ids...>", `limit to some harnesses (${HARNESS_IDS.join(", ")})`).option("--dry-run", "show what would change; write nothing").option("--check", "exit 1 if anything is out of date (for CI)").option("--force", "overwrite files edited locally").option("--require-signatures", "refuse unsigned releases").option("-g, --global", "install into your home directory instead of this folder").addOption(new Option("--user").hideHelp()).option("--registry <url>", "registry to use (default: from .yarkrrc)");
 function buildProgram() {
-  const program2 = new Command().name("yarkr").description("Yarkr: install your org's skills, agents and MCP configs into every harness.").version(VERSION).option("-q, --quiet", "only print warnings and errors").hook("preAction", (cmd) => {
+  const program2 = new Command().name("yarkr").description("Yarkr: install your org's skills, agents and MCP configs into every harness.").version(VERSION).addHelpText("before", () => banner(VERSION)).option("-q, --quiet", "only print warnings and errors").hook("preAction", (cmd) => {
     ui.quiet = !!cmd.opts().quiet;
   });
   program2.command("login").description("sign in in the browser and keep a token in your keychain (or ~/.yarkrrc)").option("--registry <url>").option("--token <token>", "use this token instead of the browser (or pipe it on stdin)").option("--no-browser", "print a link to open on any device, then paste the token it shows").action(act(login));
@@ -45059,11 +45115,11 @@ function buildProgram() {
   program2.command("arks").description("list public arks: curated sets anyone can sync or connect over MCP").option("--json").action(act(publicArks));
   program2.command("lint").argument("[dir]", "a repo checkout", ".").description("check a repo is set up as a Yarkr source: what it publishes, problems the hub would refuse, and index typos or weak descriptions").option("--namespace <ns>", "namespace to show names in (default: the git owner)").option("--strict", "exit 1 on warnings too").option("--json").action(act(repoLint));
   program2.command("guide").argument("[name]", "a guide, e.g. create-ark; omit to list them").description("print instructions for your agent, e.g. how to build an ark for a topic").option("-o, --out <path>", "write to a file, or <dir>/SKILL.md for a directory (e.g. ~/.claude/skills/create-ark/)").option("--topic <topic>", "create-ark: what the ark is about").addOption(new Option("--type <type>", "create-ark: the kind of package it holds").choices(["skill", "agent", "mcp"])).action(act(guide));
-  syncFlags(program2.command("add").argument("<packages...>", "namespace/name[@range]").description("add packages to yarkr.json (outside a project: to your personal ark, or your user config when signed out) and sync").option("--no-sync", "only edit yarkr.json")).action(act((pkgs, o) => add(pkgs, { ...o, noSync: o.sync === false })));
+  syncFlags(program2.command("add").argument("<packages...>", "namespace/name[@range]").description("add packages to yarkr.json (with -g: to your personal ark, or your user config when signed out) and sync").option("--no-sync", "only edit yarkr.json")).action(act((pkgs, o) => add(pkgs, { ...o, noSync: o.sync === false })));
   syncFlags(program2.command("remove").argument("<packages...>", "packages, or arks listed in yarkr.json").description("remove packages or arks (or opt out of optional ark items) and delete their files").option("--no-sync", "only edit yarkr.json")).action(act((pkgs, o) => remove(pkgs, { ...o, noSync: o.sync === false })));
   syncFlags(program2.command("update").argument("[packages...]").description("move packages to the newest release their range allows")).action(act((pkgs, o) => update(pkgs, o)));
   syncFlags(
-    program2.command("sync").argument("[arks...]", "arks to add first: <org>/<ark>, yours or another org's public ark (which needs no sign-in)").description("install locked releases into each harness's native layout (outside a project: your arks, into your home directory)")
+    program2.command("sync").argument("[arks...]", "arks to add first: <org>/<ark>, yours or another org's public ark (which needs no sign-in)").description("install locked releases into each harness's native layout in this folder (with -g: your home directory)")
   ).action(act((refs, o) => sync(o, void 0, refs)));
   program2.command("yank").argument("<release>", "namespace/name@version").description("yank a release (org admins): ranges and stable skip it, exact pins still install it").option("--reason <text>", "why, shown to everyone who installed it").option("--undo", "un-yank it").action(act(yank));
   program2.command("diff").argument("[package]").description("show local edits to synced files").option("--name-only").action(act(diff));
@@ -45086,7 +45142,7 @@ function buildProgram() {
     act((scopes, o) => mcpAdd(scopes, { ...o, noSync: o.sync === false }))
   );
   mcpFlags(mcp.command("remove").argument("<scopes...>").description("remove MCP connections from every harness")).action(act((scopes, o) => mcpRemove(scopes, { ...o, noSync: o.sync === false })));
-  mcp.command("list").description("show configured MCP connections").option("--user", "your user config even inside a project").option("--json").action(act((o) => mcpList(o)));
+  mcp.command("list").description("show configured MCP connections").option("-g, --global", "your user config instead of this folder's").addOption(new Option("--user").hideHelp()).option("--json").action(act((o) => mcpList(o)));
   program2.command("mcp-config").argument("<harness>", HARNESS_IDS.join(" | ")).description("print the config that connects a harness to Yarkr's MCP server").option("--token-env <name>", "environment variable holding the token", "YARKR_TOKEN").option("--registry <url>").action(act(mcpConfig));
   return program2;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarkr-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Install skills, agents and MCP toolsets from Yarkr into Claude Code, Codex, opencode, Cursor and more",
   "license": "MIT",
   "homepage": "https://yarkr.com",