github-search-cli 9.1.0 → 9.2.1

package/dist/{config-DFL44OVL.js → config-GNZOQRTH.js}

@@ -4,7 +4,7 @@ import {
   loadConfig,
   saveConfig,
   stateDir
-} from "./chunk-TUMYR2IC.js";
+} from "./chunk-IVUU2KGR.js";
 export {
   cacheDir,
   configPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-search-cli",
-  "version": "9.1.0",
+  "version": "9.2.1",
   "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",
@@ -16,7 +16,6 @@
   "files": [
     "bin/",
     "dist/",
-    "vendor/",
     "src/",
     "scripts/",
     "completions/",
@@ -45,8 +44,7 @@
     "typescript": "^5.3.0"
   },
   "engines": {
-    "node": ">=20.0.0",
-    "bun": ">=1.0.0"
+    "node": ">=20.0.0"
   },
   "repository": {
     "type": "git",

package/scripts/postinstall.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 /**
- * Postinstall script — ensures a Bun binary is available for ghfind.
+ * Postinstall script — downloads a Bun binary for ghfind's TUI.
  *
- * 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.
+ * If vendor/bun or vendor/bun.exe already exists, this is a no-op.
+ * Otherwise, it downloads the correct Bun binary for the user's platform.
+ * On failure, prints a warning and exits 0 so npm install still succeeds.
  */
 import { existsSync, mkdirSync, chmodSync, writeFileSync } from "fs";
 import { join, dirname } from "path";
@@ -100,7 +100,10 @@ try {
 
   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);
+  console.warn(`[ghfind] ⚠ Could not download Bun: ${err instanceof Error ? err.message : String(err)}`);
+  console.warn("[ghfind] The interactive TUI requires Bun. Install it manually:");
+  console.warn("[ghfind]   curl -fsSL https://bun.sh/install | bash");
+  console.warn("[ghfind]   # or: npm install -g bun");
+  console.warn("[ghfind] Non-interactive modes (--json, --csv, etc.) will still work with Node.js 20+.");
+  process.exit(0);
 }

package/src/cli.ts

@@ -1,9 +1,22 @@
-#!/usr/bin/env node
-/** CLI entry point — routes between TUI browser and non-interactive modes. */
+// Prevent tui.ts auto-launch when imported from cli.ts
+process.env.GHFIND_CLI_RUN = "1";
 import { parseQuery, applyFlagFilters, rankRepos, createGitHubSearch, createTrendingSearch } from "./search";
+import {
+  createPackageSearch,
+  formatPackagesJson,
+  formatPackagesCsv,
+  formatPackagesMarkdown,
+  formatPackagesUrls,
+  formatPackagesNames,
+  sortPackages,
+  type PackageSortMode,
+} from "./package";
+import { launchPackageBrowser } from "./package-browser";
 import { format as formatOutput, exportToFile, pipeExec, type Format, type ExportFormat, type FormatLine } from "./output";
 import { runWatch } from "./watch";
 import { runInitWizard } from "./init";
+import { buildComparisonTable } from "./compare";
+import type { Repo } from "./types";
 import { readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
@@ -32,6 +45,10 @@ interface CLIFlags {
   init: boolean;
   version: boolean;
   help: boolean;
+  pkg: boolean;
+  theme?: string;
+  registry: string;
+  compare: string[];  // repo fullNames to compare
 }
 
 function parseArgs(args: string[]): CLIFlags {
@@ -51,6 +68,9 @@ function parseArgs(args: string[]): CLIFlags {
     init: false,
     version: false,
     help: false,
+    pkg: false,
+    registry: "npm",
+    compare: [],
   };
 
   let queryParts: string[] = [];
@@ -81,12 +101,26 @@ function parseArgs(args: string[]): CLIFlags {
       case "--since": flags.since = args[++i]; break;
       case "--pipe": flags.pipe = args[++i]; break;
       case "--format": flags.format = args[++i]; break;
-      case "--interval": flags.interval = parseInt(args[++i]) || 300; break;
+      case "--registry": flags.registry = args[++i] ?? "npm"; break;
+      case "--theme": flags.theme = args[++i] ?? "tokyo-night"; break;
       case "--completion": flags.completion = args[++i]; break;
+      case "--compare": {
+        // Collect repo names until next flag
+        const repos: string[] = [];
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          repos.push(args[++i]);
+        }
+        flags.compare = repos;
+        break;
+      }
       default:
         if (!arg.startsWith("-")) queryParts.push(arg);
     }
   }
+  if (queryParts[0] === "pkg") {
+    flags.pkg = true;
+    queryParts.shift();
+  }
   flags.query = queryParts.join(" ");
   return flags;
 }
@@ -115,6 +149,9 @@ 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 --compare <repo1> <repo2> Compare two+ repos side-by-side
+  ghfind pkg <query> --json         Search npm packages, output JSON
+  ghfind pkg <query>                Search npm packages, text list
   ghfind --watch <query>           Watch mode (poll every Ns)
   ghfind init                      Run setup wizard
   ghfind --completion <shell>      Print completion script (bash|zsh|fish)
