@rayul/kordis 0.1.15 → 0.1.17

package/dist/index.js

@@ -984,7 +984,7 @@ var init_src2 = __esm({
 
 // src/index.ts
 init_src2();
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
@@ -2454,13 +2454,16 @@ async function recordInstalled(fullSlug, entry) {
 }
 
 // src/commands/pull.ts
-async function doPullInstall(fullSlug, tool, installRoot) {
+async function doPullInstall(fullSlug, tool, installRoot, version) {
   const [username, slug] = fullSlug.split("/");
   if (!username || !slug) throw new Error('full_slug must be "{username}/{slug}"');
   const bundle = await useClient();
   const detail = await bundle.api.getPackage(username, slug);
   await bundle.api.pull(username, slug);
-  const contentRes = await bundle.api.getContent(username, slug, { format: "canonical" });
+  const contentRes = await bundle.api.getContent(username, slug, {
+    format: "canonical",
+    ...version ? { version } : {}
+  });
   const parsed = validatePackageSource(contentRes.content);
   if (!parsed.ok || !parsed.type || !parsed.frontmatter) {
     throw new Error("package stored content is not currently valid");
@@ -2507,20 +2510,25 @@ async function doPullInstall(fullSlug, tool, installRoot) {
       throw err;
     }
   }
+  const installedVersion = contentRes.version;
   await recordInstalled(fullSlug, {
-    version: detail.current_version,
+    version: installedVersion,
     tool,
     target: installRoot,
     installedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
-  return { version: detail.current_version, tool, installRoot, written, notes };
+  return { version: installedVersion, tool, installRoot, written, notes };
 }
 function pullCommand() {
-  return new Command5("pull").description("install a package into the current project").argument("<full_slug>", "package identifier {username}/{slug}").option("--tool <name>", "target tool format (default: auto-detect)").option("--target <path>", "install into a subdirectory (default: cwd)").option("--with-recommends", "also install recommended dependencies", false).action(
-    async (fullSlug, opts) => {
+  return new Command5("pull").description("install a package into the current project").argument("<full_slug>", "package identifier {username}/{slug} or {username}/{slug}@{version}").option("--tool <name>", "target tool format (default: auto-detect)").option("--target <path>", "install into a subdirectory (default: cwd)").option("--with-recommends", "also install recommended dependencies", false).action(
+    async (fullSlugArg, opts) => {
+      const atIdx = fullSlugArg.lastIndexOf("@");
+      const hasPinnedVersion = atIdx > fullSlugArg.indexOf("/");
+      const fullSlug = hasPinnedVersion ? fullSlugArg.slice(0, atIdx) : fullSlugArg;
+      const pinnedVersion = hasPinnedVersion ? fullSlugArg.slice(atIdx + 1) : void 0;
       const [username, slug] = fullSlug.split("/");
       if (!username || !slug) {
-        throw new Error('full_slug must be "{username}/{slug}"');
+        throw new Error('full_slug must be "{username}/{slug}" or "{username}/{slug}@{version}"');
       }
       const userCwd = process.env["INIT_CWD"] ?? process.cwd();
       const installRoot = opts.target ?? userCwd;
@@ -2530,8 +2538,9 @@ function pullCommand() {
           "Cannot detect target tool from the current directory.\n  Pass --tool <name> explicitly. Valid: claude-code, codex, cursor,\n  continue, windsurf, antigravity, copilot.\n  Or run `kordis pull` inside a project that already has one of:\n  .claude/, .codex/, .cursor/, AGENTS.md, CLAUDE.md, .cursorrules,\n  .continue/, .windsurf/, .antigravity/, .github/copilot-instructions.md"
         );
       }
-      const spin = spinner(`Pulling ${fullSlug}`);
-      const result = await doPullInstall(fullSlug, detected, installRoot);
+      const spinLabel = pinnedVersion ? `Pulling ${fullSlug}@${pinnedVersion}` : `Pulling ${fullSlug}`;
+      const spin = spinner(spinLabel);
+      const result = await doPullInstall(fullSlug, detected, installRoot, pinnedVersion);
       spin.succeed();
       printDual({
         json: {
@@ -3313,9 +3322,77 @@ function updateCommand() {
   });
 }
 
+// src/commands/diff.ts
+import { Command as Command17 } from "commander";
+function diffCommand() {
+  return new Command17("diff").description("show changes between two versions of a package").argument("<full_slug>", "package identifier: {username}/{slug}, or {username}/{slug}@{from}..{to}").argument("[from]", "older version (omit to use second-latest)").argument("[to]", "newer version (omit to use latest)").action(async (fullSlugArg, fromArg, toArg) => {
+    let fullSlug = fullSlugArg;
+    let from = fromArg;
+    let to = toArg;
+    const rangeMatch = /^(.+)@(.+?)\.\.(.+)$/.exec(fullSlugArg);
+    if (rangeMatch) {
+      fullSlug = rangeMatch[1];
+      from = rangeMatch[2];
+      to = rangeMatch[3];
+    }
+    const [username, slug] = fullSlug.split("/");
+    if (!username || !slug) {
+      throw new Error('full_slug must be "{username}/{slug}"');
+    }
+    const bundle = await useClient();
+    if (!from || !to) {
+      const spin2 = spinner(`Fetching versions for ${fullSlug}`);
+      const versionsRes = await bundle.api.versions(username, slug);
+      spin2.stop();
+      const passed = versionsRes.versions.filter((v) => v.review_status === "passed");
+      if (passed.length < 2) {
+        throw new Error(
+          `Need at least 2 published versions to auto-diff. Pass explicit versions: kordis diff ${fullSlug} <from> <to>`
+        );
+      }
+      to = to ?? passed[0].version;
+      from = from ?? passed[1].version;
+    }
+    const spin = spinner(`Diffing ${fullSlug} ${from}..${to}`);
+    const diff = await bundle.api.diff(username, slug, from, to);
+    spin.succeed();
+    printDual({
+      json: diff,
+      human: () => {
+        printHuman(
+          `${c.bold(diff.full_slug)}  ${c.gray(diff.from)} ${c.dim("\u2192")} ${c.green(diff.to)}`
+        );
+        printHuman(
+          c.gray(
+            `  +${diff.stats.additions} \u2212${diff.stats.deletions}  (${diff.stats.files_changed} file${diff.stats.files_changed !== 1 ? "s" : ""} changed)`
+          )
+        );
+        printHuman("");
+        if (!diff.unified_diff) {
+          printHuman(c.dim("(no content changes between these versions)"));
+          return;
+        }
+        for (const line of diff.unified_diff.split("\n")) {
+          if (line.startsWith("+++") || line.startsWith("---")) {
+            printHuman(c.bold(line));
+          } else if (line.startsWith("+")) {
+            printHuman(c.green(line));
+          } else if (line.startsWith("-")) {
+            printHuman(c.red(line));
+          } else if (line.startsWith("@@")) {
+            printHuman(c.cyan(line));
+          } else {
+            printHuman(c.gray(line));
+          }
+        }
+      }
+    });
+  });
+}
+
 // src/index.ts
 function buildProgram() {
-  const program = new Command17("kordis").version(VERSION).description("Kordis \u2014 registry for agentic-coding packages").option("--json", "emit JSON output to stdout (default: human)", false).hook("preAction", (thisCommand) => {
+  const program = new Command18("kordis").version(VERSION).description("Kordis \u2014 registry for agentic-coding packages").option("--json", "emit JSON output to stdout (default: human)", false).hook("preAction", (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
     if (opts.json) setJsonMode(true);
   });
@@ -3335,6 +3412,7 @@ function buildProgram() {
   program.addCommand(versionsCommand());
   program.addCommand(outdatedCommand());
   program.addCommand(updateCommand());
+  program.addCommand(diffCommand());
   program.addCommand(setupCommand());
   return program;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rayul/kordis",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "private": false,
   "description": "Command-line client for the Kordis registry — discover, install, and publish agentic-coding packages.",
   "license": "MIT",