github-search-cli 9.6.0 → 9.7.1

package/dist/cli.js

@@ -62,14 +62,14 @@ function flattenHtml(html) {
 }
 function parseRepoLink(block) {
   const anchor = block.match(
-    /<a[^>]*?href="\/([A-Za-z0-9._-]+)\/([^\"?#]+)"[^>]*class="Link"/
+    /<a[^>]*?href="\/([A-Za-z0-9._-]+)\/([^"?#]+)"[^>]*class="Link"/
   );
   if (!anchor) return void 0;
   return { owner: anchor[1], name: anchor[2] };
 }
 function parseStars(block) {
   const starsMatch = block.match(
-    /href="\/[^\/\"]+\/[^\/\"]+\/stargazers"[^>]*>.*?<\/svg>\s*(\d[\d,]*)/
+    /href="\/[^/"]+\/[^/"]+\/stargazers"[^>]*>.*?<\/svg>\s*(\d[\d,]*)/
   );
   return starsMatch ? parseInt(starsMatch[1].replace(/,/g, ""), 10) : 0;
 }
@@ -91,9 +91,8 @@ function parseTrendingHtml(html) {
   const flat = flattenHtml(html);
   const repos = [];
   const articleRe = /<article class="Box-row">(.*?)<\/article>/gi;
-  let match;
   let rank = 0;
-  while ((match = articleRe.exec(flat)) !== null) {
+  for (const match of flat.matchAll(articleRe)) {
     rank++;
     const block = match[1];
     const link = parseRepoLink(block);
@@ -240,7 +239,7 @@ function suggestFor(input) {
     return QUALIFIER_SUGGESTIONS[trimmed];
   }
   const matches = KNOWN_QUALIFIERS.filter((k) => k.startsWith(trimmed));
-  return matches.map((k) => k + ":");
+  return matches.map((k) => `${k}:`);
 }
 function tokenize(input) {
   const tokens = [];
@@ -353,7 +352,6 @@ function githubSortParam(sort) {
       return { sort: "forks", order: "desc" };
     case "updated":
       return { sort: "updated", order: "desc" };
-    case "best-match":
     default:
       return {};
   }
@@ -378,7 +376,6 @@ function rankRepos(repos, strategy) {
     case "updated":
       copy.sort(byKey((r) => Date.parse(r.updatedAt)));
       break;
-    case "best-match":
     default:
       break;
   }
@@ -540,6 +537,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);
@@ -574,6 +582,7 @@ function trendingRepoToRepo(r) {
 }
 var TrendingAdapter = class {
   name = "trending";
+  // biome-ignore lint/correctness/noUnusedPrivateClassMembers: part of the adapter constructor contract — callers pass a shared logger (search.ts:757) even though this adapter currently logs nothing itself.
   logger;
   constructor(logger2 = noopLogger) {
     this.logger = logger2;
@@ -729,12 +738,17 @@ import {
 } from "@opentui/core";
 
 // src/open-url.ts
+import { spawn } from "child_process";
 function openUrl(url) {
   try {
     const p = process.platform;
-    if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
-    else if (p === "darwin") Bun.spawn(["open", url]);
-    else Bun.spawn(["xdg-open", url]);
+    const cmd = p === "win32" ? "explorer" : p === "darwin" ? "open" : "xdg-open";
+    if (typeof Bun !== "undefined") {
+      Bun.spawn([cmd, url]);
+      return;
+    }
+    const child = spawn(cmd, [url], { detached: true, stdio: "ignore" });
+    child.unref();
   } catch {
   }
 }
@@ -924,7 +938,7 @@ function formatPackageLine(pack) {
   const nameStr = `${pack.name}@${pack.version}`.padEnd(28).slice(0, 28);
   const dlStr = `\u2193 ${fmtCount(pack.downloads)}`.padEnd(20).slice(0, 20);
   const scoreStr = `score ${pack.score.toFixed(2)}`.padEnd(12).slice(0, 12);
-  const desc = (pack.description ?? "").length > 60 ? (pack.description ?? "").slice(0, 57) + "..." : pack.description ?? "";
+  const desc = (pack.description ?? "").length > 60 ? `${(pack.description ?? "").slice(0, 57)}...` : pack.description ?? "";
   const line1 = t`${bold(fg(C.nameText)(nameStr))}${fg(C.cyan)(dlStr)}${fg(C.gold)(scoreStr)}`;
   const line2 = t`${dim(fg(C.descText)(`     ${desc}`))}`;
   const newline = { text: "\n", __isChunk: true };
@@ -1187,9 +1201,13 @@ var results = [];
 function add(status, label, detail) {
   results.push({ status, label, detail });
 }
-function run(cmd, args) {
+function run(cmd, args, opts = {}) {
   try {
-    const res = spawnSync(cmd, args, { encoding: "utf8", timeout: 15e3 });
+    const res = spawnSync(cmd, args, {
+      encoding: "utf8",
+      timeout: 15e3,
+      ...opts
+    });
     return {
       status: res.status,
       stdout: res.stdout ?? "",
@@ -1364,6 +1382,97 @@ function checkDirs() {
     }
   }
 }
+var PKG_NAME = "github-search-cli";
+var BIN_NAME = "ghfind";
+function runningVersion() {
+  try {
+    const pkg = JSON.parse(
+      readFileSync(join(PKG_DIR, "package.json"), "utf8")
+    );
+    return pkg.version ?? "";
+  } catch {
+    return "";
+  }
+}
+function installVersionAt(shimPath) {
+  const dir = dirname(shimPath);
+  for (const ancestor of [dir, dirname(dir)]) {
+    for (const sub of ["node_modules", join("lib", "node_modules")]) {
+      const pkgJson = join(ancestor, sub, PKG_NAME, "package.json");
+      if (existsSync(pkgJson)) {
+        try {
+          const pkg = JSON.parse(readFileSync(pkgJson, "utf8"));
+          return { version: pkg.version ?? "", dir: dirname(pkgJson) };
+        } catch {
+        }
+      }
+    }
+  }
+  const res = run(shimPath, ["--version"], {
+    shell: platform() === "win32",
+    timeout: 1e4
+  });
+  const m = /\d+\.\d+\.\d+/.exec(res.stdout);
+  return m ? { version: m[0], dir } : null;
+}
+function checkInstallShadowing() {
+  const isWin = platform() === "win32";
+  const res = isWin ? run("where", [BIN_NAME]) : run("which", ["-a", BIN_NAME]);
+  const shims = [
+    ...new Set(
+      res.stdout.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0)
+    )
+  ];
+  if (shims.length === 0) {
+    add("WARN", "Global installs", `${BIN_NAME} not found on PATH.`);
+    return;
+  }
+  const running = runningVersion();
+  const norm = (p) => isWin ? p.replace(/\\/g, "/").toLowerCase() : p;
+  const seenDirs = /* @__PURE__ */ new Set();
+  const stale = [];
+  let knownCount = 0;
+  let staleVersion = "";
+  let staleDir = "";
+  for (const shim of shims) {
+    const info = installVersionAt(shim);
+    const dirKey = norm(dirname(shim));
+    if (seenDirs.has(dirKey)) continue;
+    seenDirs.add(dirKey);
+    knownCount++;
+    const isRunningInstall = info !== null && norm(info.dir) === norm(PKG_DIR);
+    if (!isRunningInstall && info !== null && running && info.version !== running) {
+      stale.push(`${dirname(shim)} (v${info.version} \u2260 running v${running})`);
+      staleVersion = info.version;
+      staleDir = dirname(shim);
+    }
+  }
+  if (stale.length > 0 && knownCount > 1) {
+    add(
+      "WARN",
+      "Global installs",
+      `${knownCount} install(s) on PATH; stale copies shadowing updates \u2192 ${stale.join("; ")}. Remove with: npm uninstall -g ${PKG_NAME} --prefix <dir>`
+    );
+  } else if (stale.length > 0) {
+    add(
+      "PASS",
+      "Global installs",
+      `v${staleVersion} at ${staleDir} (running v${running || "?"} from source/build) \u2014 single install, nothing shadowed.`
+    );
+  } else if (knownCount > 1) {
+    add(
+      "PASS",
+      "Global installs",
+      `${knownCount} install(s) on PATH, all v${running || "?"}.`
+    );
+  } else {
+    add(
+      "PASS",
+      "Global installs",
+      `v${running || "?"} at ${dirname(shims[0])}.`
+    );
+  }
+}
 function printReport() {
   const noColor = process.env.NO_COLOR !== void 0 || !process.stdout.isTTY;
   const colors2 = (s, n) => {
@@ -1406,6 +1515,7 @@ async function runDoctor() {
   checkConfig();
   checkGithubToken();
   checkDirs();
+  checkInstallShadowing();
   printReport();
   const hasFail = results.some((r) => r.status === "FAIL");
   process.exitCode = hasFail ? 1 : 0;
@@ -1418,7 +1528,7 @@ import {
   version as nodeVersion,
   versions as nodeVersions
 } from "process";
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 
 // src/version.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -1428,7 +1538,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.6.0";
+    cached = "9.7.1";
     return cached;
   }
   try {
@@ -1504,14 +1614,15 @@ function tryOpenUrl(url) {
   try {
     const p = osPlatform;
     if (typeof Bun !== "undefined") {
-      if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
-      else if (p === "darwin") Bun.spawn(["open", url]);
+      if (p === "win32") {
+        Bun.spawn(["explorer", url]);
+      } else if (p === "darwin") Bun.spawn(["open", url]);
       else Bun.spawn(["xdg-open", url]);
       return true;
     }
-    const cmd = p === "win32" ? "cmd" : p === "darwin" ? "open" : "xdg-open";
-    const args = p === "win32" ? ["/c", "start", "", url] : [url];
-    const child = spawn(cmd, args, { detached: true, stdio: "ignore" });
+    const cmd = p === "win32" ? "explorer" : p === "darwin" ? "open" : "xdg-open";
+    const args = [url];
+    const child = spawn2(cmd, args, { detached: true, stdio: "ignore" });
     child.unref();
     return true;
   } catch {
@@ -1532,11 +1643,11 @@ function reportError(err, context = {
   console.error("");
   const opened = tryOpenUrl(url);
   if (opened) {
-    console.error("  \u2192 Opened: " + url);
+    console.error(`  \u2192 Opened: ${url}`);
   } else {
     console.error("  Copy this URL to file a bug report:");
     console.error("");
-    console.error("    " + url);
+    console.error(`    ${url}`);
   }
   console.error("");
   return url;
@@ -2137,7 +2248,8 @@ function appendJSONL(filename, obj) {
   try {
     appendFileSync(
       join3(stateDir(), filename),
-      JSON.stringify(obj) + "\n",
+      `${JSON.stringify(obj)}
+`,
       "utf-8"
     );
   } catch {
@@ -2288,7 +2400,7 @@ async function fetchReleases(fullName, etag, token) {
     Accept: "application/vnd.github+json"
   };
   if (etag) headers["If-None-Match"] = etag;
-  if (token) headers["Authorization"] = `Bearer ${token}`;
+  if (token) headers.Authorization = `Bearer ${token}`;
   const res = await fetch(
     `https://api.github.com/repos/${fullName}/releases?per_page=${PER_REPO}`,
     { headers }
@@ -2525,7 +2637,7 @@ async function runInitWizard() {
   const themeStr = await ask(`  Theme [${themes.join("/")}] (tokyo-night): `);
   const config = {
     defaultSort: ["best-match", "stars", "updated", "forks"].includes(sortStr) ? sortStr : "best-match",
-    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr) || 50)),
+    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr, 10) || 50)),
     theme: themes.includes(themeStr) ? themeStr : themes[0],
     cacheTtlSeconds: 300,
     defaultTab: "search"
@@ -2574,20 +2686,264 @@ function buildComparisonTable(repos) {
   const header = ["".padEnd(14), ...names.map((n) => n.padEnd(colW))];
   const sep = ["".padEnd(14, "\u2500"), ...names.map(() => "".padEnd(colW, "\u2500"))];
   const lines = [
-    "\u250C" + sep.map((s) => "\u2500" + s + "\u2500").join("\u252C") + "\u2510",
-    "\u2502" + header.map((h) => ` ${h} `).join("\u2502") + "\u2502",
-    "\u251C" + sep.map((s) => "\u2500" + s + "\u2500").join("\u253C") + "\u2524"
+    `\u250C${sep.map((s) => `\u2500${s}\u2500`).join("\u252C")}\u2510`,
+    `\u2502${header.map((h) => ` ${h} `).join("\u2502")}\u2502`,
+    `\u251C${sep.map((s) => `\u2500${s}\u2500`).join("\u253C")}\u2524`
   ];
   for (const row of rows) {
     const cells = [
       row.label.padEnd(14),
       ...row.values.map((v) => v.padEnd(colW))
     ];
-    lines.push("\u2502" + cells.map((c) => ` ${c} `).join("\u2502") + "\u2502");
+    lines.push(`\u2502${cells.map((c) => ` ${c} `).join("\u2502")}\u2502`);
   }
-  lines.push("\u2514" + sep.map((s) => "\u2500" + s + "\u2500").join("\u2534") + "\u2518");
+  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";
@@ -2819,7 +3175,8 @@ function deleteHistoryEntry(index) {
   );
   writeRaw(
     HISTORY_FILE,
-    remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n"
+    `${remaining.reverse().map((e) => JSON.stringify(e)).join("\n")}
+`
   );
 }
 function clearHistory() {
@@ -2831,7 +3188,8 @@ function rotateHistory() {
   const trimmed = entries.slice(0, MAX_ENTRIES);
   writeRaw(
     HISTORY_FILE,
-    trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n"
+    `${trimmed.reverse().map((e) => JSON.stringify(e)).join("\n")}
+`
   );
 }
 
@@ -2902,99 +3260,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;
@@ -3009,12 +3274,12 @@ function renderMarkdown(md, opts = {}) {
     if (codeLines.length === 0) return;
     const maxLen = Math.max(...codeLines.map((l) => l.length), codeLang.length);
     const barW = Math.min(maxLen + 4, width - 2);
-    out.push("\u250C" + "\u2500".repeat(barW) + "\u2510");
-    if (codeLang) out.push("\u2502 " + codeLang.padEnd(barW - 1) + "\u2502");
+    out.push(`\u250C${"\u2500".repeat(barW)}\u2510`);
+    if (codeLang) out.push(`\u2502 ${codeLang.padEnd(barW - 1)}\u2502`);
     for (const cl of codeLines) {
-      out.push("\u2502 " + cl.padEnd(barW - 1) + "\u2502");
+      out.push(`\u2502 ${cl.padEnd(barW - 1)}\u2502`);
     }
-    out.push("\u2514" + "\u2500".repeat(barW) + "\u2518");
+    out.push(`\u2514${"\u2500".repeat(barW)}\u2518`);
     out.push("");
     codeLines = [];
     codeLang = "";
@@ -3036,16 +3301,16 @@ function renderMarkdown(md, opts = {}) {
     const totalW = colW.reduce((a, b) => a + b, 0) + colCount * 3 - 1;
     if (totalW > width) {
       for (const row of dataRows) {
-        out.push("  " + row.map((c) => c.trim()).join(" \u2502 "));
+        out.push(`  ${row.map((c) => c.trim()).join(" \u2502 ")}`);
       }
     } else {
-      const sep = "\u250C" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u252C") + "\u2510";
-      const mid = "\u251C" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u253C") + "\u2524";
-      const end = "\u2514" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u2534") + "\u2518";
+      const sep = `\u250C${colW.map((w) => "\u2500".repeat(w + 2)).join("\u252C")}\u2510`;
+      const mid = `\u251C${colW.map((w) => "\u2500".repeat(w + 2)).join("\u253C")}\u2524`;
+      const end = `\u2514${colW.map((w) => "\u2500".repeat(w + 2)).join("\u2534")}\u2518`;
       out.push(sep);
       dataRows.forEach((row, i) => {
         const cells = colW.map((w, ci) => (row[ci] ?? "").trim().padEnd(w));
-        out.push("\u2502 " + cells.map((c) => ` ${c} `).join("\u2502") + "\u2502");
+        out.push(`\u2502 ${cells.map((c) => ` ${c} `).join("\u2502")}\u2502`);
         if (i === 0) out.push(mid);
       });
       out.push(end);
@@ -3076,7 +3341,7 @@ function renderMarkdown(md, opts = {}) {
     return parts;
   }
   for (let i = 0; i < lines.length; i++) {
-    let line = lines[i];
+    const line = lines[i];
     if (/^```/.test(line)) {
       if (inCodeBlock) {
         flushCode();
@@ -3121,7 +3386,7 @@ function renderMarkdown(md, opts = {}) {
     if (bqMatch) {
       const inner = renderInline(bqMatch[1]);
       for (const wl of wrapLine(inner, width - 4)) {
-        out.push("\u2502 " + wl);
+        out.push(`\u2502 ${wl}`);
       }
       continue;
     }
@@ -3129,7 +3394,7 @@ function renderMarkdown(md, opts = {}) {
     if (ulMatch) {
       const indent = ulMatch[1].length;
       const depth = Math.floor(indent / 2);
-      const prefix = "  ".repeat(depth) + "\u2022 ";
+      const prefix = `${"  ".repeat(depth)}\u2022 `;
       const inner = renderInline(ulMatch[2]);
       for (const wl of wrapLine(inner, width - prefix.length)) {
         out.push(prefix + wl);
@@ -3140,7 +3405,7 @@ function renderMarkdown(md, opts = {}) {
     if (olMatch) {
       const indent = olMatch[1].length;
       const depth = Math.floor(indent / 2);
-      const prefix = "  ".repeat(depth) + "\u25E6 ";
+      const prefix = `${"  ".repeat(depth)}\u25E6 `;
       const inner = renderInline(olMatch[2]);
       for (const wl of wrapLine(inner, width - prefix.length)) {
         out.push(prefix + wl);
@@ -3230,7 +3495,7 @@ var StatusManager = class {
 };
 
 // src/share.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 function formatShare(repo, format2) {
   switch (format2) {
     case "markdown":
@@ -3248,7 +3513,7 @@ async function copyToClipboard(text) {
     const p = process.platform;
     const cmd = p === "win32" ? ["clip"] : p === "darwin" ? ["pbcopy"] : await findLinuxClipboard();
     if (!cmd) return false;
-    const proc = spawn2(cmd[0], cmd.slice(1), {
+    const proc = spawn3(cmd[0], cmd.slice(1), {
       stdio: ["pipe", "ignore", "ignore"]
     });
     proc.stdin.write(text);
@@ -3311,9 +3576,10 @@ function nextTip() {
 
 // src/update-check.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { join as join5, dirname as dirname3 } from "path";
+import { join as join5, dirname as dirname3, posix } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var REGISTRY_URL = "https://registry.npmjs.org/github-search-cli/latest";
+var PKG_NAME2 = "github-search-cli";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 5e3;
 var __dirname2 = dirname3(fileURLToPath3(import.meta.url));
@@ -3398,30 +3664,55 @@ function suppressUpdateNotices() {
     suppressed: true
   });
 }
-async function performUpdate() {
-  const pkg = "github-search-cli";
-  const isBun = typeof process.versions !== "undefined" && "bun" in process.versions;
-  const cmd = isBun ? ["bun", "install", "-g", pkg] : ["npm", "install", "-g", pkg];
+function detectInstallLocation(pkgDir) {
+  const norm = pkgDir.split("\\").join("/");
+  const nodeModules = posix.dirname(norm);
+  if (posix.basename(nodeModules) !== "node_modules") return null;
+  const owner = posix.dirname(nodeModules);
+  if (/(^|\/)\.bun(\/|$)/.test(owner)) return { channel: "bun" };
+  const prefix = posix.basename(owner) === "lib" ? posix.dirname(owner) : owner;
+  return { channel: "npm", prefix };
+}
+function buildUpdateCommand(loc) {
+  if (loc.channel === "bun") return ["bun", "install", "-g", PKG_NAME2];
+  const args = ["npm", "install", "-g"];
+  if (loc.prefix) args.push("--prefix", loc.prefix);
+  args.push(PKG_NAME2);
+  return args;
+}
+function quoteWin32(arg) {
+  return /\s/.test(arg) ? `"${arg}"` : arg;
+}
+async function performUpdate(location = detectInstallLocation(PKG_DIR2)) {
+  if (!location) {
+    debugLog(
+      "Update skipped: the running install is not under a node_modules tree (compiled binary or dev checkout). Update it manually."
+    );
+    return false;
+  }
+  const argv = buildUpdateCommand(location);
   try {
-    if (isBun) {
-      const proc = Bun.spawn(cmd, {
-        stdout: "pipe",
-        stderr: "pipe"
-      });
-      await proc.exited;
-      if (proc.exitCode !== 0) {
-        const err = await proc.stderr.text();
-        debugLog(`Install failed (code ${proc.exitCode}): ${err}`);
-      }
-      return proc.exitCode === 0;
-    }
-    const { spawn: spawn3 } = await import("child_process");
-    return await new Promise((resolve) => {
-      const proc = spawn3(cmd[0], cmd.slice(1), { stdio: "ignore" });
-      proc.on("close", (code) => resolve(code === 0));
-      proc.on("error", () => resolve(false));
+    const { spawn: spawn4 } = await import("child_process");
+    const useShell = process.platform === "win32";
+    const proc = spawn4(
+      argv[0],
+      useShell ? argv.slice(1).map(quoteWin32) : argv.slice(1),
+      { stdio: ["ignore", "ignore", "pipe"], shell: useShell }
+    );
+    let stderr = "";
+    proc.stderr?.on("data", (chunk) => {
+      stderr += String(chunk);
     });
-  } catch {
+    const code = await new Promise((resolve) => {
+      proc.on("close", (c) => resolve(c));
+      proc.on("error", () => resolve(-1));
+    });
+    if (code !== 0) {
+      debugLog(`Install failed (code ${code}): ${stderr.trim()}`);
+    }
+    return code === 0;
+  } catch (e) {
+    debugLog(`Update failed: ${e instanceof Error ? e.message : String(e)}`);
     return false;
   }
 }
@@ -3441,7 +3732,7 @@ function fetchReleaseNotes(version) {
   try {
     const changelogPath = join5(PKG_DIR2, "CHANGELOG.md");
     const changelog = readFileSync5(changelogPath, "utf-8");
-    const header = "## [" + version + "]";
+    const header = `## [${version}]`;
     const start = changelog.indexOf(header);
     if (start === -1) return null;
     const bodyStart = start + header.length;
@@ -3585,8 +3876,8 @@ async function launchBrowser(theme_override) {
   let currentPage = 1;
   let totalCount = 0;
   let deepDiveActive = false;
-  let compareList = [];
-  let quitArmed = false;
+  const compareList = [];
+  const _quitArmed = false;
   const header = new TextRenderable4(renderer, {
     content: " ghfind \u2014 GitHub repo browser   [/]search  [Space]menu  [\u2192]open  [?]help  [q]uit",
     bg: colors.bg,
@@ -4449,6 +4740,7 @@ async function launchBrowser(theme_override) {
     if (menuStack.length <= 1) return false;
     const prev = menuStack[menuStack.length - 2];
     const current = menuStack.pop();
+    if (!current) return false;
     leaderSelect.options = prev.entries.map((e) => ({
       name: e.type === "category" ? `  ${e.icon} ${e.name} \u2192` : `  ${e.name}`,
       description: e.description,
@@ -4765,17 +5057,17 @@ async function launchBrowser(theme_override) {
     if (!cachedVersion) {
       cachedVersion = getVersion();
     }
-    const currentVersion2 = cachedVersion;
+    const currentVersion = cachedVersion;
     if (!state.lastInstalledVersion) return;
-    if (state.lastInstalledVersion === currentVersion2) return;
-    const notes = fetchReleaseNotes(currentVersion2);
+    if (state.lastInstalledVersion === currentVersion) return;
+    const notes = fetchReleaseNotes(currentVersion);
     const notesWidth = Math.max(
       30,
       Math.floor((process.stdout.columns || 80) * 0.55) - 8
     );
     const notesBlock = notes ? renderMarkdown(notes, { width: notesWidth }) : "  No release notes found for this version.";
     updateSelectedOption = 0;
-    updateText.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion2}
+    updateText.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion}
 
 ${notesBlock}`;
     renderUpdateOptions();
@@ -4786,8 +5078,8 @@ ${notesBlock}`;
     if (cachedVersion === null) {
       cachedVersion = getVersion();
     }
-    const currentVersion2 = cachedVersion;
-    const latest = process.env.DEBUG_FORCE_UPDATE || await checkForUpdate(currentVersion2);
+    const currentVersion = cachedVersion;
+    const latest = process.env.DEBUG_FORCE_UPDATE || await checkForUpdate(currentVersion);
     markUpdateChecked(latest ?? void 0);
     if (latest) {
       updateSelectedOption = 0;
@@ -4798,20 +5090,20 @@ ${notesBlock}`;
       );
       const notesBlock = notes ? renderMarkdown(notes, { width: notesWidth }) : `  A new version is available
 
-  Current: ${currentVersion2}
+  Current: ${currentVersion}
   Latest:   ${latest}
 
   Run "npm install -g ghfind"`;
       updateText.content = `  A new version is available
 
-  Current: ${currentVersion2}
+  Current: ${currentVersion}
   Latest:   ${latest}
 
 ${notesBlock}`;
       renderUpdateOptions();
       showOverlay("update");
     } else {
-      debugLog(`No update available (current: ${currentVersion2})`);
+      debugLog(`No update available (current: ${currentVersion})`);
     }
   }
   function openUrlIfSelected() {
@@ -4856,7 +5148,7 @@ ${notesBlock}`;
   }
   function saveCurrentSearch() {
     if (currentQueryInput) {
-      const name = currentQueryInput.length > 40 ? currentQueryInput.slice(0, 37) + "..." : currentQueryInput;
+      const name = currentQueryInput.length > 40 ? `${currentQueryInput.slice(0, 37)}...` : currentQueryInput;
       saveSearch(
         name,
         currentQueryInput,
@@ -5073,13 +5365,11 @@ ${notesBlock}`;
     statusBar.content = ` ${text}`;
     renderer.requestRender();
   });
-  if (config.theme !== void 0 || true) {
-    setTimeout(() => {
-      if (currentOverlay === "none") {
-        setStatus(nextTip());
-      }
-    }, 2e3);
-  }
+  setTimeout(() => {
+    if (currentOverlay === "none") {
+      setStatus(nextTip());
+    }
+  }, 2e3);
   function setStatus(msg) {
     statusMgr.set("idle", msg);
   }
@@ -5199,7 +5489,7 @@ ${notesBlock}`;
       if (idx >= 0) {
         const val = labelVals[idx];
         label = val >= 1e3 ? `${(val / 1e3).toFixed(1).replace(/\.0$/, "")}k` : String(val);
-        label = label.padStart(5) + " ";
+        label = `${label.padStart(5)} `;
       }
       lines.push(`${label}\u2506${chars.join("")}`);
     }
@@ -5633,7 +5923,8 @@ ${pack.description ?? ""}`;
         if (key.name === "d") {
           const sel = historySelect.getSelectedOption();
           if (sel?.value) {
-            deleteHistoryEntry(sel.value.index);
+            const idx = sel.value.index;
+            if (idx !== void 0) deleteHistoryEntry(idx);
             refreshHistory();
             setStatus("Deleted history entry");
           }
@@ -5652,6 +5943,7 @@ ${pack.description ?? ""}`;
           if (sel?.value) {
             const entry = sel.value.entry;
             showOverlay("none");
+            if (!entry) return;
             if (entry.mode === "trending") {
               if (entry.tab)
                 trendingTab = entry.tab;
@@ -5670,7 +5962,9 @@ ${pack.description ?? ""}`;
         if (key.name === "d") {
           const sel = bookmarksSelect.getSelectedOption();
           if (sel?.value) {
-            removeBookmark(sel.value.repo.fullName);
+            removeBookmark(
+              sel.value.repo?.fullName ?? ""
+            );
             refreshBookmarks();
             setStatus("Bookmark removed");
           }
@@ -5679,7 +5973,8 @@ ${pack.description ?? ""}`;
         }
         if (key.name === "enter" || key.name === "return") {
           const sel = bookmarksSelect.getSelectedOption();
-          if (sel?.value) openUrl(sel.value.repo.url);
+          if (sel?.value)
+            openUrl(sel.value.repo?.url ?? "");
           return;
         }
         return;
@@ -5688,7 +5983,7 @@ ${pack.description ?? ""}`;
         if (key.name === "d") {
           const sel = savedSelect.getSelectedOption();
           if (sel?.value) {
-            deleteSavedSearch(sel.value.name);
+            deleteSavedSearch(sel.value.name ?? "");
             refreshSavedSearches();
             setStatus("Saved search deleted");
           }
@@ -5723,7 +6018,7 @@ ${pack.description ?? ""}`;
           if (sel?.value) {
             const topic = sel.value;
             showOverlay("none");
-            searchInput.value = `topic:${topic.name}`;
+            searchInput.value = `topic:${topic.name ?? ""}`;
             showSearchMode();
             doSearch(`topic:${topic.name}`);
           }
@@ -5914,7 +6209,7 @@ ${pack.description ?? ""}`;
     }
     if (/^[1-5]$/.test(key.name)) {
       if (currentMode === "trending") {
-        const idx = parseInt(key.name) - 1;
+        const idx = parseInt(key.name, 10) - 1;
         if (idx >= 0 && idx < TAB_NAMES.length) {
           trendingTab = TAB_NAMES[idx];
           loadTrending();
@@ -5958,14 +6253,14 @@ ${pack.description ?? ""}`;
       return;
     }
   });
-  const currentVersion = getVersion();
-  if (!session || !session.mode) {
+  const _currentVersion = getVersion();
+  if (!session?.mode) {
     showLanding(true);
   }
   checkForUpdateAndShow();
   checkPostUpgradePanel();
   renderer.start();
-  if (session && session.mode) {
+  if (session?.mode) {
     if (currentMode === "trending") {
       loadTrending();
     } else {
@@ -6032,7 +6327,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 +6341,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 +6457,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 +6567,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 +6762,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 +6852,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;
@@ -6666,7 +6934,8 @@ async function processServerLine(line, state, config) {
   }
 }
 function writeStdout(line) {
-  process.stdout.write(line + "\n");
+  process.stdout.write(`${line}
+`);
 }
 async function runMcpServer(options = {}) {
   const state = {
@@ -6685,8 +6954,9 @@ async function runMcpServer(options = {}) {
   let buffer = "";
   process.stdin.on("data", (chunk) => {
     buffer += chunk;
-    let idx;
-    while ((idx = buffer.indexOf("\n")) >= 0) {
+    for (; ; ) {
+      const idx = buffer.indexOf("\n");
+      if (idx < 0) break;
       const line = buffer.slice(0, idx).trim();
       buffer = buffer.slice(idx + 1);
       if (!line) continue;
@@ -6744,7 +7014,7 @@ function parseArgs(args) {
     doctor: false,
     mcp: false
   };
-  let queryParts = [];
+  const queryParts = [];
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     switch (arg) {
@@ -6763,6 +7033,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;
@@ -6788,8 +7068,8 @@ function parseArgs(args) {
         flags.login = true;
         break;
       case "--limit": {
-        const parsed = parseInt(args[++i]);
-        if (isNaN(parsed) || parsed < 1 || parsed > 100) {
+        const parsed = parseInt(args[++i], 10);
+        if (Number.isNaN(parsed) || parsed < 1 || parsed > 100) {
           console.error(`Invalid limit: must be 1-100. Using default 50.`);
           flags.limit = 50;
         } else {
@@ -6824,6 +7104,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 +7180,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 +7206,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 +7259,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 +7271,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);
@@ -7010,7 +7309,12 @@ function printAgentSkill(name) {
 }
 async function runUserProfile(flags, outputFormat) {
   try {
-    const profile = await fetchUserProfile(flags.user, {
+    const user = flags.user ?? "";
+    if (!user) {
+      console.error("Usage: ghfind user <name> [--json] [--token <t>]");
+      process.exit(1);
+    }
+    const profile = await fetchUserProfile(user, {
       token: flags.token,
       limit: flags.limit
     });
@@ -7032,7 +7336,12 @@ async function runUserProfile(flags, outputFormat) {
 }
 async function runOrgProfile(flags, outputFormat) {
   try {
-    const profile = await fetchOrgProfile(flags.org, {
+    const org = flags.org ?? "";
+    if (!org) {
+      console.error("Usage: ghfind org <name> [--json] [--token <t>]");
+      process.exit(1);
+    }
+    const profile = await fetchOrgProfile(org, {
       token: flags.token,
       limit: flags.limit
     });
@@ -7052,6 +7361,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).`);
@@ -7142,9 +7472,18 @@ async function runReleases(flags, outputFormat) {
 }
 async function runNonInteractive(flags, outputFormat) {
   const handlers = {
-    trending: async (ctx2) => {
+    trending: async (_ctx) => {
       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 +7491,8 @@ async function runNonInteractive(flags, outputFormat) {
           sort: "stars",
           json: false,
           verbose: false,
-          trendingSince: since
+          trendingSince: since,
+          ...language ? { trendingLanguage: language } : {}
         }
       );
       if (outputFormat) {
@@ -7203,7 +7543,7 @@ async function runNonInteractive(flags, outputFormat) {
         token: flags.token
       });
       const repos = rankRepos(response.repos, flags.sort);
-      await pipeExec(repos, flags.pipe);
+      if (flags.pipe) await pipeExec(repos, flags.pipe);
     },
     format: async (ctx2) => {
       const response = await ctx2.provider.search(ctx2.parsed, {
@@ -7236,6 +7576,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 +7588,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";