github-search-cli 9.4.2 → 9.4.4

package/src/types.ts

@@ -1,158 +1,160 @@
-/** Core domain types shared across the CLI. */
-
-/** A single parsed search qualifier (e.g. `language:Rust`). */
-export interface Qualifier {
-  /** The qualifier key, e.g. "language", "stars", "topic". */
-  key: string;
-  /** The qualifier value, e.g. "Rust", ">100". */
-  value: string;
-  /** True when the qualifier was negated (e.g. `-language:Rust`). */
-  negated: boolean;
-}
-
-/** The fully parsed, normalized representation of a user's search request. */
-export interface ParsedQuery {
-  /** Free-text keywords (everything that is not a qualifier). */
-  keywords: string[];
-  /** Structured qualifiers extracted from the query string. */
-  qualifiers: Qualifier[];
-  /** The original, untouched query string (preserved for debugging/display). */
-  raw: string;
-}
-
-/** A repository as returned by a search provider, normalized to a stable shape. */
-export interface Repo {
-  id: number;
-  fullName: string; // owner/name
-  name: string;
-  owner: string;
-  description: string | null;
-  url: string;
-  stars: number;
-  forks: number;
-  watchers: number;
-  language: string | null;
-  topics: string[];
-  archived: boolean;
-  isFork: boolean;
-  private: boolean;
-  createdAt: string; // ISO timestamp
-  updatedAt: string; // ISO timestamp
-  pushedAt: string; // ISO timestamp
-  score: number; // relevance score returned by GitHub
-}
-
-/** A package as returned by a registry search provider, normalized to a stable shape.
- *  Parallel to `Repo` (the search feature's entity; see ticket 002-007). */
-export interface Package {
-  name: string;
-  version: string;
-  description: string | null;
-  url: string; // registry page (npm)
-  downloads: number; // monthly downloads (npm)
-  score: number; // registry relevance (npm score.final)
-  publisher: string | null;
-  keywords: string[];
-  registry: "npm"; // registry this package came from (npm-only for MVP)
-}
-
-/** Ranking strategies supported by the ranking layer. */
-export type SortStrategy = "best-match" | "stars" | "updated" | "forks";
-
-/** Options that control how a search is executed and presented. */
-export interface SearchOptions {
-  /** Maximum number of results to return (pagination stops at this limit). */
-  limit: number;
-  /** Ranking strategy. */
-  sort: SortStrategy;
-  /** Emit machine-readable JSON instead of human-readable text. */
-  json: boolean;
-  /** GitHub API token (optional, raises rate limits). */
-  token?: string;
-  /** Page number for pagination (1-based, default 1). */
-  page?: number;
-  /** Trending period: daily|weekly|monthly. Used by TrendingAdapter. */
-  trendingSince?: "daily" | "weekly" | "monthly";
-  /** Verbose logging (outgoing query, errors, rate limits). */
-  verbose: boolean;
-}
-
-/** A paginated response from a search provider. */
-export interface SearchResponse {
-  totalCount: number;
-  repos: Repo[];
-  /** True when the provider hit a rate limit. */
-  rateLimited: boolean;
-  /** Remaining requests in the current rate-limit window, if known. */
-  rateLimitRemaining?: number;
-}
-
-// ─── P1: Memory types ───────────────────────────────────────────────
-
-/** A single history entry (append-only log). */
-export interface HistoryEntry {
-  query: string;
-  mode: "search" | "trending";
-  tab?: string;
-  timestamp: number;
-  resultCount: number;
-}
-
-/** A saved bookmark entry. */
-export interface Bookmark {
-  repo: Repo;
-  savedAt: number;
-  tags: string[];
-  notes?: string;
-  /** Releases published after this are "unseen". Set when the Releases panel is viewed. */
-  lastSeenAt?: number;
-}
-
-/** A named, saved search. */
-export interface SavedSearch {
-  name: string;
-  query: string;
-  mode: "search" | "trending";
-  tab?: string;
-  sort: SortStrategy;
-  limit: number;
-  createdAt: number;
-  lastRunAt?: number;
-}
-
-/** Session state restored on startup. */
-export interface SessionState {
-  mode: "search" | "trending" | "packages" | "bookmarks";
-  query: string;
-  sort: SortStrategy;
-  limit: number;
-  theme?: string;
-}
-
-/** Cache entry with TTL. */
-export interface CacheEntry<T> {
-  data: T;
-  cachedAt: number;
-  ttlMs: number;
-}
-
-/** Application config, persisted to ~/.config/ghfind/config.json. */
-export interface Config {
-  githubToken?: string;
-  githubTokens?: string[];
-  defaultSort: SortStrategy;
-  defaultLimit: number;
-  language?: string;
-  theme: string;
-  cacheTtlSeconds: number;
-  defaultTab: "search" | "trending";
-  historySize?: number;
-  bookmarkFile?: string;
-}
-
-/** Abstract search provider. New sources (GitLab, local index, etc.) can
- *  implement this interface without changing any other layer. */
-export interface SearchProvider {
-  readonly name: string;
-  search(query: ParsedQuery, options: SearchOptions): Promise<SearchResponse>;
-}
+/** Core domain types shared across the CLI. */
+
+/** A single parsed search qualifier (e.g. `language:Rust`). */
+export interface Qualifier {
+  /** The qualifier key, e.g. "language", "stars", "topic". */
+  key: string;
+  /** The qualifier value, e.g. "Rust", ">100". */
+  value: string;
+  /** True when the qualifier was negated (e.g. `-language:Rust`). */
+  negated: boolean;
+}
+
+/** The fully parsed, normalized representation of a user's search request. */
+export interface ParsedQuery {
+  /** Free-text keywords (everything that is not a qualifier). */
+  keywords: string[];
+  /** Structured qualifiers extracted from the query string. */
+  qualifiers: Qualifier[];
+  /** The original, untouched query string (preserved for debugging/display). */
+  raw: string;
+}
+
+/** A repository as returned by a search provider, normalized to a stable shape. */
+export interface Repo {
+  id: number;
+  fullName: string; // owner/name
+  name: string;
+  owner: string;
+  description: string | null;
+  url: string;
+  stars: number;
+  forks: number;
+  watchers: number;
+  language: string | null;
+  topics: string[];
+  archived: boolean;
+  isFork: boolean;
+  private: boolean;
+  createdAt: string; // ISO timestamp
+  updatedAt: string; // ISO timestamp
+  pushedAt: string; // ISO timestamp
+  score: number; // relevance score returned by GitHub
+}
+
+/** A package as returned by a registry search provider, normalized to a stable shape.
+ *  Parallel to `Repo` (the search feature's entity; see ticket 002-007). */
+export interface Package {
+  name: string;
+  version: string;
+  description: string | null;
+  url: string; // registry page (npm)
+  downloads: number; // monthly downloads (npm)
+  score: number; // registry relevance (npm score.final)
+  publisher: string | null;
+  keywords: string[];
+  registry: "npm"; // registry this package came from (npm-only for MVP)
+}
+
+/** Ranking strategies supported by the ranking layer. */
+export type SortStrategy = "best-match" | "stars" | "updated" | "forks";
+
+/** Options that control how a search is executed and presented. */
+export interface SearchOptions {
+  /** Maximum number of results to return (pagination stops at this limit). */
+  limit: number;
+  /** Ranking strategy. */
+  sort: SortStrategy;
+  /** Emit machine-readable JSON instead of human-readable text. */
+  json: boolean;
+  /** GitHub API token (optional, raises rate limits). */
+  token?: string;
+  /** Page number for pagination (1-based, default 1). */
+  page?: number;
+  /** Trending period: daily|weekly|monthly. Used by TrendingAdapter. */
+  trendingSince?: "daily" | "weekly" | "monthly";
+  /** Verbose logging (outgoing query, errors, rate limits). */
+  verbose: boolean;
+}
+
+/** A paginated response from a search provider. */
+export interface SearchResponse {
+  totalCount: number;
+  repos: Repo[];
+  /** True when the provider hit a rate limit. */
+  rateLimited: boolean;
+  /** Remaining requests in the current rate-limit window, if known. */
+  rateLimitRemaining?: number;
+}
+
+// ─── P1: Memory types ───────────────────────────────────────────────
+
+/** A single history entry (append-only log). */
+export interface HistoryEntry {
+  query: string;
+  mode: "search" | "trending";
+  tab?: string;
+  timestamp: number;
+  resultCount: number;
+}
+
+/** A saved bookmark entry. */
+export interface Bookmark {
+  repo: Repo;
+  savedAt: number;
+  tags: string[];
+  notes?: string;
+  /** Releases published after this are "unseen". Set when the Releases panel is viewed. */
+  lastSeenAt?: number;
+}
+
+/** A named, saved search. */
+export interface SavedSearch {
+  name: string;
+  query: string;
+  mode: "search" | "trending";
+  tab?: string;
+  sort: SortStrategy;
+  limit: number;
+  createdAt: number;
+  lastRunAt?: number;
+}
+
+/** Session state restored on startup. */
+export interface SessionState {
+  mode: "search" | "trending" | "packages" | "bookmarks";
+  query: string;
+  sort: SortStrategy;
+  limit: number;
+  /** Active trending tab (restored when mode is "trending"). */
+  trendingTab?: string;
+  theme?: string;
+}
+
+/** Cache entry with TTL. */
+export interface CacheEntry<T> {
+  data: T;
+  cachedAt: number;
+  ttlMs: number;
+}
+
+/** Application config, persisted to ~/.config/ghfind/config.json. */
+export interface Config {
+  githubToken?: string;
+  githubTokens?: string[];
+  defaultSort: SortStrategy;
+  defaultLimit: number;
+  language?: string;
+  theme: string;
+  cacheTtlSeconds: number;
+  defaultTab: "search" | "trending";
+  historySize?: number;
+  bookmarkFile?: string;
+}
+
+/** Abstract search provider. New sources (GitLab, local index, etc.) can
+ *  implement this interface without changing any other layer. */
+export interface SearchProvider {
+  readonly name: string;
+  search(query: ParsedQuery, options: SearchOptions): Promise<SearchResponse>;
+}

