@rayul/kordis 0.6.5 → 0.6.7

package/dist/index.js

@@ -1204,6 +1204,7 @@ import { join as join2 } from "path";
 var SERVICE = "kordis";
 var plaintextWarningEmitted = false;
 async function loadKeytar() {
+  if (process.env["KORDIS_NO_KEYCHAIN"] === "1") return null;
   try {
     const mod = await import("keytar");
     return mod.default ?? mod;
@@ -1583,29 +1584,53 @@ async function useClient() {
           baseUrl: cfg.apiUrl,
           userAgent: `kordis-cli/${VERSION} node/${process.version}`
         });
+        const debug = process.env["KORDIS_DEBUG"] === "1";
+        let pollResult = null;
         try {
-          const tokens = await bootstrapApi.pollDeviceFlow(pending.device_code);
-          const meClient = new KordisClient({
-            baseUrl: cfg.apiUrl,
-            userAgent: `kordis-cli/${VERSION} node/${process.version}`,
-            getAccessToken: () => tokens.access_token
-          });
-          const me = await meClient.me();
-          username = me.username;
-          currentTokens = {
-            access_token: tokens.access_token,
-            refresh_token: tokens.refresh_token,
-            session_id: tokens.session_id,
-            expires_at_epoch: Math.floor(Date.now() / 1e3) + tokens.expires_in
-          };
-          await keychain.save(username, currentTokens);
-          cfg = { ...cfg, username, sessionId: tokens.session_id };
-          await saveCliConfig(cfg);
-          await clearPending();
+          pollResult = await bootstrapApi.pollDeviceFlow(pending.device_code);
         } catch (err) {
           const code = err.code;
-          if (code && code !== "authorization_pending") {
+          if (code === "authorization_pending") {
+            if (debug) process.stderr.write("[kordis] auto-finalize: authorization_pending (keeping pending)\n");
+          } else {
             await clearPending();
+            if (debug) {
+              const msg = err instanceof Error ? err.message : String(err);
+              process.stderr.write(`[kordis] auto-finalize: poll failed (code=${code ?? "none"}): ${msg}
+`);
+            }
+          }
+        }
+        if (pollResult) {
+          try {
+            const meClient = new KordisClient({
+              baseUrl: cfg.apiUrl,
+              userAgent: `kordis-cli/${VERSION} node/${process.version}`,
+              getAccessToken: () => pollResult.access_token
+            });
+            const me = await meClient.me();
+            username = me.username;
+            currentTokens = {
+              access_token: pollResult.access_token,
+              refresh_token: pollResult.refresh_token,
+              session_id: pollResult.session_id,
+              expires_at_epoch: Math.floor(Date.now() / 1e3) + pollResult.expires_in
+            };
+            await keychain.save(username, currentTokens);
+            cfg = { ...cfg, username, sessionId: pollResult.session_id };
+            await saveCliConfig(cfg);
+            await clearPending();
+            if (debug) process.stderr.write(`[kordis] auto-finalize: persisted tokens for ${username}
+`);
+          } catch (err) {
+            await clearPending();
+            currentTokens = null;
+            username = null;
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(
+              `[kordis] auto-finalize: server issued tokens but local persistence failed (${msg}). Run \`kordis login --emit-only\` again to retry.
+`
+            );
           }
         }
       }
@@ -1894,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) {
@@ -1919,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
       });
@@ -3277,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();
@@ -3808,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) => {
@@ -3838,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";
@@ -4440,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.5",
+  "version": "0.6.7",
   "private": false,
   "description": "Command-line client for the Kordis registry — discover, install, and publish agentic-coding packages.",
   "license": "MIT",