github-search-cli 0.7.0 → 0.8.1

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "github-search-cli",
-  "version": "0.7.0",
-  "description": "Terminal-native GitHub browser — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
+  "version": "0.8.1",
+  "description": "Terminal-native GitHub search — search, trending, bookmarks, history, deep-dive, compare, export, and more. All keyboard-driven, no browser needed.",
   "type": "module",
   "bin": {
-    "search-cli": "bin/search-cli.js"
+    "ghfind": "bin/ghfind.js"
   },
   "files": [
     "bin/",
     "src/",
+    "vendor/",
     "completions/",
     "demo.svg",
     "LICENSE",
@@ -16,19 +17,29 @@
   ],
   "scripts": {
     "start": "bun run src/cli.ts",
-    "build": "bun run scripts/build.ts",
-    "prepublishOnly": "bun run build",
-    "test": "bun test",
-    "dev": "bun run --watch src/tui.ts"
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:bun": "bun test",
+    "dev": "bun run --watch src/tui.ts",
+    "postinstall": "node scripts/postinstall.js",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
   },
   "dependencies": {
     "@opentui/core": "^0.4.3"
   },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "@types/node": "^20.0.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
   },
   "engines": {
-    "bun": ">=1.0"
+    "node": ">=20.0.0"
   },
   "repository": {
     "type": "git",

package/src/bookmarks.ts

@@ -3,8 +3,8 @@
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
-import type { Bookmark, Repo } from "./types.ts";
-import { stateDir } from "./config.ts";
+import type { Bookmark, Repo } from "./types";
+import { stateDir } from "./config";
 
 const BOOKMARK_FILE = join(stateDir(), "bookmarks.json");
 

package/src/cli.ts

@@ -1,31 +1,18 @@
-#!/usr/bin/env bun
-/**
- * CLI entry point — routes between TUI browser and non-interactive modes.
- *
- * Usage:
- *   search-cli                    Launch interactive TUI
- *   search-cli "query" --json     Search + JSON output
- *   search-cli "query" --csv      Search + CSV output
- *   search-cli "query" --markdown Search + Markdown table
- *   search-cli "query" --count    Just the result count
- *   search-cli --trending --json  Trending repos as JSON
- *   search-cli init               Setup wizard
- *   search-cli --watch "query"    Periodic watch mode
- *   search-cli --completion bash  Print shell completion
- *   search-cli --version          Print version
- *   search-cli --help             Print help
- */
-import { parseQuery, applyFlagFilters } from "./query.ts";
-import { GitHubSearchProvider } from "./provider.ts";
-import { rankRepos } from "./ranking.ts";
-import { formatRepos, type ExportFormat } from "./export.ts";
-import { formatLines, pipeExec, type FormatLine } from "./pipe.ts";
-import { runWatch } from "./watch.ts";
-import { runInitWizard } from "./init.ts";
+#!/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 { runWatch } from "./watch";
+import { runInitWizard } from "./init";
 import { readFileSync } from "fs";
-import { join } from "path";
-import { launchBrowser } from "./tui.ts";
-import type { SearchOptions } from "./types.ts";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { launchBrowser } from "./tui";
+import type { SearchOptions } from "./types";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_DIR = join(__dirname, "..");
 
 interface CLIFlags {
   query: string;
@@ -110,30 +97,30 @@ async function main() {
 
   // Version
   if (flags.version) {
-    const pkg = JSON.parse(readFileSync(join(import.meta.dir!, "..", "package.json"), "utf-8"));
-    console.log(`search-cli v${pkg.version}`);
+    const pkg = JSON.parse(readFileSync(join(PKG_DIR, "package.json"), "utf-8"));
+    console.log(`ghfind v${pkg.version}`);
     return;
   }
 
   // Help
   if (flags.help) {
     console.log(`
-search-cli — Interactive GitHub repository browser
+ghfind — Interactive GitHub repository browser
 
 Usage:
-  search-cli                           Launch interactive TUI
-  search-cli <query> --json            Search, output JSON
-  search-cli <query> --csv             Search, output CSV
-  search-cli <query> --markdown        Search, output Markdown table
-  search-cli <query> --count           Just the result count
-  search-cli <query> --format <fmt>    Format lines (urls|names|ssh-urls|clone-commands|ids)
-  search-cli <query> --pipe <target>   Pipe to clone/open
-  search-cli --trending --json         Trending repos as JSON
-  search-cli --watch <query>           Watch mode (poll every Ns)
-  search-cli init                      Run setup wizard
-  search-cli --completion <shell>      Print completion script (bash|zsh|fish)
-  search-cli --version                 Print version
-  search-cli --help                    Print this help
+  ghfind                           Launch interactive TUI
+  ghfind <query> --json            Search, output JSON
+  ghfind <query> --csv             Search, output CSV
+  ghfind <query> --markdown        Search, output Markdown table
+  ghfind <query> --count           Just the result count
+  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 --watch <query>           Watch mode (poll every Ns)
+  ghfind init                      Run setup wizard
+  ghfind --completion <shell>      Print completion script (bash|zsh|fish)
+  ghfind --version                 Print version
+  ghfind --help                    Print this help
 
 Options:
   --json, --csv, --markdown, --count   Output format
@@ -155,7 +142,7 @@ Options:
   if (flags.completion) {
     const shell = flags.completion;
     try {
-      const content = readFileSync(join(import.meta.dir!, "..", "completions", `search-cli.${shell}`), "utf-8");
+      const content = readFileSync(join(PKG_DIR, "completions", `ghfind.${shell}`), "utf-8");
       console.log(content);
     } catch {
       console.error(`Completions not available for shell: ${shell}`);
@@ -187,7 +174,7 @@ Options:
 
 async function runNonInteractive(flags: CLIFlags, format?: ExportFormat) {
   const query = flags.query;
-  const provider = new GitHubSearchProvider(undefined, flags.token ? [flags.token] : []);
+  const provider = createGitHubSearch(undefined, flags.token ? [flags.token] : []);
 
   // --watch mode
   if (flags.watch) {

package/src/compare.ts

@@ -1,7 +1,7 @@
 /**
  * Repo comparison — side-by-side table for 2+ repos.
  */
-import type { Repo } from "./types.ts";
+import type { Repo } from "./types";
 
 interface CompareRow {
   label: string;

package/src/config.ts

@@ -2,11 +2,11 @@
  * Config system: load/save config from XDG paths, merge with env vars.
  * 
  * Lookup order:
- *   1. SEARCH_CLI_CONFIG env var
- *   2. $XDG_CONFIG_HOME/search-cli/config.json
- *   3. ~/.config/search-cli/config.json
+ *   1. GHFIND_CONFIG env var
+ *   2. $XDG_CONFIG_HOME/ghfind/config.json
+ *   3. ~/.config/ghfind/config.json
  */
-import type { Config } from "./types.ts";
+import type { Config } from "./types";
 import { homedir } from "os";
 import { join } from "path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -14,14 +14,14 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 /** Directory for persistent state (history, bookmarks, session). */
 export function stateDir(): string {
   const xdg = process.env.XDG_STATE_HOME;
-  const base = xdg ? join(xdg, "search-cli") : join(homedir(), ".local", "share", "search-cli");
+  const base = xdg ? join(xdg, "ghfind") : join(homedir(), ".local", "share", "ghfind");
   return base;
 }
 
 /** Directory for cache files. */
 export function cacheDir(): string {
   const xdg = process.env.XDG_CACHE_HOME;
-  const base = xdg ? join(xdg, "search-cli") : join(homedir(), ".cache", "search-cli");
+  const base = xdg ? join(xdg, "ghfind") : join(homedir(), ".cache", "ghfind");
   return base;
 }
 const DEFAULTS: Config = {
@@ -33,11 +33,11 @@ const DEFAULTS: Config = {
 };
 
 export function configPath(): string {
-  const envPath = process.env.SEARCH_CLI_CONFIG;
+  const envPath = process.env.GHFIND_CONFIG;
   if (envPath) return envPath;
 
   const xdg = process.env.XDG_CONFIG_HOME;
-  const base = xdg ? join(xdg, "search-cli") : join(homedir(), ".config", "search-cli");
+  const base = xdg ? join(xdg, "ghfind") : join(homedir(), ".config", "ghfind");
   return join(base, "config.json");
 }
 

package/src/deepdive.ts

@@ -1,14 +1,8 @@
-/**
- * Repo deep-dive — fetch and format rich repo details.
- * 
- * ponytail: single fetch-all function, no section tab navigation.
- * Shows: summary, languages bar, top contributors, README excerpt.
- * Skip: releases (YAGNI), dependency graph (auth-gated).
- */
-import type { Repo } from "./types.ts";
-import { NetworkError } from "./errors.ts";
+/** Repo deep-dive — fetch and format rich repo details. */
+import type { Repo } from "./types";
+import { NetworkError } from "./errors";
 
-const USER_AGENT = "search-cli/1.0";
+const USER_AGENT = "ghfind/1.0";
 
 /** Language breakdown: { [lang]: bytes } */
 type LanguageMap = Record<string, number>;

package/src/errors.ts

@@ -1,7 +1,4 @@
-/**
- * Structured error types with user-facing messages.
- * Every error knows what to tell the user and (optionally) what to do next.
- */
+/** Structured error types with user-facing messages. */
 
 export class SearchCliError extends Error {
   constructor(

package/src/explore.ts

@@ -1,7 +1,6 @@
 /**
  * Topic explorer — browse popular GitHub topics.
  * 
- * ponytail: fetch flat topic list via search API, no hierarchy.
  * Selecting a topic triggers a search.
  */
 export interface TopicItem {

package/src/export.ts

@@ -2,11 +2,10 @@
  * Export — format repos as JSON, CSV, Markdown, or plain text.
  */
 import { writeFileSync } from "fs";
-import type { Repo } from "./types.ts";
+import type { Repo } from "./types";
 
 export type ExportFormat = "json" | "csv" | "markdown" | "text";
 
-/** Format repos as JSON string. */
 export function formatJson(repos: Repo[]): string {
   return JSON.stringify(repos, null, 2);
 }
@@ -58,7 +57,7 @@ export function formatRepos(repos: Repo[], format: ExportFormat): string {
 export function exportToFile(repos: Repo[], format: ExportFormat): string {
   const ext = format === "markdown" ? "md" : format;
   const ts = Date.now();
-  const path = `./search-cli-export-${ts}.${ext}`;
+  const path = `./ghfind-export-${ts}.${ext}`;
   writeFileSync(path, formatRepos(repos, format), "utf-8");
   return path;
 }

package/src/help.ts

@@ -1,120 +1,112 @@
-/**
- * Help screen — structured sections rendered by OpenTUI components.
- *
- * Each section has a title (with category color) and formatted rows.
- * The TUI builds these into Box + TextRenderable components inside a ScrollBox.
- */
-
-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 / o", action: "Open repo in browser" },
-        { keys: "/", action: "Focus search input" },
-        { keys: "t", action: "Toggle search / trending" },
-        { keys: "? / Ctrl+H", action: "Toggle this help screen" },
-        { keys: "q", action: "Quit" },
-      ],
-    },
-    {
-      title: " Search Mode ",
-      titleColor: "green",
-      rows: [
-        { keys: "s", action: "Cycle sort: best-match → stars → …" },
-        { keys: "l", action: "Cycle limit: 10 → 25 → 50 → 100" },
-        { keys: "r", action: "Refresh / re-run last search" },
-        { keys: "g", action: "Toggle activity graph fullscreen" },
-        { keys: "Tab", action: "Auto-complete qualifier" },
-        { keys: "b", action: "Bookmark / unbookmark selected repo" },
-      ],
-    },
-    {
-      title: " Trending Mode ",
-      titleColor: "yellow",
-      rows: [
-        { keys: "1-5", action: "Switch tab: Today → Week → Month → …" },
-        { keys: "← → / h l", action: "Navigate tabs" },
-        { keys: "r", action: "Refresh" },
-      ],
-    },
-    {
-      title: " Power Tools ",
-      titleColor: "purple",
-      rows: [
-        { keys: "d", action: "Deep-dive: README + commit activity" },
-        { keys: "c", action: "Add/remove repo from comparison" },
-        { keys: "C (Shift+c)", action: "Show comparison view" },
-        { keys: "E (Shift+e)", action: "Topic explorer" },
-        { keys: "B (Shift+b)", action: "Bookmarks panel" },
-        { keys: "PageDown / Ctrl+F", action: "Next page of results" },
-        { keys: "PageUp / Ctrl+B", action: "Scroll to top of results" },
-      ],
-    },
-    {
-      title: " Overlays ",
-      titleColor: "teal",
-      rows: [
-        { keys: "Ctrl+R", action: "Search history" },
-        { keys: "Ctrl+O", action: "Saved searches" },
-        { keys: "Ctrl+E", action: "Export results" },
-        { keys: "Ctrl+N", action: "Notifications" },
-        { keys: "Ctrl+S", action: "Save current search" },
-        { keys: "Ctrl+P", action: "Share selected repo" },
-      ],
-    },
-    {
-      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: " 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;

package/src/history.ts

@@ -3,8 +3,8 @@
  */
 import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, unlinkSync } from "fs";
 import { join } from "path";
-import type { HistoryEntry } from "./types.ts";
-import { stateDir } from "./config.ts";
+import type { HistoryEntry } from "./types";
+import { stateDir } from "./config";
 
 const HISTORY_FILE = join(stateDir(), "history.jsonl");
 const MAX_ENTRIES = 500;

package/src/init.ts

@@ -1,12 +1,12 @@
 /**
- * `search-cli init` wizard — interactive one-time config setup.
+ * `ghfind init` wizard — interactive one-time config setup.
  * 
  * ponytail: simple stdin prompts, no curses/readline UI.
  */
 import { createInterface } from "readline";
-import { saveConfig } from "./config.ts";
-import { listThemes } from "./themes.ts";
-import type { Config, SortStrategy } from "./types.ts";
+import { saveConfig } from "./config";
+import { listThemes } from "./themes";
+import type { Config, SortStrategy } from "./types";
 
 function ask(query: string): Promise<string> {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -20,7 +20,7 @@ function ask(query: string): Promise<string> {
 
 export async function runInitWizard(): Promise<void> {
   console.log("");
-  console.log("  search-cli setup wizard");
+  console.log("  ghfind setup wizard");
   console.log("  ──────────────────────");
   console.log("");
 
@@ -50,6 +50,6 @@ export async function runInitWizard(): Promise<void> {
   saveConfig(config);
   const { configPath } = await import("./config.ts");
   console.log(`  ✓ Config saved to ${configPath()}`);
-  console.log("  Run 'search-cli' to start browsing!");
+  console.log("  Run 'ghfind' to start browsing!");
   console.log("");
 }

package/src/notifications.ts

@@ -1,11 +1,7 @@
-/**
- * Notification center — ephemeral alerts for rate limits, watch changes, etc.
- * 
- * ponytail: in-memory + last-session persistence. Skip 24h auto-clean.
- */
+/** Notification center — ephemeral alerts for rate limits, watch changes, etc. */
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
-import { stateDir } from "./config.ts";
+import { stateDir } from "./config";
 
 export interface Notification {
   id: number;

package/src/open-url.ts

@@ -1,17 +1,16 @@
-/**
- * Open a URL in the user's default browser — platform-aware.
- *
- * ponytail: three platforms, no abstraction. Add more browsers/flags
- * only if the open/xdg-open pattern fails somewhere.
- */
-
-export function openUrl(url: string): void {
-  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]);
-  } catch {
-    // non-critical — user can copy the URL manually
-  }
-}
+/**
+ * Open a URL in the user's default browser — platform-aware.
+ *
+ * only if the open/xdg-open pattern fails somewhere.
+ */
+
+export function openUrl(url: string): void {
+  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]);
+  } catch {
+    // non-critical — user can copy the URL manually
+  }
+}