@@ -125,11 +162,13 @@ Options:
   --json, --csv, --markdown, --count   Output format
   --limit <n>                          Max results (default: 50)
   --sort <strategy>                    Sort: best-match|stars|updated|forks
-  --token <token>                      GitHub API token
+  --theme <name>                     Theme: tokyo-night|premium-dark (default: tokyo-night)
   --trending                           Trending mode
   --since <period>                     Trending period: daily|weekly|monthly
   --pipe <target>                      Pipe target: clone|open
   --format <fmt>                       Line format: urls|names|ssh-urls|...
+  --registry <name>                  Registry for pkg: npm (default) | others TBD
+
   --watch                              Watch mode (re-run periodically)
   --interval <s>                       Watch interval in seconds (default: 300)
   --completion <shell>                 Generate completions
@@ -155,6 +194,17 @@ Options:
     await runInitWizard();
     return;
   }
+  // Package search (prototype, ticket 002-008)
+  if (flags.pkg) {
+    const interactive =
+      !flags.query && !flags.json && !flags.csv && !flags.markdown && !flags.count && !flags.format;
+    if (interactive) {
+      await launchPackageBrowser();
+    } else {
+      await runPackageSearch(flags);
+    }
+    return;
+  }
 
   // Determine output format
   const outputFormat: ExportFormat | undefined =
@@ -167,8 +217,7 @@ Options:
     return;
   }
 
-  // Default: launch interactive TUI
-  await launchBrowser();
+  await launchBrowser(flags.theme);
 }
 
 interface SearchContext {
@@ -186,6 +235,50 @@ function buildSearchContext(flags: CLIFlags): SearchContext {
   };
 }
 
+/** `ghfind pkg "<query>"` — npm package search. Pass-through query to the registry. */
+async function runPackageSearch(flags: CLIFlags): Promise<void> {
+  if (flags.registry !== "npm") {
+    console.error(`Registry "${flags.registry}" not yet supported (only npm).`);
+    process.exit(1);
+  }
+  const PKG_SORTS: PackageSortMode[] = ["best-match", "score", "downloads", "name"];
+  const pkgSort = flags.sort as PackageSortMode;
+  if (!PKG_SORTS.includes(pkgSort)) {
+    console.error(`Invalid sort for pkg: "${flags.sort}" (use best-match|score|downloads|name).`);
+    process.exit(1);
+  }
+  const search = createPackageSearch();
+  const query = flags.query.trim();
+  if (!query) {
+    console.error("Usage: ghfind pkg <query> [--json|--csv|--markdown|--count|--format urls|names] [--limit <n>]");
+    process.exit(1);
+  }
+  try {
+    const { totalCount, packages } = await search.searchPackage(query, flags.limit);
+    const sorted = sortPackages(packages, pkgSort);
+    if (flags.count) {
+      console.log(totalCount);
+    } else if (flags.json) {
+      console.log(formatPackagesJson(sorted));
+    } else if (flags.csv) {
+      console.log(formatPackagesCsv(sorted));
+    } else if (flags.markdown) {
+      console.log(formatPackagesMarkdown(sorted));
+    } else if (flags.format === "urls") {
+      console.log(formatPackagesUrls(sorted));
+    } else if (flags.format === "names") {
+      console.log(formatPackagesNames(sorted));
+    } else {
+      for (const p of sorted) {
+        console.log(`${p.name}@${p.version}  ↓ ${p.downloads.toLocaleString()}  ${p.score.toFixed(2)}  ${p.description ?? ""}`);
+      }
+    }
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+
 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>> = {
@@ -249,10 +342,23 @@ async function runNonInteractive(flags: CLIFlags, outputFormat?: ExportFormat) {
         console.log(formatOutput(repos, outputFormat));
       }
     },
+    compare: async (_ctx) => {
+      const search = createGitHubSearch(undefined, [flags.token ?? ""]);
+      const repos: Repo[] = [];
+      for (const fullName of flags.compare) {
+        const res = await search.search(
+          { keywords: [fullName], qualifiers: [], raw: fullName },
+          { limit: 1, sort: "stars", json: false, verbose: false, token: flags.token },
+        );
+        repos.push(...res.repos);
+      }
+      console.log(buildComparisonTable(repos));
+    },
   };
 
   // Determine which handler to run
-  const key = flags.trending && !flags.watch ? "trending"
+  const key = flags.compare.length > 0 ? "compare"
+    : flags.trending && !flags.watch ? "trending"
     : flags.watch ? "watch"
     : flags.pipe ? "pipe"
     : flags.format ? "format"
@@ -262,7 +368,10 @@ async function runNonInteractive(flags: CLIFlags, outputFormat?: ExportFormat) {
   await handlers[key](ctx);
 }
 
+
+
 main().catch((err) => {
+  console.error('DEBUG: uncaught error:', err.message || err);
   console.error(err instanceof Error ? err.message : String(err));
   process.exit(1);
 });

package/src/config.ts

@@ -27,7 +27,7 @@ export function cacheDir(): string {
 const DEFAULTS: Config = {
   defaultSort: "best-match",
   defaultLimit: 50,
-  theme: "premium-dark",  // New default: premium dark with sharp edges
+  theme: "tokyo-night",
   cacheTtlSeconds: 300,
   defaultTab: "search",
 };

package/src/help.ts

@@ -1,10 +1,8 @@
 /** Help screen — structured sections rendered by OpenTUI components. */
-
 export interface HelpRow {
   keys: string;
   action: string;
 }
-
 export interface HelpSection {
   title: string;
   /** Theme color key or hex — used for Box title color */
@@ -12,9 +10,18 @@ export interface HelpSection {
   rows: HelpRow[];
   note?: string;
 }
-
 export function buildHelpSections(): HelpSection[] {
   return [
+    {
+      title: " Landing ",
+      titleColor: "blue",
+      rows: [
+        { keys: "↑ ↓ / j k", action: "Navigate menu cards" },
+        { keys: "Enter", action: "Select mode" },
+        { keys: "? / h", action: "Toggle this help screen" },
+        { keys: "q", action: "Quit" },
+      ],
+    },
     {
       title: " Navigation ",
       titleColor: "blue",
@@ -44,6 +51,17 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "← → / h l", action: "Navigate tabs" },
       ],
     },
+    {
+      title: " Packages Mode ",
+      titleColor: "cyan",
+      rows: [
+        { keys: "/", action: "Search npm packages" },
+        { keys: "↑ ↓ / j k", action: "Move selection" },
+        { keys: "Enter", action: "View package details" },
+        { keys: "Space", action: "Open command menu" },
+      ],
+      note: "Search by name, description, or tags. Sort by downloads or score.",
+    },
     {
       title: " Command Menu (Space)",
       titleColor: "purple",
@@ -57,8 +75,16 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "Bookmark", action: "Save / unsave selected repo" },
         { keys: "Compare", action: "Add to / remove from comparison" },
         { keys: "Trending", action: "Switch to trending browser" },
+        { keys: "Packages", action: "Switch to npm packages" },
+        { keys: "Export", action: "Export results to file" },
+        { keys: "Share", action: "Share repo as text" },
+        { keys: "Topics", action: "Browse GitHub topics" },
+        { keys: "Saved", action: "View saved searches" },
+        { keys: "Notifs", action: "Check GitHub notifications" },
+        { keys: "History", action: "View search history" },
+        { keys: "Help", action: "Show this help screen" },
       ],
-      note: "Also: Open, History, Export, Share, Topics, Saved, Notifs, Help",
+      note: "Navigate menu with ↑ ↓, select with Enter, back with ← / Esc",
     },
     {
       title: " Overlay Keys ",
@@ -68,6 +94,7 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "Enter", action: "Confirm selection / run action" },
         { keys: "d", action: "Delete entry (history, bookmarks, saved)" },
         { keys: "↑ ↓ / j k", action: "Navigate overlay list" },
+        { keys: "← → / h l", action: "Navigate tabs / panels" },
       ],
     },
     {
@@ -78,22 +105,25 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "key:value", action: "Qualifier filter" },
         { keys: "-key:value", action: "Negated qualifier" },
         { keys: '"phrase"', action: "Exact phrase match" },
