github-search-cli 9.9.0 → 9.10.1

package/src/watch.ts

@@ -19,6 +19,23 @@ export interface WatchOptions {
   token?: string;
   intervalMs: number;
   trending?: boolean;
+  /** Trending period (`--since`); falls back to the query-string convention. */
+  since?: string;
+}
+
+/**
+ * Resolve the trending period for a watch tick. `--since` wins when it names a
+ * real period; otherwise fall back to the legacy `ghfind --watch weekly`
+ * convention where the query string itself carried the period.
+ */
+export function resolveTrendingSince(
+  opts: Pick<WatchOptions, "query" | "since">,
+): "daily" | "weekly" | "monthly" {
+  if (opts.since === "weekly" || opts.since === "monthly") return opts.since;
+  if (opts.since === "daily") return "daily";
+  if (opts.query === "weekly") return "weekly";
+  if (opts.query === "monthly") return "monthly";
+  return "daily";
 }
 
 const MAX_FAILS = 5;
@@ -44,12 +61,7 @@ export async function runWatch(
     try {
       let repos: Repo[];
       if (opts.trending) {
-        const since =
-          opts.query === "weekly"
-            ? "weekly"
-            : opts.query === "monthly"
-              ? "monthly"
-              : "daily";
+        const since = resolveTrendingSince(opts);
         const trendingSearch = createTrendingSearch();
         const response = await trendingSearch.search(trendingQuery(), {
           limit: opts.limit,

package/src/export.ts

@@ -1,73 +0,0 @@
-/**
- * Export — format repos as JSON, CSV, Markdown, or plain text.
- */
-import { writeFileSync } from "node:fs";
-import type { Repo } from "./types";
-
-export type ExportFormat = "json" | "csv" | "markdown" | "text";
-
-export function formatJson(repos: Repo[]): string {
-  return JSON.stringify(repos, null, 2);
-}
-
-function csvEscape(val: unknown): string {
-  const str = String(val ?? "");
-  if (str.includes('"') || str.includes(",") || str.includes("\n")) {
-    return `"${str.replace(/"/g, '""')}"`;
-  }
-  return str;
-}
-
-/** Format repos as CSV string. */
-export function formatCsv(repos: Repo[]): string {
-  const header = "rank,full_name,stars,forks,language,url";
-  const rows = repos.map(
-    (r, i) =>
-      `${i + 1},${csvEscape(r.fullName)},${r.stars},${r.forks},${csvEscape(r.language ?? "")},${csvEscape(r.url)}`,
-  );
-  return [header, ...rows].join("\n");
-}
-
-/** Format repos as Markdown table. */
-export function formatMarkdown(repos: Repo[]): string {
-  const header = "| # | Repo | Stars | Forks | Language |";
-  const sep = "|---|------|-------|-------|----------|";
-  const rows = repos.map(
-    (r, i) =>
-      `| ${i + 1} | [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.forks.toLocaleString()} | ${r.language ?? "—"} |`,
-  );
-  return [header, sep, ...rows].join("\n");
-}
-
-/** Format repos as plain text, one per line. */
-export function formatText(repos: Repo[]): string {
-  return repos
-    .map(
-      (r, i) =>
-        `${i + 1}. ${r.fullName} ★ ${r.stars.toLocaleString()} ${r.url}`,
-    )
-    .join("\n");
-}
-
-/** Format repos in the given format. */
-export function formatRepos(repos: Repo[], format: ExportFormat): string {
-  switch (format) {
-    case "json":
-      return formatJson(repos);
-    case "csv":
-      return formatCsv(repos);
-    case "markdown":
-      return formatMarkdown(repos);
-    case "text":
-      return formatText(repos);
-  }
-}
-
-/** Export repos to a file. Returns the file path. */
-export function exportToFile(repos: Repo[], format: ExportFormat): string {
-  const ext = format === "markdown" ? "md" : format;
-  const ts = Date.now();
-  const path = `./ghfind-export-${ts}.${ext}`;
-  writeFileSync(path, formatRepos(repos, format), "utf-8");
-  return path;
-}

package/src/pipe.ts

@@ -1,60 +0,0 @@
-/**
- * Pipe-friendly format modifiers — output repo data as lines for shell piping.
- */
-import type { Repo } from "./types";
-import { openUrl } from "./open-url";
-
-export type FormatLine =
-  "urls" | "names" | "ssh-urls" | "clone-commands" | "ids";
-
-export function formatUrls(repos: Repo[]): string {
-  return repos.map((r) => r.url).join("\n");
-}
-
-export function formatNames(repos: Repo[]): string {
-  return repos.map((r) => r.fullName).join("\n");
-}
-
-export function formatSshUrls(repos: Repo[]): string {
-  return repos.map((r) => `git@github.com:${r.fullName}.git`).join("\n");
-}
-
-export function formatCloneCommands(repos: Repo[]): string {
-  return repos
-    .map((r) => `git clone git@github.com:${r.fullName}.git`)
-    .join("\n");
-}
-
-export function formatIds(repos: Repo[]): string {
-  return repos.map((r) => String(r.id)).join("\n");
-}
-
-export function formatLines(repos: Repo[], format: FormatLine): string {
-  switch (format) {
-    case "urls":
-      return formatUrls(repos);
-    case "names":
-      return formatNames(repos);
-    case "ssh-urls":
-      return formatSshUrls(repos);
-    case "clone-commands":
-      return formatCloneCommands(repos);
-    case "ids":
-      return formatIds(repos);
-  }
-}
-
-/** Execute a pipe target (clone, open) on repos. */
-export async function pipeExec(repos: Repo[], target: string): Promise<void> {
-  for (const repo of repos) {
-    const url = repo.url;
-    switch (target) {
-      case "open":
-        await openUrl(url);
-        break;
-      case "clone":
-        console.log(`git clone git@github.com:${repo.fullName}.git`);
-        break;
-    }
-  }
-}

package/src/search-state.ts

@@ -1,278 +0,0 @@
-/**
- * SearchState — owns all TUI state and domain calls.
- *
- * The TUI view layer reads from SearchState and dispatches actions.
- * This module is testable without the OpenTUI renderer.
- */
-import type { Repo, SortStrategy, SessionState } from "./types";
-import type { TabName } from "./trending";
-import { tabSince } from "./trending";
-import {
-  parseQuery,
-  applyFlagFilters,
-  rankRepos,
-  createGitHubSearch,
-  SearchModule,
-  TrendingAdapter,
-  trendingQuery,
-} from "./search";
-import { restoreSession, saveSession } from "./session";
-import { appendHistory } from "./history";
-import { toggleBookmark, isBookmarked } from "./bookmarks";
-import {
-  saveSearch,
-  getSavedSearches,
-  touchSavedSearch,
-} from "./saved-searches";
-import { fetchDeepDive, buildDeepDiveText } from "./deepdive";
-import { loadConfig } from "./config";
-
-export type Overlay =
-  | "none"
-  | "history"
-  | "bookmarks"
-  | "saved"
-  | "help"
-  | "topics"
-  | "export"
-  | "compare"
-  | "notifications"
-  | "share"
-  | "leader"
-  | "readme";
-
-export interface SearchState {
-  // Core search state
-  currentRepos: Repo[];
-  currentSort: SortStrategy;
-  currentLimit: number;
-  currentQueryInput: string;
-  isLoading: boolean;
-  currentMode: "search" | "trending";
-  currentPage: number;
-  totalCount: number;
-
-  // Trending
-  trendingTab: TabName;
-  trendingPeriod: string;
-
-  // UI overlays
-  currentOverlay: Overlay;
-  deepDiveActive: boolean;
-  compareList: Repo[];
-  graphFullscreen: boolean;
-  chartCommitData: number[];
-  quitArmed: boolean;
-}
-
-export class SearchStateManager {
-  private config = loadConfig();
-  private provider = createGitHubSearch(undefined, this.config.githubTokens);
-  private trendingSearch = new SearchModule(new TrendingAdapter());
-
-  state: SearchState = {
-    currentRepos: [],
-    currentSort: this.config.defaultSort,
-    currentLimit: this.config.defaultLimit,
-    currentQueryInput: "",
-    isLoading: false,
-    currentMode: "search",
-    currentPage: 1,
-    totalCount: 0,
-    trendingTab: "This Week",
-    trendingPeriod: "this week",
-    currentOverlay: "none",
-    deepDiveActive: false,
-    compareList: [],
-    graphFullscreen: false,
-    chartCommitData: [],
-    quitArmed: false,
-  };
-
-  constructor() {
-    const session = restoreSession();
-    if (session) {
-      // Only search/trending are restorable here; packages/bookmarks pages
-      // are re-entered interactively, so clamp anything else to "search".
-      this.state.currentMode =
-        session.mode === "trending" ? "trending" : "search";
-      this.state.currentQueryInput = session.query;
-      this.state.currentSort = session.sort;
-      this.state.currentLimit = session.limit;
-      this.state.trendingTab = (session.trendingTab as TabName) ?? "This Week";
-    }
-  }
-
-  // ── Search ──
-
-  async search(query: string, page: number = 1): Promise<void> {
-    this.state.isLoading = true;
-    this.state.currentQueryInput = query;
-    this.state.currentPage = page;
-    try {
-      const parsed = applyFlagFilters(parseQuery(query), {});
-      const response = await this.provider.search(parsed, {
-        limit: this.state.currentLimit,
-        sort: this.state.currentSort,
-        json: false,
-        verbose: false,
-        token: this.config.githubToken,
-        page,
-      });
-      this.state.currentRepos = rankRepos(
-        response.repos,
-        this.state.currentSort,
-      );
-      this.state.totalCount = response.totalCount;
-      this.state.currentMode = "search";
-      appendHistory({
-        query,
-        mode: "search",
-        timestamp: Date.now(),
-        resultCount: response.repos.length,
-      });
-    } finally {
-      this.state.isLoading = false;
-    }
-  }
-
-  async nextPage(): Promise<void> {
-    await this.search(this.state.currentQueryInput, this.state.currentPage + 1);
-  }
-
-  async prevPage(): Promise<void> {
-    if (this.state.currentPage > 1) {
-      await this.search(
-        this.state.currentQueryInput,
-        this.state.currentPage - 1,
-      );
-    }
-  }
-
-  // ── Trending ──
-
-  async loadTrending(tab: TabName): Promise<void> {
-    this.state.isLoading = true;
-    this.state.trendingTab = tab;
-    this.state.currentMode = "trending";
-    try {
-      const response = await this.trendingSearch.search(trendingQuery(), {
-        limit: 25,
-        sort: "stars",
-        json: false,
-        verbose: false,
-        trendingSince: tabSince(tab),
-      });
-      this.state.currentRepos = response.repos;
-      this.state.totalCount = response.totalCount;
-      appendHistory({
-        query: `trending:${tab}`,
-        mode: "trending",
-        tab,
-        timestamp: Date.now(),
-        resultCount: response.repos.length,
-      });
-    } finally {
-      this.state.isLoading = false;
-    }
-  }
-
-  // ── Bookmarks ──
-
-  toggleBookmark(repo: Repo): boolean {
-    return toggleBookmark(repo);
-  }
-
-  isBookmarked(fullName: string): boolean {
-    return isBookmarked(fullName);
-  }
-
-  // ── Saved searches ──
-
-  saveCurrentSearch(name: string): void {
-    saveSearch(
-      name,
-      this.state.currentQueryInput,
-      this.state.currentMode,
-      this.state.currentSort,
-      this.state.currentLimit,
-    );
-  }
-
-  getSavedSearches() {
-    return getSavedSearches();
-  }
-
-  touchSavedSearch(name: string): void {
-    touchSavedSearch(name);
-  }
-
-  // ── Deep dive ──
-
-  async deepDive(repo: Repo): Promise<string> {
-    this.state.deepDiveActive = true;
-    try {
-      const data = await fetchDeepDive(repo, this.config.githubToken);
-      return buildDeepDiveText(data);
-    } finally {
-      this.state.deepDiveActive = false;
-    }
-  }
-
-  // ── Compare ──
-
-  addToCompare(repo: Repo): void {
-    if (!this.state.compareList.some((r) => r.fullName === repo.fullName)) {
-      this.state.compareList.push(repo);
-    }
-  }
-
-  removeFromCompare(fullName: string): void {
-    this.state.compareList = this.state.compareList.filter(
-      (r) => r.fullName !== fullName,
-    );
-  }
-
-  clearCompare(): void {
-    this.state.compareList = [];
-  }
-
-  // ── Session ──
-
-  saveSession(): void {
-    const s: SessionState = {
-      mode: this.state.currentMode,
-      query: this.state.currentQueryInput,
-      sort: this.state.currentSort,
-      limit: this.state.currentLimit,
-      trendingTab: this.state.trendingTab,
-    };
-    saveSession(s);
-  }
-
-  // ── Setters ──
-
-  setSort(sort: SortStrategy): void {
-    this.state.currentSort = sort;
-  }
-
-  setLimit(limit: number): void {
-    this.state.currentLimit = limit;
-  }
-
-  setOverlay(overlay: Overlay): void {
-    this.state.currentOverlay = overlay;
-  }
-
-  setGraphFullscreen(fullscreen: boolean): void {
-    this.state.graphFullscreen = fullscreen;
-  }
-
-  setChartCommitData(data: number[]): void {
-    this.state.chartCommitData = data;
-  }
-
-  setQuitArmed(armed: boolean): void {
-    this.state.quitArmed = armed;
-  }
-}