github-search-cli 0.8.2 → 9.1.0

package/dist/config-DFL44OVL.js

@@ -0,0 +1,14 @@
+import {
+  cacheDir,
+  configPath,
+  loadConfig,
+  saveConfig,
+  stateDir
+} from "./chunk-TUMYR2IC.js";
+export {
+  cacheDir,
+  configPath,
+  loadConfig,
+  saveConfig,
+  stateDir
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-search-cli",
-  "version": "0.8.2",
+  "version": "9.1.0",
   "description": "Terminal-native GitHub search — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
   "type": "module",
   "packageManager": "bun@1",
@@ -15,6 +15,8 @@
   },
   "files": [
     "bin/",
+    "dist/",
+    "vendor/",
     "src/",
     "scripts/",
     "completions/",

package/scripts/postinstall.js

@@ -1,106 +1,106 @@
-#!/usr/bin/env node
-/**
- * Postinstall script — ensures a Bun binary is available for ghfind.
- *
- * If vendor/bun or vendor/bun.exe already exists (bundled with the package),
- * this is a no-op. Otherwise, it attempts to download the correct binary
- * for the user's platform.
- */
-import { existsSync, mkdirSync, chmodSync, writeFileSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { platform, arch } from "os";
-import { inflateRawSync } from "zlib";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, "..");
-const VENDOR_DIR = join(ROOT, "vendor");
-
-const bunName = platform() === "win32" ? "bun.exe" : "bun";
-const bunPath = join(VENDOR_DIR, bunName);
-
-// Already bundled — nothing to do
-if (existsSync(bunPath)) {
-  process.exit(0);
-}
-
-// Skip in CI/test environments
-if (process.env.GHFIND_SKIP_BUN === "1" || process.env.CI === "true") {
-  process.exit(0);
-}
-
-// Try to download
-const map = {
-  "win32-x64": "bun-windows-x64.zip",
-  "win32-arm64": "bun-windows-aarch64.zip",
-  "darwin-x64": "bun-darwin-x64.zip",
-  "darwin-arm64": "bun-darwin-aarch64.zip",
-  "linux-x64": "bun-linux-x64-musl.zip",
-  "linux-arm64": "bun-linux-aarch64-musl.zip",
-};
-
-const key = `${platform()}-${arch}`;
-const assetName = map[key];
-const version = "1.3.12";
-
-if (!assetName) {
-  console.error(`[ghfind] Unsupported platform: ${key}. Install Bun manually: https://bun.sh`);
-  process.exit(0);
-}
-
-const url = `https://github.com/oven-sh/bun/releases/download/bun-v${version}/${assetName}`;
-
-try {
-  mkdirSync(VENDOR_DIR, { recursive: true });
-  console.error(`[ghfind] Downloading Bun ${version} for ${key}...`);
-
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`HTTP ${res.status}`);
-
-  const buffer = Buffer.from(await res.arrayBuffer());
-
-  // Find the central directory file header signature (PK\x01\x02)
-  const cdSig = "PK\x01\x02";
-  let cdOffset = buffer.indexOf(cdSig, 0);
-  while (cdOffset !== -1) {
-    const nameLen = buffer.readUInt16LE(cdOffset + 28);
-    const extraLen = buffer.readUInt16LE(cdOffset + 30);
-    const commentLen = buffer.readUInt16LE(cdOffset + 32);
-    const localHeaderOffset = buffer.readUInt32LE(cdOffset + 42);
-    const compSize = buffer.readUInt32LE(cdOffset + 20);
-    const compMethod = buffer.readUInt16LE(cdOffset + 10);
-    const nameStart = cdOffset + 46;
-    const fileName = buffer.subarray(nameStart, nameStart + nameLen).toString("utf8");
-
-    if (fileName.endsWith(bunName)) {
-      // Read the local file header to get the actual data offset
-      const localSig = buffer.readUInt32LE(localHeaderOffset);
-      if (localSig !== 0x04034b50) throw new Error("Invalid local file header");
-      const localNameLen = buffer.readUInt16LE(localHeaderOffset + 26);
-      const localExtraLen = buffer.readUInt16LE(localHeaderOffset + 28);
-      const dataOffset = localHeaderOffset + 30 + localNameLen + localExtraLen;
-
-      let fileData;
-      if (compMethod === 0) {
-        // Stored (no compression)
-        fileData = buffer.subarray(dataOffset, dataOffset + compSize);
-      } else {
-        // Deflated
-        fileData = inflateRawSync(buffer.subarray(dataOffset, dataOffset + compSize));
-      }
-
-      writeFileSync(bunPath, fileData);
-      if (platform() !== "win32") chmodSync(bunPath, 0o755);
-      console.error(`[ghfind] Bun installed to vendor/${bunName}`);
-      process.exit(0);
-    }
-
-    cdOffset = buffer.indexOf(cdSig, cdOffset + 4);
-  }
-
-  throw new Error("Bun binary not found in archive");
-} catch (err) {
-  console.error(`[ghfind] Failed to download Bun: ${err instanceof Error ? err.message : String(err)}`);
-  console.error("[ghfind] Install Bun manually: https://bun.sh/docs/install");
-  process.exit(0);
-}
+#!/usr/bin/env node
+/**
+ * Postinstall script — ensures a Bun binary is available for ghfind.
+ *
+ * If vendor/bun or vendor/bun.exe already exists (bundled with the package),
+ * this is a no-op. Otherwise, it attempts to download the correct binary
+ * for the user's platform.
+ */
+import { existsSync, mkdirSync, chmodSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { platform, arch } from "os";
+import { inflateRawSync } from "zlib";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+const VENDOR_DIR = join(ROOT, "vendor");
+
+const bunName = platform() === "win32" ? "bun.exe" : "bun";
+const bunPath = join(VENDOR_DIR, bunName);
+
+// Already bundled — nothing to do
+if (existsSync(bunPath)) {
+  process.exit(0);
+}
+
+// Skip in CI/test environments
+if (process.env.GHFIND_SKIP_BUN === "1" || process.env.CI === "true") {
+  process.exit(0);
+}
+
+// Try to download
+const map = {
+  "win32-x64": "bun-windows-x64.zip",
+  "win32-arm64": "bun-windows-aarch64.zip",
+  "darwin-x64": "bun-darwin-x64.zip",
+  "darwin-arm64": "bun-darwin-aarch64.zip",
+  "linux-x64": "bun-linux-x64-musl.zip",
+  "linux-arm64": "bun-linux-aarch64-musl.zip",
+};
+
+const key = `${platform()}-${arch}`;
+const assetName = map[key];
+const version = "1.3.14";
+
+if (!assetName) {
+  console.error(`[ghfind] Unsupported platform: ${key}. Install Bun manually: https://bun.sh`);
+  process.exit(0);
+}
+
+const url = `https://github.com/oven-sh/bun/releases/download/bun-v${version}/${assetName}`;
+
+try {
+  mkdirSync(VENDOR_DIR, { recursive: true });
+  console.error(`[ghfind] Downloading Bun ${version} for ${key}...`);
+
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+
+  const buffer = Buffer.from(await res.arrayBuffer());
+
+  // Find the central directory file header signature (PK\x01\x02)
+  const cdSig = "PK\x01\x02";
+  let cdOffset = buffer.indexOf(cdSig, 0);
+  while (cdOffset !== -1) {
+    const nameLen = buffer.readUInt16LE(cdOffset + 28);
+    const extraLen = buffer.readUInt16LE(cdOffset + 30);
+    const commentLen = buffer.readUInt16LE(cdOffset + 32);
+    const localHeaderOffset = buffer.readUInt32LE(cdOffset + 42);
+    const compSize = buffer.readUInt32LE(cdOffset + 20);
+    const compMethod = buffer.readUInt16LE(cdOffset + 10);
+    const nameStart = cdOffset + 46;
+    const fileName = buffer.subarray(nameStart, nameStart + nameLen).toString("utf8");
+
+    if (fileName.endsWith(bunName)) {
+      // Read the local file header to get the actual data offset
+      const localSig = buffer.readUInt32LE(localHeaderOffset);
+      if (localSig !== 0x04034b50) throw new Error("Invalid local file header");
+      const localNameLen = buffer.readUInt16LE(localHeaderOffset + 26);
+      const localExtraLen = buffer.readUInt16LE(localHeaderOffset + 28);
+      const dataOffset = localHeaderOffset + 30 + localNameLen + localExtraLen;
+
+      let fileData;
+      if (compMethod === 0) {
+        // Stored (no compression)
+        fileData = buffer.subarray(dataOffset, dataOffset + compSize);
+      } else {
+        // Deflated
+        fileData = inflateRawSync(buffer.subarray(dataOffset, dataOffset + compSize));
+      }
+
+      writeFileSync(bunPath, fileData);
+      if (platform() !== "win32") chmodSync(bunPath, 0o755);
+      console.error(`[ghfind] Bun installed to vendor/${bunName}`);
+      process.exit(0);
+    }
+
+    cdOffset = buffer.indexOf(cdSig, cdOffset + 4);
+  }
+
+  throw new Error("Bun binary not found in archive");
+} catch (err) {
+  console.error(`[ghfind] Failed to download Bun: ${err instanceof Error ? err.message : String(err)}`);
+  console.error("[ghfind] Install Bun manually: https://bun.sh/docs/install");
+  process.exit(1);
+}

package/src/bookmarks.ts

@@ -1,30 +1,17 @@
 /**
  * Bookmarks — saved repos with tags, persisted as JSON.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
 import type { Bookmark, Repo } from "./types";
-import { stateDir } from "./config";
+import { readJSON, writeJSON } from "./storage";
 
-const BOOKMARK_FILE = join(stateDir(), "bookmarks.json");
-
-function ensureDir() {
-  mkdirSync(stateDir(), { recursive: true });
-}
+const BOOKMARK_FILE = "bookmarks.json";
 
 function loadRaw(): Bookmark[] {
-  ensureDir();
-  try {
-    const raw = readFileSync(BOOKMARK_FILE, "utf-8");
-    return JSON.parse(raw) as Bookmark[];
-  } catch {
-    return [];
-  }
+  return readJSON<Bookmark[]>(BOOKMARK_FILE, []);
 }
 
 function saveRaw(bookmarks: Bookmark[]): void {
-  ensureDir();
-  writeFileSync(BOOKMARK_FILE, JSON.stringify(bookmarks, null, 2));
+  writeJSON(BOOKMARK_FILE, bookmarks);
 }
 
 /** Get all bookmarks, newest first. */

package/src/cli.ts

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
 /** CLI entry point — routes between TUI browser and non-interactive modes. */
-import { parseQuery, applyFlagFilters, rankRepos, createGitHubSearch } from "./search";
-import { formatRepos, type ExportFormat } from "./export";
-import { formatLines, pipeExec, type FormatLine } from "./pipe";
+import { parseQuery, applyFlagFilters, rankRepos, createGitHubSearch, createTrendingSearch } from "./search";
+import { format as formatOutput, exportToFile, pipeExec, type Format, type ExportFormat, type FormatLine } from "./output";
 import { runWatch } from "./watch";
 import { runInitWizard } from "./init";
 import { readFileSync } from "fs";
@@ -158,13 +157,13 @@ Options:
   }
 
   // Determine output format