+        { keys: "language:TypeScript", action: "Filter by language" },
+        { keys: "stars:>1000", action: "Minimum stars" },
+        { keys: "fork:true", action: "Include forks" },
+        { keys: "user:octocat", action: "User's repos" },
+        { keys: "org:facebook", action: "Organization repos" },
+        { keys: "repo:facebook/react", action: "Specific repo" },
+        { keys: "topic:react", action: "Filter by topic" },
+        { keys: "license:mit", action: "License type" },
+        { keys: "pushed:>2024-01-01", action: "Last push date" },
+        { keys: "archived:false", action: "Exclude archived" },
       ],
     },
     {
-      title: " Qualifiers ",
+      title: " Utility Keys ",
       titleColor: "muted",
       rows: [
-        { keys: "language:", action: "Filter by language" },
-        { keys: "stars:>N", action: "Minimum stars" },
-        { keys: "fork:true", action: "Include forks" },
-        { keys: "user:", action: "User's repos" },
-        { keys: "org:", action: "Organization repos" },
-        { keys: "repo:", action: "Specific repo" },
-        { keys: "topic:", action: "Filter by topic" },
-        { keys: "license:", action: "License type" },
-        { keys: "pushed:>YYYY-MM-DD", action: "Last push date" },
-        { keys: "archived:false", action: "Exclude archived" },
+        { keys: "t", action: "Cycle theme (light / dark / solarized)" },
+        { keys: "Ctrl+X", action: "Copy repo URL to clipboard" },
+        { keys: "Ctrl+C", action: "Copy search query to clipboard" },
       ],
     },
     {

package/src/init.ts

@@ -40,7 +40,7 @@ export async function runInitWizard(): Promise<void> {
       ? sortStr
       : "best-match") as SortStrategy,
     defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr) || 50)),
-    theme: themes.includes(themeStr) ? themeStr : "tokyo-night",
+    theme: themes.includes(themeStr) ? themeStr : themes[0],
     cacheTtlSeconds: 300,
     defaultTab: "search",
   };