github-search-cli 0.7.0 → 0.8.0

package/src/cli.ts

@@ -1,252 +1,239 @@
-#!/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";
-import { readFileSync } from "fs";
-import { join } from "path";
-import { launchBrowser } from "./tui.ts";
-import type { SearchOptions } from "./types.ts";
-
-interface CLIFlags {
-  query: string;
-  json: boolean;
-  csv: boolean;
-  markdown: boolean;
-  count: boolean;
-  limit: number;
-  sort: SearchOptions["sort"];
-  token?: string;
-  trending: boolean;
-  since: string;
-  pipe?: string;
-  format?: string;
-  watch: boolean;
-  interval: number;
-  completion?: string;
-  init: boolean;
-  version: boolean;
-  help: boolean;
-}
-
-function parseArgs(args: string[]): CLIFlags {
-  const flags: CLIFlags = {
-    query: "",
-    json: false,
-    csv: false,
-    markdown: false,
-    count: false,
-    limit: 50,
-    sort: "best-match",
-    token: process.env.GITHUB_TOKEN,
-    trending: false,
-    since: "daily",
-    watch: false,
-    interval: 300,
-    init: false,
-    version: false,
-    help: false,
-  };
-
-  let queryParts: string[] = [];
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    switch (arg) {
-      case "--json": flags.json = true; break;
-      case "--csv": flags.csv = true; break;
-      case "--markdown": flags.markdown = true; break;
-      case "--count": flags.count = true; break;
-      case "--trending": flags.trending = true; break;
-      case "--watch": flags.watch = true; break;
-      case "--version": case "-v": flags.version = true; break;
-      case "--help": case "-h": flags.help = true; break;
-      case "init": flags.init = true; break;
-      case "--limit": {
-        const parsed = parseInt(args[++i]);
-        if (isNaN(parsed) || parsed < 1 || parsed > 100) {
-          console.error(`Invalid limit: must be 1-100. Using default 50.`);
-          flags.limit = 50;
-        } else {
-          flags.limit = parsed;
-        }
-        break;
-      }
-      case "--sort": flags.sort = args[++i] as SearchOptions["sort"]; break;
-      case "--token": flags.token = args[++i]; break;
-      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 "--completion": flags.completion = args[++i]; break;
-      default:
-        if (!arg.startsWith("-")) queryParts.push(arg);
-    }
-  }
-  flags.query = queryParts.join(" ");
-  return flags;
-}
-
-async function main() {
-  const flags = parseArgs(process.argv.slice(2));
-
-  // Version
-  if (flags.version) {
-    const pkg = JSON.parse(readFileSync(join(import.meta.dir!, "..", "package.json"), "utf-8"));
-    console.log(`search-cli v${pkg.version}`);
-    return;
-  }
-
-  // Help
-  if (flags.help) {
-    console.log(`
-search-cli — 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
-
-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
-  --trending                           Trending mode
-  --since <period>                     Trending period: daily|weekly|monthly
-  --pipe <target>                      Pipe target: clone|open
-  --format <fmt>                       Line format: urls|names|ssh-urls|...
-  --watch                              Watch mode (re-run periodically)
-  --interval <s>                       Watch interval in seconds (default: 300)
-  --completion <shell>                 Generate completions
-`);
-    return;
-  }
-
-  // Shell completions
-  if (flags.completion) {
-    const shell = flags.completion;
-    try {
-      const content = readFileSync(join(import.meta.dir!, "..", "completions", `search-cli.${shell}`), "utf-8");
-      console.log(content);
-    } catch {
-      console.error(`Completions not available for shell: ${shell}`);
-      process.exit(1);
-    }
-    return;
-  }
-
-  // Init wizard
-  if (flags.init) {
-    await runInitWizard();
-    return;
-  }
-
-  // Determine output format
-  const format: ExportFormat | undefined =
-    flags.json ? "json" : flags.csv ? "csv" : flags.markdown ? "markdown" : undefined;
-  const isNonInteractive = format || flags.count || flags.format || flags.pipe || flags.watch;
-
-  // Non-interactive mode
-  if (isNonInteractive) {
-    await runNonInteractive(flags, format);
-    return;
-  }
-
-  // Default: launch interactive TUI
-  await launchBrowser();
-}
-
-async function runNonInteractive(flags: CLIFlags, format?: ExportFormat) {
-  const query = flags.query;
-  const provider = new GitHubSearchProvider(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;
-  }
-
-  // --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;
-  }
-
-  // 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);
-
-  // --count
-  if (flags.count) {
-    console.log(response.totalCount);
-    return;
-  }
-
-  // --json, --csv, --markdown
-  if (format) {
-    console.log(formatRepos(repos, format));
-    return;
-  }
-}
-
-main().catch((err) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-});
+#!/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, 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;
+  json: boolean;
+  csv: boolean;
+  markdown: boolean;
+  count: boolean;
+  limit: number;
+  sort: SearchOptions["sort"];
+  token?: string;
+  trending: boolean;
+  since: string;
+  pipe?: string;
+  format?: string;
+  watch: boolean;
+  interval: number;
+  completion?: string;
+  init: boolean;
+  version: boolean;
+  help: boolean;
+}
+
+function parseArgs(args: string[]): CLIFlags {
+  const flags: CLIFlags = {
+    query: "",
+    json: false,
+    csv: false,
+    markdown: false,
+    count: false,
+    limit: 50,
+    sort: "best-match",
+    token: process.env.GITHUB_TOKEN,
+    trending: false,
+    since: "daily",
+    watch: false,
+    interval: 300,
+    init: false,
+    version: false,
+    help: false,
+  };
+
+  let queryParts: string[] = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--json": flags.json = true; break;
+      case "--csv": flags.csv = true; break;
+      case "--markdown": flags.markdown = true; break;
+      case "--count": flags.count = true; break;
+      case "--trending": flags.trending = true; break;
+      case "--watch": flags.watch = true; break;
+      case "--version": case "-v": flags.version = true; break;
+      case "--help": case "-h": flags.help = true; break;
+      case "init": flags.init = true; break;
+      case "--limit": {
+        const parsed = parseInt(args[++i]);
+        if (isNaN(parsed) || parsed < 1 || parsed > 100) {
+          console.error(`Invalid limit: must be 1-100. Using default 50.`);
+          flags.limit = 50;
+        } else {
+          flags.limit = parsed;
+        }
+        break;
+      }
+      case "--sort": flags.sort = args[++i] as SearchOptions["sort"]; break;
+      case "--token": flags.token = args[++i]; break;
+      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 "--completion": flags.completion = args[++i]; break;
+      default:
+        if (!arg.startsWith("-")) queryParts.push(arg);
+    }
+  }
+  flags.query = queryParts.join(" ");
+  return flags;
+}
+
+async function main() {
+  const flags = parseArgs(process.argv.slice(2));
+
+  // Version
+  if (flags.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(`
+ghfind — Interactive GitHub repository browser
+
+Usage:
+  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
+  --limit <n>                          Max results (default: 50)
+  --sort <strategy>                    Sort: best-match|stars|updated|forks
+  --token <token>                      GitHub API token
+  --trending                           Trending mode
+  --since <period>                     Trending period: daily|weekly|monthly
+  --pipe <target>                      Pipe target: clone|open
+  --format <fmt>                       Line format: urls|names|ssh-urls|...
+  --watch                              Watch mode (re-run periodically)
+  --interval <s>                       Watch interval in seconds (default: 300)
+  --completion <shell>                 Generate completions
+`);
+    return;
+  }
+
+  // Shell completions
+  if (flags.completion) {
+    const shell = flags.completion;
+    try {
+      const content = readFileSync(join(PKG_DIR, "completions", `ghfind.${shell}`), "utf-8");
+      console.log(content);
+    } catch {
+      console.error(`Completions not available for shell: ${shell}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  // Init wizard
+  if (flags.init) {
+    await runInitWizard();
+    return;
+  }
+
+  // Determine output format
+  const format: ExportFormat | undefined =
+    flags.json ? "json" : flags.csv ? "csv" : flags.markdown ? "markdown" : undefined;
+  const isNonInteractive = format || flags.count || flags.format || flags.pipe || flags.watch;
+
+  // Non-interactive mode
+  if (isNonInteractive) {
+    await runNonInteractive(flags, format);
+    return;
+  }
+
+  // Default: launch interactive TUI
+  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;
+  }
+
+  // --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;
+  }
+
+  // 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);
+
+  // --count
+  if (flags.count) {
+    console.log(response.totalCount);
+    return;
+  }
+
+  // --json, --csv, --markdown
+  if (format) {
+    console.log(formatRepos(repos, format));
+    return;
+  }
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/src/compare.ts

@@ -1,46 +1,46 @@
-/**
- * Repo comparison — side-by-side table for 2+ repos.
- */
-import type { Repo } from "./types.ts";
-
-interface CompareRow {
-  label: string;
-  values: string[];
-}
-
-/** Build a comparison table as an array of text rows. */
-export function buildComparisonTable(repos: Repo[]): string {
-  if (repos.length < 2) return "Select at least 2 repos to compare (press c to add).";
-
-  const rows: CompareRow[] = [];
-  const names = repos.map((r) => r.fullName);
-
-  rows.push({ label: "Stars", values: repos.map((r) => `★ ${r.stars.toLocaleString()}`) });
-  rows.push({ label: "Forks", values: repos.map((r) => r.forks.toLocaleString()) });
-  rows.push({ label: "Language", values: repos.map((r) => r.language ?? "—") });
-  rows.push({ label: "Created", values: repos.map((r) => r.createdAt?.slice(0, 7) ?? "—") });
-  rows.push({ label: "Updated", values: repos.map((r) => r.updatedAt?.slice(0, 10) ?? "—") });
-  rows.push({ label: "Topics", values: repos.map((r) => (r.topics?.slice(0, 3).join(", ") ?? "—") || "—") });
-
-  // Calculate the max width for each column
-  const colW = Math.max(15, ...names.map((n) => n.length));
-  const valW = Math.max(8, ...rows.flatMap((r) => r.values.map((v) => v.length)));
-
-  // Header row
-  const header = ["".padEnd(14), ...names.map((n) => n.padEnd(colW))];
-  const sep = ["".padEnd(14, "─"), ...names.map(() => "".padEnd(colW, "─"))];
-
-  const lines: string[] = [
-    "┌" + sep.map((s) => "─" + s + "─").join("┬") + "┐",
-    "│" + header.map((h) => ` ${h} `).join("│") + "│",
-    "├" + sep.map((s) => "─" + s + "─").join("┼") + "┤",
-  ];
-
-  for (const row of rows) {
-    const cells = [row.label.padEnd(14), ...row.values.map((v) => v.padEnd(colW))];
-    lines.push("│" + cells.map((c) => ` ${c} `).join("│") + "│");
-  }
-
-  lines.push("└" + sep.map((s) => "─" + s + "─").join("┴") + "┘");
-  return lines.join("\n");
-}
+/**
+ * Repo comparison — side-by-side table for 2+ repos.
+ */
+import type { Repo } from "./types";
+
+interface CompareRow {
+  label: string;
+  values: string[];
+}
+
+/** Build a comparison table as an array of text rows. */
+export function buildComparisonTable(repos: Repo[]): string {
+  if (repos.length < 2) return "Select at least 2 repos to compare (press c to add).";
+
+  const rows: CompareRow[] = [];
+  const names = repos.map((r) => r.fullName);
+
+  rows.push({ label: "Stars", values: repos.map((r) => `★ ${r.stars.toLocaleString()}`) });
+  rows.push({ label: "Forks", values: repos.map((r) => r.forks.toLocaleString()) });
+  rows.push({ label: "Language", values: repos.map((r) => r.language ?? "—") });
+  rows.push({ label: "Created", values: repos.map((r) => r.createdAt?.slice(0, 7) ?? "—") });
+  rows.push({ label: "Updated", values: repos.map((r) => r.updatedAt?.slice(0, 10) ?? "—") });
+  rows.push({ label: "Topics", values: repos.map((r) => (r.topics?.slice(0, 3).join(", ") ?? "—") || "—") });
+
+  // Calculate the max width for each column
+  const colW = Math.max(15, ...names.map((n) => n.length));
+  const valW = Math.max(8, ...rows.flatMap((r) => r.values.map((v) => v.length)));
+
+  // Header row
+  const header = ["".padEnd(14), ...names.map((n) => n.padEnd(colW))];
+  const sep = ["".padEnd(14, "─"), ...names.map(() => "".padEnd(colW, "─"))];
+
+  const lines: string[] = [
+    "┌" + sep.map((s) => "─" + s + "─").join("┬") + "┐",
+    "│" + header.map((h) => ` ${h} `).join("│") + "│",
+    "├" + sep.map((s) => "─" + s + "─").join("┼") + "┤",
+  ];
+
+  for (const row of rows) {
+    const cells = [row.label.padEnd(14), ...row.values.map((v) => v.padEnd(colW))];
+    lines.push("│" + cells.map((c) => ` ${c} `).join("│") + "│");
+  }
+
+  lines.push("└" + sep.map((s) => "─" + s + "─").join("┴") + "┘");
+  return lines.join("\n");
+}