@rayul/kordis 0.6.6 → 0.6.7

package/dist/index.js

@@ -1919,14 +1919,47 @@ var SORT_MODES = [
   "rising"
 ];
 var TIME_WINDOWS = ["24h", "7d", "30d"];
+var TOOL_SLUGS = [
+  "claude-code",
+  "codex",
+  "cursor",
+  "antigravity",
+  "windsurf",
+  "continue",
+  "copilot",
+  "opencode",
+  "gemini-cli"
+];
+var TOOL_ALIASES = {
+  claude: "claude-code",
+  gemini: "gemini-cli"
+};
 function searchCommand() {
-  return new Command3("search").description("search the Kordis registry").argument("[query...]", "keywords to match against title/description").option("--type <type>", "filter by harness type (skill|mcp-server|project-rules|custom-agent|hook)").option("--tool <tool>", "filter by compatible tool (claude-code|codex|cursor|...)").option("--tier <tier>", "filter by portability tier (A|B|C|D)").option("--author <username>", "filter to a single author (server returns exact total when set)").option("--sort <mode>", `sort: ${SORT_MODES.join("|")}`).option("--trending", "list trending packages (overrides --sort)", false).option("--rising", "list rising packages by 7d acceleration (overrides --sort)", false).option("--window <w>", `time window for --trending: ${TIME_WINDOWS.join("|")}`, "24h").option("--limit <n>", "max results", (v) => parseInt(v, 10), 20).action(async (query, opts) => {
+  return new Command3("search").description("search the Kordis registry").argument("[query...]", "keywords to match against title/description").option("--type <type>", "filter by harness type (skill|mcp-server|project-rules|custom-agent|hook)").option(
+    "--tool <tool>",
+    `filter by compatible tool \u2014 one of: ${TOOL_SLUGS.join("|")} (aliases: ${Object.entries(
+      TOOL_ALIASES
+    ).map(([alias, canonical]) => `${alias}\u2192${canonical}`).join(", ")})`
+  ).option("--tier <tier>", "filter by portability tier (A|B|C|D)").option("--author <username>", "filter to a single author (server returns exact total when set)").option(
+    "--cursor <token>",
+    "pagination cursor \u2014 pass the next_cursor field from a prior search response to fetch the next page"
+  ).option("--sort <mode>", `sort: ${SORT_MODES.join("|")}`).option("--trending", "list trending packages (overrides --sort)", false).option("--rising", "list rising packages by 7d acceleration (overrides --sort)", false).option("--window <w>", `time window for --trending: ${TIME_WINDOWS.join("|")}`, "24h").option("--limit <n>", "max results", (v) => parseInt(v, 10), 20).action(async (query, opts) => {
     if (opts.sort && !SORT_MODES.includes(opts.sort)) {
       throw new Error(`--sort must be one of ${SORT_MODES.join(", ")}`);
     }
     if (opts.window && !TIME_WINDOWS.includes(opts.window)) {
       throw new Error(`--window must be one of ${TIME_WINDOWS.join(", ")}`);
     }
+    let resolvedTool;
+    if (opts.tool) {
+      const candidate = TOOL_ALIASES[opts.tool] ?? opts.tool;
+      if (!TOOL_SLUGS.includes(candidate)) {
+        throw new Error(
+          `--tool must be one of ${TOOL_SLUGS.join(", ")} (you passed "${opts.tool}")`
+        );
+      }
+      resolvedTool = candidate;
+    }
     const bundle = await useClient();
     let res;
     if (opts.rising) {
@@ -1944,9 +1977,10 @@ function searchCommand() {
       res = await bundle.api.search({
         q: query.join(" ") || void 0,
         type: opts.type ? [opts.type] : void 0,
-        tool: opts.tool ? [opts.tool] : void 0,
+        tool: resolvedTool ? [resolvedTool] : void 0,
         tier: opts.tier,
         ...opts.author ? { author: opts.author } : {},
+        ...opts.cursor ? { cursor: opts.cursor } : {},
         sort: opts.sort ?? "relevance",
         limit: opts.limit
       });
@@ -3302,18 +3336,23 @@ function getTranslator(type, format) {
 import { homedir as homedir6 } from "os";
 import { join as join8 } from "path";
 import { readFile as readFile7, writeFile as writeFile5, mkdir as mkdir5 } from "fs/promises";
-var LOCKFILE_PATH = join8(homedir6(), ".kordis", "installed.json");
+function kordisHome2() {
+  return process.env["KORDIS_HOME"] ?? join8(homedir6(), ".kordis");
+}
+function lockfilePath() {
+  return join8(kordisHome2(), "installed.json");
+}
 async function readLockfile() {
   try {
-    const raw = await readFile7(LOCKFILE_PATH, "utf8");
+    const raw = await readFile7(lockfilePath(), "utf8");
     return JSON.parse(raw);
   } catch {
     return { packages: {} };
   }
 }
 async function writeLockfile(lf) {
-  await mkdir5(join8(homedir6(), ".kordis"), { recursive: true });
-  await writeFile5(LOCKFILE_PATH, JSON.stringify(lf, null, 2) + "\n", "utf8");
+  await mkdir5(kordisHome2(), { recursive: true });
+  await writeFile5(lockfilePath(), JSON.stringify(lf, null, 2) + "\n", "utf8");
 }
 async function recordInstalled(fullSlug, entry) {
   const lf = await readLockfile();
@@ -3833,6 +3872,8 @@ var KINDS = [
   "praise",
   "question"
 ];
+var LIST_SORTS = ["recent", "old"];
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function commentCommand() {
   return new Command10("comment").description("post a comment on a package").argument("<full_slug>", "package identifier {username}/{slug}").requiredOption("--body <text>", "comment body (1\u201310000 chars)").option("--kind <kind>", `top-level kind: ${KINDS.join("|")}`, "comment").option("--title <text>", "top-level post title (1\u2013140 chars)").action(
     async (rawSlug, opts) => {
@@ -3863,11 +3904,103 @@ function commentCommand() {
           if (res.permalink) {
             printHuman(c.gray(`  view: ${res.permalink}`));
           }
+          printHuman(c.gray(`  delete: kordis uncomment ${res.id}`));
         }
       });
     }
   );
 }
+function commentsCommand() {
+  return new Command10("comments").description("list comments on a package").argument("<full_slug>", "package identifier {username}/{slug}").option("--limit <n>", "max top-level comments (1\u201350)", (v) => parseInt(v, 10), 20).option("--cursor <token>", "pagination cursor returned by a prior call as next_cursor").option(
+    "--kind <kind>",
+    `filter top-level posts by kind: ${KINDS.join("|")}`
+  ).option("--sort <mode>", `sort: ${LIST_SORTS.join("|")} (default: recent)`).action(
+    async (rawSlug, opts) => {
+      const [username, slug] = rawSlug.split("/");
+      if (!username || !slug) {
+        throw new Error('full_slug must be "{username}/{slug}"');
+      }
+      if (opts.kind && !KINDS.includes(opts.kind)) {
+        throw new Error(`--kind must be one of ${KINDS.join(", ")}`);
+      }
+      if (opts.sort && !LIST_SORTS.includes(opts.sort)) {
+        throw new Error(`--sort must be one of ${LIST_SORTS.join(", ")}`);
+      }
+      const bundle = await useClient();
+      const res = await bundle.api.listComments(username, slug, {
+        limit: opts.limit,
+        ...opts.cursor ? { cursor: opts.cursor } : {},
+        ...opts.kind ? { kind: opts.kind } : {},
+        ...opts.sort ? { sort: opts.sort } : {}
+      });
+      printDual({
+        json: res,
+        human: () => {
+          if (res.results.length === 0) {
+            printHuman(c.yellow("(no comments)"));
+            printHuman(
+              c.gray("  \u2192 be the first: kordis comment " + rawSlug + ' --body "..."')
+            );
+            return;
+          }
+          printHuman(
+            c.gray(
+              `Showing ${res.results.length} of ${res.total} top-level comment${res.total === 1 ? "" : "s"}`
+            )
+          );
+          printHuman("");
+          for (const node of res.results) {
+            renderCommentNode(node, 0);
+          }
+          if (res.next_cursor) {
+            printHuman(
+              c.gray(
+                `(more available \u2014 kordis comments ${rawSlug} --cursor ${res.next_cursor})`
+              )
+            );
+          }
+        }
+      });
+    }
+  );
+}
+function renderCommentNode(node, depth) {
+  const indent = "  ".repeat(depth);
+  const tag = node.kind === "comment" ? "" : c.cyan(`[${node.kind}]`) + " ";
+  const title = node.title ? c.bold(node.title) + " " : "";
+  const author = `${node.author.username}${node.author.display_name ? ` (${node.author.display_name})` : ""}`;
+  printHuman(`${indent}${tag}${title}${c.gray(`\u2014 ${author}`)}`);
+  for (const line of node.body.split("\n")) {
+    printHuman(`${indent}  ${line}`);
+  }
+  const trail = [`id: ${node.id}`];
+  if (node.reply_count > 0) trail.push(`${node.reply_count} repl${node.reply_count === 1 ? "y" : "ies"}`);
+  if (node.is_edited) trail.push("edited");
+  if (node.permalink) trail.push(`view: ${node.permalink}`);
+  printHuman(c.gray(`${indent}  ${trail.join(" \xB7 ")}`));
+  printHuman("");
+  for (const child of node.replies) {
+    renderCommentNode(child, depth + 1);
+  }
+}
+function uncommentCommand() {
+  return new Command10("uncomment").description("delete one of your comments by id").argument("<id>", "comment id (uuid v4)").action(async (id) => {
+    if (!UUID_RE.test(id)) {
+      throw new Error(
+        "comment id must be a uuid v4 \u2014 get it from `kordis comments <slug>` or the `id` field on `kordis comment`'s response"
+      );
+    }
+    const bundle = await useClient();
+    requireAuth(bundle);
+    await bundle.authedRequest((api) => api.deleteComment(id));
+    printDual({
+      json: { status: "deleted", id },
+      human: () => {
+        printHuman(c.gray(`\u2717 deleted comment ${id}`));
+      }
+    });
+  });
+}
 
 // src/commands/star.ts
 import { Command as Command11 } from "commander";
@@ -4465,6 +4598,8 @@ function buildProgram() {
   program.addCommand(readCommand());
   program.addCommand(infoCommand());
   program.addCommand(commentCommand());
+  program.addCommand(commentsCommand());
+  program.addCommand(uncommentCommand());
   program.addCommand(starCommand());
   program.addCommand(unstarCommand());
   program.addCommand(deleteCommand());

package/package.json

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