yarkr-cli 1.0.2 → 1.0.4

package/README.md

@@ -1,41 +1,41 @@
-# yarkr
+# yarkr-cli
 
 Install skills, agents and MCP toolsets from [Yarkr](https://yarkr.com) into the native layout of every harness you use:
 Claude Code, Codex, opencode, Cursor and more.
 
 ```sh
-npm install -g yarkr-cli                                 # Node 22 or newer; or run any command with `npx yarkr-cli …`
-yarkr add posterus-ltd/code-review-checklist            # a public package, no account needed
-yarkr add posterus-ltd/github --harness codex           # pick the harnesses to write
+npx yarkr-cli add posterus-ltd/code-review-checklist     # a public package, no account needed (Node 22 or newer)
+npx yarkr-cli add posterus-ltd/github --harness codex    # pick the harnesses to write
 ```
 
 ## Sync an ark to your machine
 
-An ark is a curated set of skills, agents and toolsets hosted in the registry. `yarkr sync` writes each one into the
-harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
+An ark is a curated set of skills, agents and toolsets hosted in the registry. `npx yarkr-cli sync` writes each one into
+the harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
 
 ```sh
-yarkr arks                                    # list public arks
-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
+npx yarkr-cli arks                                    # list public arks
+npx yarkr-cli sync acme/starter                       # install one into this folder
+npx yarkr-cli sync acme/starter -g                    # …or into your home directory
+npx yarkr-cli sync acme/starter --harness claude-code # only write Claude Code's files
+npx yarkr-cli ark                                     # what your arks give you, and which version
 ```
 
-Signed in, a bare `yarkr sync` installs every ark you're a member of, plus your personal ark. Run it again to pick up
-whatever an admin added or removed; `yarkr sync --check` exits 1 when you're behind.
+Signed in, a bare `npx yarkr-cli sync` installs every ark you're a member of, plus your personal ark. Run it again to
+pick up whatever an admin added or removed; `npx yarkr-cli sync --check` exits 1 when you're behind.
 
 ## Set up an existing repo
 
-In a project, `yarkr init` creates `yarkr.json` (and `.yarkrrc`), detecting the harnesses already used there.
-`yarkr add` and `yarkr sync` then pin every package in `yarkr.lock`, so teammates and CI get the same releases:
+In a project, `npx yarkr-cli init` creates `yarkr.json` (and `.yarkrrc`), detecting the harnesses already used there.
+`npx yarkr-cli add` and `npx yarkr-cli sync` then pin every package in `yarkr.lock`, so teammates and CI get the same
+releases:
 
 ```sh
 cd my-repo
-yarkr init --ark acme/engineering            # optional: install a team's ark into this project
-yarkr add posterus-ltd/playwright-test-authoring
+npx yarkr-cli init --ark acme/engineering            # optional: install a team's ark into this project
+npx yarkr-cli add posterus-ltd/playwright-test-authoring
 git add yarkr.json yarkr.lock .yarkrrc .claude AGENTS.md && git commit
-yarkr sync --check                           # in CI: exit 1 when anything is out of date
+npx yarkr-cli sync --check                           # in CI: exit 1 when anything is out of date
 ```
 
 To publish from the repo instead, there's nothing to init: Yarkr finds `SKILL.md` folders, `agents/*.md` and
@@ -43,9 +43,9 @@ To publish from the repo instead, there's nothing to init: Yarkr finds `SKILL.md
 SKILL.md) goes in one `yarkr.index.yaml` at the root, and nothing has to move. Lint it before you push:
 
 ```sh
-yarkr lint                                               # what will be published, and what the hub would refuse
-yarkr lint --strict                                      # in CI: fail on warnings too
-yarkr guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent uses to write the index
+npx yarkr-cli lint                                               # what will be published, and what the hub would refuse
+npx yarkr-cli lint --strict                                      # in CI: fail on warnings too
+npx yarkr-cli guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent uses to write the index
 ```
 
 ## Sign in for private packages
@@ -53,12 +53,12 @@ yarkr guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent us
 Public packages and public arks work signed out. Your org's private packages and arks need a token:
 
 ```sh
-yarkr login                  # signs in in the browser; the token goes to your keychain (or ~/.yarkrrc)
-yarkr login --no-browser     # over SSH: open the printed link anywhere, then paste the token
-yarkr whoami                 # check who you're signed in as
+npx yarkr-cli login                  # signs in in the browser; the token goes to your keychain (or ~/.yarkrrc)
+npx yarkr-cli login --no-browser     # over SSH: open the printed link anywhere, then paste the token
+npx yarkr-cli whoami                 # check who you're signed in as
 ```
 
-In CI, store a read-only token as a secret and set `YARKR_TOKEN`. `yarkr` uses the public hub at `https://yarkr.com`
-unless you point it at your own instance with `yarkr login --registry <url>`.
+In CI, store a read-only token as a secret and set `YARKR_TOKEN`. The CLI uses the public hub at `https://yarkr.com`
+unless you point it at your own instance with `npx yarkr-cli login --registry <url>`.
 
 Docs: [docs/cli.md](https://github.com/posterus-ltd/yarkr-public/blob/main/docs/cli.md) · Source: [github.com/posterus-ltd/yarkr-public](https://github.com/posterus-ltd/yarkr-public) · MIT

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 {
@@ -45040,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.2" : "0.0.0-dev";
+var VERSION = true ? "1.0.4" : "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("-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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarkr-cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Install skills, agents and MCP toolsets from Yarkr into Claude Code, Codex, opencode, Cursor and more",
   "license": "MIT",
   "homepage": "https://yarkr.com",
@@ -47,8 +47,8 @@
     "typescript": "~5.9.3",
     "vitest": "^3.2.4",
     "yaml": "^2.8.1",
-    "@yarkr/evals": "0.1.0",
     "@yarkr/core": "0.1.0",
+    "@yarkr/evals": "0.1.0",
     "@yarkr/schema": "0.1.0"
   },
   "scripts": {