-  const format: ExportFormat | undefined =
+  const outputFormat: ExportFormat | undefined =
     flags.json ? "json" : flags.csv ? "csv" : flags.markdown ? "markdown" : undefined;
-  const isNonInteractive = format || flags.count || flags.format || flags.pipe || flags.watch;
+  const isNonInteractive = outputFormat || flags.count || flags.format || flags.pipe || flags.watch;
 
   // Non-interactive mode
   if (isNonInteractive) {
-    await runNonInteractive(flags, format);
+    await runNonInteractive(flags, outputFormat);
     return;
   }
 
@@ -172,65 +171,95 @@ Options:
   await launchBrowser();
 }
 
-async function runNonInteractive(flags: CLIFlags, format?: ExportFormat) {
-  const query = flags.query;
-  const provider = createGitHubSearch(undefined, flags.token ? [flags.token] : []);
-
-  // --watch mode
-  if (flags.watch) {
-    let tick = 0;
-    await runWatch(
-      { query, sort: flags.sort, limit: flags.limit, token: flags.token, intervalMs: flags.interval * 1000, trending: flags.trending },
-      (repos, delta) => {
-        tick++;
-        if (format) {
-          console.log(`[Watch #${tick}] ${repos.length} results (${delta >= 0 ? "+" : ""}${delta} since last check)`);
-          console.log(formatRepos(repos, format));
-        } else {
-          console.log(`[Watch #${tick}] ${repos.length} results — ${delta >= 0 ? "+" : ""}${delta} since last check`);
-        }
-      },
-      (err) => console.error(`[Watch error] ${err.message}`),
-    );
-    return;
-  }
-
-  // --pipe mode
-  if (flags.pipe) {
-    const parsed = applyFlagFilters(parseQuery(query), {});
-    const response = await provider.search(parsed, { limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token });
-    const repos = rankRepos(response.repos, flags.sort);
-    await pipeExec(repos, flags.pipe);
-    return;
-  }
+interface SearchContext {
+  query: string;
+  parsed: ReturnType<typeof parseQuery> & { raw: string };
+  provider: ReturnType<typeof createGitHubSearch>;
+}
 
-  // --format mode
-  if (flags.format) {
-    const parsed = applyFlagFilters(parseQuery(query), {});
-    const response = await provider.search(parsed, { limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token });
-    const repos = rankRepos(response.repos, flags.sort);
-    console.log(formatLines(repos, flags.format as FormatLine));
-    return;
-  }
+function buildSearchContext(flags: CLIFlags): SearchContext {
+  const parsed = applyFlagFilters(parseQuery(flags.query), {});
+  return {
+    query: flags.query,
+    parsed,
+    provider: createGitHubSearch(undefined, flags.token ? [flags.token] : []),
+  };
+}
 
-  // Standard search with format
-  const parsed = applyFlagFilters(parseQuery(query), {});
-  const response = await provider.search(parsed, {
-    limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token,
-  });
-  const repos = rankRepos(response.repos, flags.sort);
+async function runNonInteractive(flags: CLIFlags, outputFormat?: ExportFormat) {
+  // Dispatch table: each handler receives shared context + flags, returns void.
+  const handlers: Record<string, (ctx: SearchContext) => Promise<void>> = {
+    trending: async (ctx) => {
+      const since = flags.since === "weekly" ? "weekly" : flags.since === "monthly" ? "monthly" : "daily";
+      const trendingSearch = createTrendingSearch();
+      const response = await trendingSearch.search(
+        { keywords: [], qualifiers: [], raw: "trending" },
+        { limit: 25, sort: "stars", json: false, verbose: false, trendingSince: since },
+      );
+      if (outputFormat) {
+        console.log(formatOutput(response.repos, outputFormat));
+      } else if (flags.count) {
+        console.log(response.totalCount);
+      } else {
+        for (const r of response.repos) {
+          console.log(r.fullName + "  ★ " + r.stars + "  ▲ +" + r.score + " " + since + "  ● " + (r.language ?? ""));
+        }
+      }
+    },
+    watch: async (ctx) => {
+      let tick = 0;
+      await runWatch(
+        { query: ctx.query, sort: flags.sort, limit: flags.limit, token: flags.token, intervalMs: flags.interval * 1000, trending: flags.trending },
+        (repos, delta) => {
+          tick++;
+          if (outputFormat) {
+            console.log(`[Watch #${tick}] ${repos.length} results (${delta >= 0 ? "+" : ""}${delta} since last check)`);
+            console.log(formatOutput(repos, outputFormat));
+          } else {
+            console.log(`[Watch #${tick}] ${repos.length} results — ${delta >= 0 ? "+" : ""}${delta} since last check`);
+          }
+        },
+        (err) => console.error(`[Watch error] ${err.message}`),
+      );
+    },
+    pipe: async (ctx) => {
+      const response = await ctx.provider.search(ctx.parsed, {
+        limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token,
+      });
+      const repos = rankRepos(response.repos, flags.sort);
+      await pipeExec(repos, flags.pipe!);
+    },
+    format: async (ctx) => {
+      const response = await ctx.provider.search(ctx.parsed, {
+        limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token,
+      });
+      const repos = rankRepos(response.repos, flags.sort);
+      console.log(formatOutput(repos, flags.format as Format));
+    },
+    search: async (ctx) => {
+      const response = await ctx.provider.search(ctx.parsed, {
+        limit: flags.limit, sort: flags.sort, json: false, verbose: false, token: flags.token,
+      });
+      const repos = rankRepos(response.repos, flags.sort);
+      if (flags.count) {
+        console.log(response.totalCount);
+        return;
+      }
+      if (outputFormat) {
+        console.log(formatOutput(repos, outputFormat));
+      }
+    },
+  };
 
-  // --count
-  if (flags.count) {
-    console.log(response.totalCount);
-    return;
-  }
+  // Determine which handler to run
+  const key = flags.trending && !flags.watch ? "trending"
+    : flags.watch ? "watch"
+    : flags.pipe ? "pipe"
+    : flags.format ? "format"
+    : "search";
 
-  // --json, --csv, --markdown
-  if (format) {
-    console.log(formatRepos(repos, format));
-    return;
-  }
+  const ctx = buildSearchContext(flags);
+  await handlers[key](ctx);
 }
 
 main().catch((err) => {

package/src/config.ts

@@ -9,7 +9,7 @@
 import type { Config } from "./types";
 import { homedir } from "os";
 import { join } from "path";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
 
 /** Directory for persistent state (history, bookmarks, session). */
 export function stateDir(): string {
@@ -27,7 +27,7 @@ export function cacheDir(): string {
 const DEFAULTS: Config = {
   defaultSort: "best-match",
   defaultLimit: 50,
-  theme: "tokyo-night",
+  theme: "premium-dark",  // New default: premium dark with sharp edges
   cacheTtlSeconds: 300,
   defaultTab: "search",
 };

package/src/history.ts

@@ -1,53 +1,30 @@
 /**
  * Persistent search history — append-only JSONL with rotation.
  */
-import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, unlinkSync } from "fs";
-import { join } from "path";
 import type { HistoryEntry } from "./types";
-import { stateDir } from "./config";
+import { readJSONL, appendJSONL, writeJSON, writeRaw } from "./storage";
 
-const HISTORY_FILE = join(stateDir(), "history.jsonl");
+const HISTORY_FILE = "history.jsonl";
 const MAX_ENTRIES = 500;
 
-function ensureDir() {
-  mkdirSync(stateDir(), { recursive: true });
-}
-
 /** Append one entry to the history log. */
 export function appendHistory(entry: HistoryEntry): void {
-  ensureDir();
-  const line = JSON.stringify(entry) + "\n";
-  try {
-    appendFileSync(HISTORY_FILE, line, "utf-8");
-  } catch {
-    // non-critical
-  }
+  appendJSONL(HISTORY_FILE, entry);
 }
 
 /** Read all history entries, newest first, deduplicating consecutive identical queries. */
 export function readHistory(): HistoryEntry[] {
-  try {
-    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
-    if (!raw) return [];
-    const lines = raw.split("\n").filter(Boolean);
-    const entries: HistoryEntry[] = lines.map((l) => JSON.parse(l) as HistoryEntry);
-
-    // Sorted oldest-first in file; reverse to newest-first
-    entries.reverse();
-
-    // Deduplicate consecutive identical queries (keep newest)
-    const deduped: HistoryEntry[] = [];
-    let lastQuery: string | undefined;
-    for (const e of entries) {
-      if (e.query !== lastQuery) {
-        deduped.push(e);
-        lastQuery = e.query;
-      }
+  const entries = readJSONL<HistoryEntry>(HISTORY_FILE);
+  entries.reverse();
+  const deduped: HistoryEntry[] = [];
+  let lastQuery: string | undefined;
+  for (const e of entries) {
+    if (e.query !== lastQuery) {
+      deduped.push(e);
+      lastQuery = e.query;
     }
-    return deduped;
-  } catch {
-    return [];
   }
+  return deduped;
 }
 
 /** Delete a single history entry by index (0 = newest). */
@@ -55,20 +32,13 @@ export function deleteHistoryEntry(index: number): void {
   const entries = readHistory();
   if (index < 0 || index >= entries.length) return;
   const removed = entries[index];
-  // Rewrite file without the removed entry
   const remaining = entries.filter((e) => e.timestamp !== removed.timestamp || e.query !== removed.query);
-  ensureDir();
-  // Reverse back to oldest-first for file order
-  writeFileSync(HISTORY_FILE, remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
+  writeRaw(HISTORY_FILE, remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
 }
 
 /** Clear all history. */
 export function clearHistory(): void {
-  try {
-    writeFileSync(HISTORY_FILE, "");
-  } catch {
-    // non-critical
-  }
+  writeRaw(HISTORY_FILE, "");
 }
 
 /** Rotate history to max entries (trim oldest). */
@@ -76,16 +46,10 @@ export function rotateHistory(): void {
   const entries = readHistory();
   if (entries.length <= MAX_ENTRIES) return;
   const trimmed = entries.slice(0, MAX_ENTRIES);
-  ensureDir();
-  writeFileSync(HISTORY_FILE, trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
+  writeRaw(HISTORY_FILE, trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
 }
 
 /** Count entries in history file. */
 export function historyCount(): number {
-  try {
-    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
-    return raw ? raw.split("\n").length : 0;
-  } catch {
-    return 0;
-  }
+  return readJSONL<HistoryEntry>(HISTORY_FILE).length;
 }

package/src/notifications.ts

@@ -1,7 +1,5 @@
 /** Notification center — ephemeral alerts for rate limits, watch changes, etc. */
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-import { stateDir } from "./config";
+import { readJSON, writeJSON } from "./storage";
 
 export interface Notification {
   id: number;
@@ -14,20 +12,15 @@ export interface Notification {
 let nextId = 1;
 let notifs: Notification[] = [];
 const MAX_NOTIFS = 50;
-const FILE = join(stateDir(), "notifications.json");
+const FILE = "notifications.json";
 
 function load(): void {
-  try {
-    notifs = JSON.parse(readFileSync(FILE, "utf-8"));
-    nextId = (Math.max(...notifs.map((n) => n.id), 0) + 1);
-  } catch {
-    notifs = [];
-  }
+  notifs = readJSON<Notification[]>(FILE, []);
+  nextId = Math.max(...notifs.map((n) => n.id), 0) + 1;
 }
 
 function save(): void {
-  mkdirSync(stateDir(), { recursive: true });
-  writeFileSync(FILE, JSON.stringify(notifs));
+  writeJSON(FILE, notifs);
 }
 
 export function addNotification(type: Notification["type"], message: string): Notification {