github-search-cli 0.8.0 → 0.8.2

package/src/types.ts

@@ -1,140 +1,140 @@
-/** 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
-}
-
-/** 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;
-  /** 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;
-}
-
-/** 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";
-  query: string;
-  sort: SortStrategy;
-  limit: number;
-  trendingTab: 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
+}
+
+/** 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;
+  /** 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;
+}
+
+/** 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";
+  query: string;
+  sort: SortStrategy;
+  limit: number;
+  trendingTab: 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,62 +1,62 @@
-/**
- * Watch mode — periodically re-run a search and show changes.
- * 
- */
-import type { ParsedQuery, SearchOptions, Repo } from "./types";
-import { parseQuery, applyFlagFilters, rankRepos, createGitHubSearch } 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 {
-      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);
-      const 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";
+
+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 {
+      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);
+      const 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);
+  }
+}