github-search-cli 9.6.0 → 9.7.0

package/dist/cli.js

@@ -540,6 +540,17 @@ var TRENDING_LANGUAGES = /* @__PURE__ */ new Set([
 function trendingLanguageSlug(language) {
   return language.trim().toLowerCase().replace(/\s+/g, "-");
 }
+function resolveTrendingLanguage(language) {
+  const trimmed = typeof language === "string" ? language.trim() : "";
+  if (!trimmed) return void 0;
+  const slug = trendingLanguageSlug(trimmed);
+  if (!TRENDING_LANGUAGES.has(slug)) {
+    throw new Error(
+      `"${trimmed}" is not a trending language filter. Try one of: rust, python, typescript, javascript, go, zig.`
+    );
+  }
+  return slug;
+}
 function buildTrendingUrl(since, language) {
   const params = new URLSearchParams();
   if (since !== "daily") params.set("since", since);
@@ -1428,7 +1439,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.6.0";
+    cached = "9.7.0";
     return cached;
   }
   try {
@@ -2588,6 +2599,250 @@ function buildComparisonTable(repos) {
   lines.push("\u2514" + sep.map((s) => "\u2500" + s + "\u2500").join("\u2534") + "\u2518");
   return lines.join("\n");
 }
+function comparisonRepo(r) {
+  return {
+    fullName: r.fullName,
+    url: r.url,
+    description: r.description,
+    stars: r.stars,
+    forks: r.forks,
+    language: r.language,
+    createdAt: r.createdAt,
+    updatedAt: r.updatedAt,
+    topics: r.topics,
+    archived: r.archived
+  };
+}
+function comparisonJson(repos) {
+  return JSON.stringify(repos.map(comparisonRepo), null, 2);
+}
+function csvEscape3(val) {
+  const str = String(val ?? "");
+  if (str.includes('"') || str.includes(",") || str.includes("\n")) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}
+function comparisonCsv(repos) {
+  const header = "full_name,stars,forks,language,created,updated,archived,url";
+  const rows = repos.map(
+    (r) => [
+      r.fullName,
+      r.stars,
+      r.forks,
+      r.language ?? "",
+      r.createdAt?.slice(0, 10) ?? "",
+      r.updatedAt?.slice(0, 10) ?? "",
+      String(r.archived),
+      r.url
+    ].map(csvEscape3).join(",")
+  );
+  return [header, ...rows].join("\n");
+}
+function comparisonMarkdown(repos) {
+  const header = "| Repo | Stars | Forks | Language | Created | Updated | Topics |";
+  const sep = "|------|-------|-------|----------|---------|---------|--------|";
+  const rows = repos.map(
+    (r) => `| [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.forks.toLocaleString()} | ${r.language ?? "\u2014"} | ${r.createdAt?.slice(0, 7) ?? "\u2014"} | ${r.updatedAt?.slice(0, 10) ?? "\u2014"} | ${(r.topics?.slice(0, 5).join(", ") ?? "") || "\u2014"} |`
+  );
+  return [header, sep, ...rows].join("\n");
+}
+
+// src/deepdive.ts
+var USER_AGENT = "ghfind/1.0";
+function buildHeaders(token) {
+  const headers = { "User-Agent": USER_AGENT };
+  if (token) headers.Authorization = `Bearer ${token}`;
+  return headers;
+}
+var REPO_REF_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
+function parseRepoRef(input) {
+  const fullName = input.trim().replace(/\.git$/, "").replace(/^@/, "");
+  if (!REPO_REF_RE.test(fullName)) {
+    throw new Error(
+      `"${input}" is not a repo name \u2014 use owner/name, e.g. facebook/react.`
+    );
+  }
+  const [owner, name] = fullName.split("/");
+  return { owner, name };
+}
+function repoFromRef(fullName) {
+  const { owner, name } = parseRepoRef(fullName);
+  return {
+    id: 0,
+    fullName: `${owner}/${name}`,
+    name,
+    owner,
+    description: null,
+    url: `https://github.com/${owner}/${name}`,
+    stars: 0,
+    forks: 0,
+    watchers: 0,
+    language: null,
+    topics: [],
+    archived: false,
+    isFork: false,
+    private: false,
+    createdAt: "",
+    updatedAt: "",
+    pushedAt: "",
+    score: 0
+  };
+}
+async function resolveRepoFromRef(fullName, token) {
+  const ref = parseRepoRef(fullName);
+  const canonical = `${ref.owner}/${ref.name}`;
+  try {
+    const res = await fetch(`https://api.github.com/repos/${canonical}`, {
+      headers: buildHeaders(token)
+    });
+    if (res.status === 404) {
+      throw new Error(`Repo not found: ${canonical}`);
+    }
+    if (res.ok) {
+      const api = await res.json();
+      return {
+        id: 0,
+        fullName: canonical,
+        name: ref.name,
+        owner: ref.owner,
+        description: api.description,
+        url: api.html_url,
+        stars: api.stargazers_count ?? 0,
+        forks: api.forks_count ?? 0,
+        watchers: api.subscribers_count ?? 0,
+        language: api.language,
+        topics: api.topics ?? [],
+        archived: api.archived ?? false,
+        isFork: api.fork ?? false,
+        private: false,
+        createdAt: api.created_at ?? "",
+        updatedAt: api.updated_at ?? "",
+        pushedAt: api.pushed_at ?? "",
+        score: 0
+      };
+    }
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("Repo not found")) {
+      throw err;
+    }
+  }
+  return repoFromRef(canonical);
+}
+var README_MAX_CHARS = 5e3;
+async function fetchDeepDiveRaw(repo, token) {
+  const headers = buildHeaders(token);
+  const [languagesRes, contributorsRes] = await Promise.all([
+    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/languages`, {
+      headers
+    }),
+    fetch(
+      `https://api.github.com/repos/${repo.owner}/${repo.name}/contributors?per_page=5`,
+      { headers }
+    )
+  ]);
+  let readmeText = "";
+  for (const path of [
+    `${repo.owner}/${repo.name}/main/README.md`,
+    `${repo.owner}/${repo.name}/master/README.md`,
+    `${repo.owner}/${repo.name}/main/README.rst`
+  ]) {
+    const r = await fetch(`https://raw.githubusercontent.com/${path}`, {
+      headers
+    });
+    if (r.ok) {
+      readmeText = await r.text();
+      break;
+    }
+  }
+  const langEntries = languagesRes.ok ? Object.entries(
+    await languagesRes.json().catch(() => ({}))
+  ) : [];
+  const totalBytes = langEntries.reduce((s, [, v]) => s + v, 0);
+  const contributors = contributorsRes.ok ? await contributorsRes.json().catch(() => []) : [];
+  return {
+    repo: {
+      fullName: repo.fullName,
+      url: repo.url,
+      description: repo.description,
+      stars: repo.stars,
+      forks: repo.forks,
+      language: repo.language,
+      topics: repo.topics
+    },
+    languages: langEntries.sort(([, a], [, b]) => b - a).map(([name, bytes]) => ({
+      name,
+      bytes,
+      percent: totalBytes > 0 ? bytes / totalBytes * 100 : 0
+    })),
+    contributors: contributors.map((c) => ({
+      login: c.login,
+      contributions: c.contributions
+    })),
+    readme: readmeText.slice(0, README_MAX_CHARS)
+  };
+}
+function buildDeepDiveJson(data) {
+  return JSON.stringify(data, null, 2);
+}
+function buildDeepDiveData(repo, raw) {
+  return {
+    summary: formatSummary(repo),
+    languages: formatLanguages(raw.languages),
+    contributors: formatContributors(raw.contributors),
+    readme: formatReadme(raw.readme)
+  };
+}
+async function fetchDeepDive(repo, token) {
+  return buildDeepDiveData(repo, await fetchDeepDiveRaw(repo, token));
+}
+function formatSummary(repo) {
+  const lines = [
+    ` ${repo.fullName}`,
+    ` \u2605 ${repo.stars.toLocaleString()}  \u25C6 ${repo.forks.toLocaleString()}  ${repo.language ?? "\u2014"}`,
+    repo.description ? ` ${repo.description}` : "",
+    repo.topics.length ? ` topics: ${repo.topics.slice(0, 8).join(", ")}` : "",
+    ` ${repo.url}`
+  ];
+  return lines.filter(Boolean).join("\n");
+}
+function formatLanguages(langs) {
+  if (langs.length === 0) return "  (no language data)";
+  const barW = 20;
+  return langs.slice(0, 8).map(({ name, percent }) => {
+    const pct = percent.toFixed(1);
+    const filled = Math.round(percent / 100 * barW);
+    const bar = "\u2588".repeat(filled) + "\u2591".repeat(barW - filled);
+    return `  ${name.padEnd(16)} ${bar} ${pct}%`;
+  }).join("\n");
+}
+function formatContributors(contributors) {
+  if (contributors.length === 0) return "  (no contributor data)";
+  return contributors.slice(0, 5).map((c) => `  \u25B2 ${c.login.padEnd(20)} ${c.contributions} commits`).join("\n");
+}
+function formatReadme(readme) {
+  if (!readme) return "  (no README)";
+  const stripped = readme.replace(/```[\s\S]*?```/g, "[code block]").replace(/#{1,6}\s/g, "").replace(/\*\*(.+?)\*\*/g, "$1").replace(/\[(.+?)\]\(.+?\)/g, "$1").replace(/`([^`]+)`/g, "$1").split("\n").map((l) => l.trim()).filter(Boolean);
+  const lines = stripped.slice(0, 30);
+  if (stripped.length > 30)
+    lines.push("... (more lines, open in browser to read full)");
+  return lines.map((l) => `  ${l}`).join("\n");
+}
+function buildDeepDiveText(data) {
+  return [
+    "\u2500\u2500 Summary \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    data.summary,
+    "",
+    "\u2500\u2500 Languages \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    data.languages,
+    "",
+    "\u2500\u2500 Top Contributors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    data.contributors,
+    "",
+    "\u2500\u2500 README \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    data.readme
+  ].join("\n");
+}
 
 // src/cli.ts
 import { readFileSync as readFileSync6 } from "fs";
@@ -2902,99 +3157,6 @@ function restoreSession() {
   return readJSON(SESSION_FILE, null);
 }
 
-// src/deepdive.ts
-var USER_AGENT = "ghfind/1.0";
-function buildHeaders(token) {
-  const headers = { "User-Agent": USER_AGENT };
-  if (token) headers.Authorization = `Bearer ${token}`;
-  return headers;
-}
-async function fetchDeepDive(repo, token) {
-  const headers = buildHeaders(token);
-  const [languagesRes, contributorsRes] = await Promise.all([
-    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/languages`, {
-      headers
-    }),
-    fetch(
-      `https://api.github.com/repos/${repo.owner}/${repo.name}/contributors?per_page=5`,
-      { headers }
-    )
-  ]);
-  let readmeText = "";
-  for (const path of [
-    `${repo.owner}/${repo.name}/main/README.md`,
-    `${repo.owner}/${repo.name}/master/README.md`,
-    `${repo.owner}/${repo.name}/main/README.rst`
-  ]) {
-    const r = await fetch(`https://raw.githubusercontent.com/${path}`, {
-      headers
-    });
-    if (r.ok) {
-      readmeText = await r.text();
-      break;
-    }
-  }
-  return {
-    summary: formatSummary(repo),
-    languages: formatLanguages(
-      languagesRes.ok ? await languagesRes.json().catch(() => ({})) : {}
-    ),
-    contributors: formatContributors(
-      contributorsRes.ok ? await contributorsRes.json().catch(() => []) : []
-    ),
-    readme: formatReadme(readmeText)
-  };
-}
-function formatSummary(repo) {
-  const lines = [
-    ` ${repo.fullName}`,
-    ` \u2605 ${repo.stars.toLocaleString()}  \u25C6 ${repo.forks.toLocaleString()}  ${repo.language ?? "\u2014"}`,
-    repo.description ? ` ${repo.description}` : "",
-    repo.topics.length ? ` topics: ${repo.topics.slice(0, 8).join(", ")}` : "",
-    ` ${repo.url}`
-  ];
-  return lines.filter(Boolean).join("\n");
-}
-function formatLanguages(langs) {
-  const entries = Object.entries(langs);
-  if (entries.length === 0) return "  (no language data)";
-  const total = entries.reduce((s, [, v]) => s + v, 0);
-  const barW = 20;
-  return entries.sort(([, a], [, b]) => b - a).slice(0, 8).map(([name, bytes]) => {
-    const pct = (bytes / total * 100).toFixed(1);
-    const filled = Math.round(bytes / total * barW);
-    const bar = "\u2588".repeat(filled) + "\u2591".repeat(barW - filled);
-    return `  ${name.padEnd(16)} ${bar} ${pct}%`;
-  }).join("\n");
-}
-function formatContributors(contributors) {
-  if (contributors.length === 0) return "  (no contributor data)";
-  return contributors.slice(0, 5).map((c) => `  \u25B2 ${c.login.padEnd(20)} ${c.contributions} commits`).join("\n");
-}
-function formatReadme(readme) {
-  if (!readme) return "  (no README)";
-  const stripped = readme.replace(/```[\s\S]*?```/g, "[code block]").replace(/#{1,6}\s/g, "").replace(/\*\*(.+?)\*\*/g, "$1").replace(/\[(.+?)\]\(.+?\)/g, "$1").replace(/`([^`]+)`/g, "$1").split("\n").map((l) => l.trim()).filter(Boolean);
-  const lines = stripped.slice(0, 30);
-  if (stripped.length > 30)
-    lines.push("... (more lines, open in browser to read full)");
-  return lines.map((l) => `  ${l}`).join("\n");
-}
-function buildDeepDiveText(data) {
-  return [
-    "\u2500\u2500 Summary \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    data.summary,
-    "",
-    "\u2500\u2500 Languages \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    data.languages,
-    "",
-    "\u2500\u2500 Top Contributors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    data.contributors,
-    "",
-    "\u2500\u2500 README \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    data.readme
-  ].join("\n");
-}
-
 // src/markdown-render.ts
 function renderMarkdown(md, opts = {}) {
   const width = opts.width ?? 80;
@@ -6032,7 +6194,8 @@ Formats: --json | --csv | --markdown | --count | --format urls|names|ssh-urls|cl
 
 ## Trending repositories
 
-    ghfind --trending --json [--since daily|weekly|monthly]
+    ghfind --trending --json [--since daily|weekly|monthly] [--language rust]
+    ghfind trending rust --json      # subcommand form of the same thing
 
 ## npm packages
 
@@ -6045,14 +6208,14 @@ Formats: --json | --csv | --markdown | --count | --format urls|names|ssh-urls|cl
 
 ## Compare repositories
 
-    ghfind --compare owner/a owner/b [--json]
-Compare is text-only; there is no JSON formatter for it yet.
+    ghfind --compare owner/a owner/b [--json|--csv|--markdown]
+Errors if fewer than 2 of the requested repos resolve; unresolved names are
+reported in text output and via the error message.
 
 ## Deep-dive a repo (languages, contributors, README)
 
-Not exposed on the CLI. Fetch directly instead:
-  curl -s https://api.github.com/repos/OWNER/REPO/languages
-  curl -s https://raw.githubusercontent.com/OWNER/REPO/main/README.md
+    ghfind deep-dive owner/repo --json
+Text output (no flag) prints the same sections formatted for the terminal.
 
 ## Rate limits
 
@@ -6161,39 +6324,8 @@ function formatPackageLines(pkgs) {
     return `${i + 1}. ${p.name}@${p.version}${desc} (\u2193 ${fmtInt(p.downloads)}/mo)`;
   }).join("\n");
 }
-var REPO_NAME_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/;
-function parseRepoName(input) {
-  const fullName = input.trim().replace(/\.git$/, "").replace(/^@/, "");
-  if (!REPO_NAME_RE.test(fullName)) {
-    throw new McpToolError(
-      `"${input}" is not a repo name \u2014 use owner/name, e.g. facebook/react.`
-    );
-  }
-  const [owner, name] = fullName.split("/");
-  return { owner, name };
-}
-function stubRepo(fullName) {
-  const { owner, name } = parseRepoName(fullName);
-  return {
-    id: 0,
-    fullName: `${owner}/${name}`,
-    name,
-    owner,
-    description: null,
-    url: `https://github.com/${owner}/${name}`,
-    stars: 0,
-    forks: 0,
-    watchers: 0,
-    language: null,
-    topics: [],
-    archived: false,
-    isFork: false,
-    private: false,
-    createdAt: "",
-    updatedAt: "",
-    pushedAt: "",
-    score: 0
-  };
+function asMcpToolError(err) {
+  return new McpToolError(err instanceof Error ? err.message : String(err));
 }
 var TRENDING_QUERY = { keywords: [], qualifiers: [], raw: "trending" };
 var REPO_SORTS = ["best-match", "stars", "updated", "forks"];
@@ -6302,15 +6434,12 @@ var TOOLS = [
       const limit = coerceInt(args.limit, 25, 1, 50);
       const token = resolveToken(state, args.token);
       let language;
-      const langArg = typeof args.language === "string" ? args.language.trim() : "";
-      if (langArg) {
-        const slug = trendingLanguageSlug(langArg);
-        if (!TRENDING_LANGUAGES.has(slug)) {
-          throw new McpToolError(
-            `"${langArg}" is not a trending language filter. Try one of: rust, python, typescript, javascript, go, zig.`
-          );
-        }
-        language = slug;
+      try {
+        language = resolveTrendingLanguage(
+          typeof args.language === "string" ? args.language : void 0
+        );
+      } catch (err) {
+        throw asMcpToolError(err);
       }
       const trending = createTrendingSearch();
       const options = {
@@ -6500,7 +6629,12 @@ Not found: ${missing.join(", ")}` : "");
     async run(args, state) {
       const repo = String(args.repo ?? "").trim();
       if (!repo) throw new McpToolError("repo must be a non-empty string.");
-      const stub = stubRepo(repo);
+      let stub;
+      try {
+        stub = await resolveRepoFromRef(repo, resolveToken(state, args.token));
+      } catch (err) {
+        throw asMcpToolError(err);
+      }
       const data = await fetchDeepDive(stub, resolveToken(state, args.token));
       return { text: buildDeepDiveText(data), data: { ...data } };
     }
@@ -6585,8 +6719,9 @@ async function processServerLine(line, state, config) {
     config.write(respondError(null, INVALID_REQUEST, "Invalid Request"));
     return;
   }
-  const isNotification = msg.id === void 0 || msg.id === null;
-  const id = isNotification ? null : msg.id;
+  const rawId = msg.id;
+  const isNotification = rawId === void 0 || rawId === null;
+  const id = isNotification ? null : rawId;
   if (msg.method === "notifications/initialized") {
     state.initialized = true;
     return;
@@ -6763,6 +6898,16 @@ function parseArgs(args) {
       case "--trending":
         flags.trending = true;
         break;
+      case "trending": {
+        flags.trending = true;
+        if (flags.query === "" && i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          flags.language = args[++i];
+        }
+        break;
+      }
+      case "--language":
+        flags.language = args[++i];
+        break;
       case "--watch":
         flags.watch = true;
         break;
@@ -6824,6 +6969,14 @@ function parseArgs(args) {
       case "mcp":
         flags.mcp = true;
         break;
+      case "deep-dive": {
+        const next = args[i + 1];
+        if (next && !next.startsWith("-")) {
+          flags.deepDive = next;
+          i++;
+        }
+        break;
+      }
       case "skill": {
         const next = args[i + 1];
         if (next && !next.startsWith("-")) {
@@ -6892,8 +7045,12 @@ Usage:
   ghfind <query> --format <fmt>    Format lines (urls|names|ssh-urls|clone-commands|ids)
   ghfind <query> --pipe <target>   Pipe to clone/open
   ghfind --trending --json         Trending repos as JSON
+  ghfind trending <lang>           Trending repos, optionally by language
   ghfind --releases                Check bookmarks for new releases
   ghfind --compare <r1> <r2>       Compare two+ repos side-by-side
+  ghfind --compare a/b c/d --json  Compare as JSON|CSV|Markdown
+  ghfind deep-dive <owner/repo>    Deep-dive: languages, contributors, README
+  ghfind deep-dive a/b --json      Deep-dive as JSON
   ghfind org <name> --json         Org profile: repos, stars, top languages
   ghfind user <name> --json        User profile: repos, stars, top languages
   ghfind pkg <query> --json        Search npm packages, output JSON
@@ -6914,6 +7071,7 @@ Options:
   --sort <strategy>                    Sort: best-match|stars|updated|forks
   --theme <name>                     Theme: tokyo-night|premium-dark (default: tokyo-night)
   --trending                           Trending mode
+  --language <lang>                    Trending language filter (e.g. rust)
   --since <period>                     Trending period: daily|weekly|monthly
   --pipe <target>                      Pipe target: clone|open
   --format <fmt>                       Line format: urls|names|ssh-urls|...
@@ -6966,6 +7124,10 @@ Options:
     return;
   }
   const outputFormat = flags.json ? "json" : flags.csv ? "csv" : flags.markdown ? "markdown" : void 0;
+  if (flags.deepDive !== void 0) {
+    await runDeepDive(flags, outputFormat);
+    return;
+  }
   if (flags.org !== void 0) {
     await runOrgProfile(flags, outputFormat);
     return;
@@ -6974,7 +7136,9 @@ Options:
     await runUserProfile(flags, outputFormat);
     return;
   }
-  const isNonInteractive = outputFormat || flags.count || flags.format || flags.pipe || flags.watch || flags.releases;
+  const isNonInteractive = outputFormat || flags.count || flags.format || flags.pipe || flags.watch || flags.releases || // `ghfind trending rust` / `ghfind --trending rust` print a list —
+  // a language filter implies non-interactive output
+  flags.trending && (!!flags.language || !!flags.query);
   if (isNonInteractive) {
     if (flags.releases) {
       await runReleases(flags, outputFormat);
@@ -7052,6 +7216,27 @@ async function runOrgProfile(flags, outputFormat) {
     process.exit(1);
   }
 }
+async function runDeepDive(flags, outputFormat) {
+  const ref = flags.deepDive;
+  if (!ref) {
+    console.error(
+      "Usage: ghfind deep-dive <owner/repo> [--json] [--token <t>]"
+    );
+    process.exit(1);
+  }
+  try {
+    const repo = await resolveRepoFromRef(ref, flags.token);
+    const raw = await fetchDeepDiveRaw(repo, flags.token);
+    if (outputFormat === "json") {
+      console.log(buildDeepDiveJson(raw));
+    } else {
+      console.log(buildDeepDiveText(buildDeepDiveData(repo, raw)));
+    }
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
 async function runPackageSearch(flags) {
   if (flags.registry !== "npm") {
     console.error(`Registry "${flags.registry}" not yet supported (only npm).`);
@@ -7145,6 +7330,15 @@ async function runNonInteractive(flags, outputFormat) {
     trending: async (ctx2) => {
       const since = flags.since === "weekly" ? "weekly" : flags.since === "monthly" ? "monthly" : "daily";
       const trendingSearch = createTrendingSearch();
+      let language;
+      try {
+        language = resolveTrendingLanguage(
+          flags.language ?? (flags.query ? flags.query.split(/\s+/)[0] : void 0)
+        );
+      } catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+      }
       const response = await trendingSearch.search(
         { keywords: [], qualifiers: [], raw: "trending" },
         {
@@ -7152,7 +7346,8 @@ async function runNonInteractive(flags, outputFormat) {
           sort: "stars",
           json: false,
           verbose: false,
-          trendingSince: since
+          trendingSince: since,
+          ...language ? { trendingLanguage: language } : {}
         }
       );
       if (outputFormat) {
@@ -7236,6 +7431,7 @@ async function runNonInteractive(flags, outputFormat) {
     compare: async (_ctx) => {
       const search = createGitHubSearch(void 0, [flags.token ?? ""]);
       const repos = [];
+      const missing = [];
       for (const fullName of flags.compare) {
         const res = await search.search(
           { keywords: [fullName], qualifiers: [], raw: fullName },
@@ -7247,9 +7443,27 @@ async function runNonInteractive(flags, outputFormat) {
             token: flags.token
           }
         );
-        repos.push(...res.repos);
+        if (res.repos.length > 0) repos.push(...res.repos);
+        else missing.push(fullName);
+      }
+      if (repos.length < 2) {
+        console.error(
+          `Could not resolve enough repos to compare (found ${repos.length}${missing.length ? `; not found: ${missing.join(", ")}` : ""}).`
+        );
+        process.exit(1);
+      }
+      const notFound = missing.length ? `
+
+Not found: ${missing.join(", ")}` : "";
+      if (outputFormat === "json") {
+        console.log(comparisonJson(repos));
+      } else if (outputFormat === "csv") {
+        console.log(comparisonCsv(repos));
+      } else if (outputFormat === "markdown") {
+        console.log(comparisonMarkdown(repos));
+      } else {
+        console.log(buildComparisonTable(repos) + notFound);
       }
-      console.log(buildComparisonTable(repos));
     }
   };
   const key = flags.compare.length > 0 ? "compare" : flags.trending && !flags.watch ? "trending" : flags.watch ? "watch" : flags.pipe ? "pipe" : flags.format ? "format" : "search";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-search-cli",
-  "version": "9.6.0",
+  "version": "9.7.0",
   "description": "Search GitHub from your terminal — repo search, trending repos, npm package search, bookmarks, deep-dive, compare, export. Keyboard-driven TUI + pipeable CLI.",
   "type": "module",
   "packageManager": "bun@1",