package/src/watch.ts

@@ -1,74 +1,95 @@
-/**
- * Watch mode — periodically re-run a search and show changes.
- * 
- */
-import type { ParsedQuery, SearchOptions, Repo } from "./types";
-import { parseQuery, applyFlagFilters, rankRepos, createGitHubSearch } from "./search";
-import { createTrendingSearch } from "./search";
-
-export interface WatchOptions {
-  query: string;
-  sort: SearchOptions["sort"];
-  limit: number;
-  token?: string;
-  intervalMs: number;
-  trending?: boolean;
-}
-
-const MAX_FAILS = 5;
-
-/** Run watch mode. Calls onChange with each tick's results. */
-export async function runWatch(
-  opts: WatchOptions,
-  onChange: (repos: Repo[], delta: number) => void,
-  onError: (err: Error) => void,
-): Promise<void> {
-  let previous: Repo[] = [];
-  let failCount = 0;
-  let intervalId: ReturnType<typeof setInterval> | null = null;
-
-  const tick = async () => {
-    try {
-      let repos: Repo[];
-      if (opts.trending) {
-        const since = opts.query === "weekly" ? "weekly" : opts.query === "monthly" ? "monthly" : "daily";
-        const trendingSearch = createTrendingSearch();
-        const response = await trendingSearch.search(
-          { keywords: [], qualifiers: [], raw: "trending" },
-          { limit: opts.limit, sort: opts.sort, json: false, verbose: false, trendingSince: since },
-        );
-        repos = response.repos;
-      } else {
-        const parsed = applyFlagFilters(parseQuery(opts.query), {});
-        const provider = createGitHubSearch(undefined, opts.token ? [opts.token] : []);
-        const options: SearchOptions = {
-          limit: opts.limit,
-          sort: opts.sort,
-          json: false,
-          verbose: false,
-          token: opts.token,
-        };
-        const response = await provider.search(parsed, options);
-        repos = rankRepos(response.repos, options.sort);
-      }
-
-      failCount = 0; // reset on success
-      const delta = previous.length > 0 ? repos.length - previous.length : 0;
-      previous = repos;
-      onChange(repos, delta);
-    } catch (err) {
-      failCount++;
-      onError(err instanceof Error ? err : new Error(String(err)));
-      if (failCount >= MAX_FAILS) {
-        onError(new Error(`Watch stopped after ${MAX_FAILS} consecutive failures`));
-        if (intervalId) clearInterval(intervalId);
-      }
-    }
-  };
-
-  // Immediate first tick, then interval
-  await tick();
-  if (failCount < MAX_FAILS) {
-    intervalId = setInterval(tick, opts.intervalMs);
-  }
-}
+/**
+ * Watch mode — periodically re-run a search and show changes.
+ *
+ */
+import type { ParsedQuery, SearchOptions, Repo } from "./types";
+import {
+  parseQuery,
+  applyFlagFilters,
+  rankRepos,
+  createGitHubSearch,
+} from "./search";
+import { createTrendingSearch } from "./search";
+
+export interface WatchOptions {
+  query: string;
+  sort: SearchOptions["sort"];
+  limit: number;
+  token?: string;
+  intervalMs: number;
+  trending?: boolean;
+}
+
+const MAX_FAILS = 5;
+
+/** Run watch mode. Calls onChange with each tick's results. */
+export async function runWatch(
+  opts: WatchOptions,
+  onChange: (repos: Repo[], delta: number) => void,
+  onError: (err: Error) => void,
+): Promise<void> {
+  let previous: Repo[] = [];
+  let failCount = 0;
+  let intervalId: ReturnType<typeof setInterval> | null = null;
+
+  const tick = async () => {
+    try {
+      let repos: Repo[];
+      if (opts.trending) {
+        const since =
+          opts.query === "weekly"
+            ? "weekly"
+            : opts.query === "monthly"
+              ? "monthly"
+              : "daily";
+        const trendingSearch = createTrendingSearch();
+        const response = await trendingSearch.search(
+          { keywords: [], qualifiers: [], raw: "trending" },
+          {
+            limit: opts.limit,
+            sort: opts.sort,
+            json: false,
+            verbose: false,
+            trendingSince: since,
+          },
+        );
+        repos = response.repos;
+      } else {
+        const parsed = applyFlagFilters(parseQuery(opts.query), {});
+        const provider = createGitHubSearch(
+          undefined,
+          opts.token ? [opts.token] : [],
+        );
+        const options: SearchOptions = {
+          limit: opts.limit,
+          sort: opts.sort,
+          json: false,
+          verbose: false,
+          token: opts.token,
+        };
+        const response = await provider.search(parsed, options);
+        repos = rankRepos(response.repos, options.sort);
+      }
+
+      failCount = 0; // reset on success
+      const delta = previous.length > 0 ? repos.length - previous.length : 0;
+      previous = repos;
+      onChange(repos, delta);
+    } catch (err) {
+      failCount++;
+      onError(err instanceof Error ? err : new Error(String(err)));
+      if (failCount >= MAX_FAILS) {
+        onError(
+          new Error(`Watch stopped after ${MAX_FAILS} consecutive failures`),
+        );
+        if (intervalId) clearInterval(intervalId);
+      }
+    }
+  };
+
+  // Immediate first tick, then interval
+  await tick();
+  if (failCount < MAX_FAILS) {
+    intervalId = setInterval(tick, opts.intervalMs);
+  }
+}