github-search-cli 9.1.0 → 9.1.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.1.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",

package/src/cli.ts

@@ -1,6 +1,17 @@
-#!/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";
@@ -32,6 +43,9 @@ interface CLIFlags {
   init: boolean;
   version: boolean;
   help: boolean;
+  pkg: boolean;
+  theme?: string;
+  registry: string;
 }
 
 function parseArgs(args: string[]): CLIFlags {
@@ -51,6 +65,8 @@ function parseArgs(args: string[]): CLIFlags {
     init: false,
     version: false,
     help: false,
+    pkg: false,
+    registry: "npm",
   };
 
   let queryParts: string[] = [];
@@ -81,12 +97,17 @@ 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;
       default:
         if (!arg.startsWith("-")) queryParts.push(arg);
     }
   }
+  if (queryParts[0] === "pkg") {
+    flags.pkg = true;
+    queryParts.shift();
+  }
   flags.query = queryParts.join(" ");
   return flags;
 }
@@ -115,6 +136,8 @@ 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 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 +148,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 +180,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 +203,7 @@ Options:
     return;
   }
 
-  // Default: launch interactive TUI
-  await launchBrowser();
+  await launchBrowser(flags.theme);
 }
 
 interface SearchContext {
@@ -186,6 +221,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>> = {
@@ -262,7 +341,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,112 +1,142 @@
-/** 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 */
-  titleColor: string;
-  rows: HelpRow[];
-  note?: string;
-}
-
-export function buildHelpSections(): HelpSection[] {
-  return [
-    {
-      title: " Navigation ",
-      titleColor: "blue",
-      rows: [
-        { keys: "↑ ↓ / j k", action: "Move selection" },
-        { keys: "Enter", action: "Open repo in browser" },
-        { keys: "/", action: "Focus search input" },
-        { keys: "Space", action: "Open command menu" },
-        { keys: "? / Ctrl+H", action: "Toggle this help screen" },
-        { keys: "q", action: "Quit" },
-      ],
-    },
-    {
-      title: " Main View ",
-      titleColor: "green",
-      rows: [
-        { keys: "Tab", action: "Auto-complete qualifier" },
-        { keys: "PageDown", action: "Next page of results" },
-        { keys: "PageUp", action: "Scroll to top of results" },
-      ],
-    },
-    {
-      title: " Trending Mode ",
-      titleColor: "yellow",
-      rows: [
-        { keys: "1-5", action: "Switch tab: Today → Week → Month → …" },
-        { keys: "← → / h l", action: "Navigate tabs" },
-      ],
-    },
-    {
-      title: " Command Menu (Space)",
-      titleColor: "purple",
-      rows: [
-        { keys: "Sort", action: "Cycle sort: best-match → stars → …" },
-        { keys: "Limit", action: "Cycle limit: 10 → 25 → 50 → 100" },
-        { keys: "Refresh", action: "Re-run current search" },
-        { keys: "Graph", action: "Toggle commit activity chart" },
-        { keys: "Readme", action: "Full README viewer" },
-        { keys: "Deep-dive", action: "Languages + contributors + excerpt" },
-        { keys: "Bookmark", action: "Save / unsave selected repo" },
-        { keys: "Compare", action: "Add to / remove from comparison" },
-        { keys: "Trending", action: "Switch to trending browser" },
-      ],
-      note: "Also: Open, History, Export, Share, Topics, Saved, Notifs, Help",
-    },
-    {
-      title: " Overlay Keys ",
-      titleColor: "teal",
-      rows: [
-        { keys: "Esc / q", action: "Close any overlay" },
-        { keys: "Enter", action: "Confirm selection / run action" },
-        { keys: "d", action: "Delete entry (history, bookmarks, saved)" },
-        { keys: "↑ ↓ / j k", action: "Navigate overlay list" },
-      ],
-    },
-    {
-      title: " Search Syntax ",
-      titleColor: "teal",
-      rows: [
-        { keys: "keywords", action: "Free-text search" },
-        { keys: "key:value", action: "Qualifier filter" },
-        { keys: "-key:value", action: "Negated qualifier" },
-        { keys: '"phrase"', action: "Exact phrase match" },
-      ],
-    },
-    {
-      title: " Qualifiers ",
-      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" },
-      ],
-    },
-    {
-      title: " Rate Limits ",
-      titleColor: "orange",
-      rows: [
-        { keys: "No token", action: "10 req / min" },
-        { keys: "GITHUB_TOKEN", action: "30 req / min (or your plan limit)" },
-      ],
-      note: "Set GITHUB_TOKEN in your environment or add to config.",
-    },
-  ];
-}
-
-/** Column at which the action description starts (right-aligns keys). */
-export const HELP_KEYS_COLUMN = 24;
+/** 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 */
+  titleColor: string;
+  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",
+      rows: [
+        { keys: "↑ ↓ / j k", action: "Move selection" },
+        { keys: "Enter", action: "Open repo in browser" },
+        { keys: "/", action: "Focus search input" },
+        { keys: "Space", action: "Open command menu" },
+        { keys: "? / Ctrl+H", action: "Toggle this help screen" },
+        { keys: "q", action: "Quit" },
+      ],
+    },
+    {
+      title: " Main View ",
+      titleColor: "green",
+      rows: [
+        { keys: "Tab", action: "Auto-complete qualifier" },
+        { keys: "PageDown", action: "Next page of results" },
+        { keys: "PageUp", action: "Scroll to top of results" },
+      ],
+    },
+    {
+      title: " Trending Mode ",
+      titleColor: "yellow",
+      rows: [
+        { keys: "1-5", action: "Switch tab: Today → Week → Month → …" },
+        { 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",
+      rows: [
+        { keys: "Sort", action: "Cycle sort: best-match → stars → …" },
+        { keys: "Limit", action: "Cycle limit: 10 → 25 → 50 → 100" },
+        { keys: "Refresh", action: "Re-run current search" },
+        { keys: "Graph", action: "Toggle commit activity chart" },
+        { keys: "Readme", action: "Full README viewer" },
+        { keys: "Deep-dive", action: "Languages + contributors + excerpt" },
+        { 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: "Navigate menu with ↑ ↓, select with Enter, back with ← / Esc",
+    },
+    {
+      title: " Overlay Keys ",
+      titleColor: "teal",
+      rows: [
+        { keys: "Esc / q", action: "Close any overlay" },
+        { 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" },
+      ],
+    },
+    {
+      title: " Search Syntax ",
+      titleColor: "teal",
+      rows: [
+        { keys: "keywords", action: "Free-text search" },
+        { 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: " Utility Keys ",
+      titleColor: "muted",
+      rows: [
+        { 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" },
+      ],
+    },
+    {
+      title: " Rate Limits ",
+      titleColor: "orange",
+      rows: [
+        { keys: "No token", action: "10 req / min" },
+        { keys: "GITHUB_TOKEN", action: "30 req / min (or your plan limit)" },
+      ],
+      note: "Set GITHUB_TOKEN in your environment or add to config.",
+    },
+  ];
+}
+
+/** Column at which the action description starts (right-aligns keys). */
+export const HELP_KEYS_COLUMN = 24;

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",
   };