github-search-cli 0.7.0 → 0.8.0

package/src/config.ts

@@ -1,65 +1,65 @@
-/**
- * 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
- */
-import type { Config } from "./types.ts";
-import { homedir } from "os";
-import { join } from "path";
-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");
-  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");
-  return base;
-}
-const DEFAULTS: Config = {
-  defaultSort: "best-match",
-  defaultLimit: 50,
-  theme: "tokyo-night",
-  cacheTtlSeconds: 300,
-  defaultTab: "search",
-};
-
-export function configPath(): string {
-  const envPath = process.env.SEARCH_CLI_CONFIG;
-  if (envPath) return envPath;
-
-  const xdg = process.env.XDG_CONFIG_HOME;
-  const base = xdg ? join(xdg, "search-cli") : join(homedir(), ".config", "search-cli");
-  return join(base, "config.json");
-}
-
-export function loadConfig(): Config {
-  const path = configPath();
-  try {
-    const raw = readFileSync(path, "utf-8");
-    const parsed = JSON.parse(raw);
-    return mergeWithEnv({ ...DEFAULTS, ...parsed });
-  } catch {
-    return mergeWithEnv({ ...DEFAULTS });
-  }
-}
-
-export function saveConfig(config: Config): void {
-  const path = configPath();
-  const dir = path.slice(0, Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\")));
-  mkdirSync(dir, { recursive: true });
-  writeFileSync(path, JSON.stringify(config, null, 2));
-}
-
-function mergeWithEnv(config: Config): Config {
-  if (process.env.GITHUB_TOKEN) config.githubToken = process.env.GITHUB_TOKEN;
-  return config;
-}
+/**
+ * Config system: load/save config from XDG paths, merge with env vars.
+ * 
+ * Lookup order:
+ *   1. GHFIND_CONFIG env var
+ *   2. $XDG_CONFIG_HOME/ghfind/config.json
+ *   3. ~/.config/ghfind/config.json
+ */
+import type { Config } from "./types";
+import { homedir } from "os";
+import { join } from "path";
+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, "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, "ghfind") : join(homedir(), ".cache", "ghfind");
+  return base;
+}
+const DEFAULTS: Config = {
+  defaultSort: "best-match",
+  defaultLimit: 50,
+  theme: "tokyo-night",
+  cacheTtlSeconds: 300,
+  defaultTab: "search",
+};
+
+export function configPath(): string {
+  const envPath = process.env.GHFIND_CONFIG;
+  if (envPath) return envPath;
+
+  const xdg = process.env.XDG_CONFIG_HOME;
+  const base = xdg ? join(xdg, "ghfind") : join(homedir(), ".config", "ghfind");
+  return join(base, "config.json");
+}
+
+export function loadConfig(): Config {
+  const path = configPath();
+  try {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    return mergeWithEnv({ ...DEFAULTS, ...parsed });
+  } catch {
+    return mergeWithEnv({ ...DEFAULTS });
+  }
+}
+
+export function saveConfig(config: Config): void {
+  const path = configPath();
+  const dir = path.slice(0, Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\")));
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(path, JSON.stringify(config, null, 2));
+}
+
+function mergeWithEnv(config: Config): Config {
+  if (process.env.GITHUB_TOKEN) config.githubToken = process.env.GITHUB_TOKEN;
+  return config;
+}

package/src/deepdive.ts

@@ -1,124 +1,118 @@
-/**
- * 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";
-
-const USER_AGENT = "search-cli/1.0";
-
-/** Language breakdown: { [lang]: bytes } */
-type LanguageMap = Record<string, number>;
-
-/** Contributor summary */
-interface Contributor {
-  login: string;
-  contributions: number;
-}
-
-/** All deep-dive data for one repo. */
-export interface DeepDiveData {
-  summary: string;
-  languages: string;
-  contributors: string;
-  readme: string;
-}
-
-/** Fetch all deep-dive data for a repo. Returns formatted sections. */
-export async function fetchDeepDive(repo: Repo, token?: string): Promise<DeepDiveData> {
-  const auth = token ? { Authorization: `Bearer ${token}` } : {};
-  const headers = { "User-Agent": USER_AGENT, ...auth };
-
-  const [languagesRes, contributorsRes] = await Promise.all([
-    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/languages`, { headers }),
-    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/contributors?per_page=5`, { headers }),
-  ]);
-
-  // README with branch fallback: main → master → README.rst
-  let readmeText = "";
-  for (const path of [`${repo.owner}/${repo.name}/main/README.md`, `${repo.owner}/${repo.name}/master/README.md`, `${repo.owner}/${repo.name}/main/README.rst`]) {
-    const r = await fetch(`https://raw.githubusercontent.com/${path}`, { headers });
-    if (r.ok) { readmeText = await r.text(); break; }
-  }
-
-  return {
-    summary: formatSummary(repo),
-    languages: formatLanguages(languagesRes.ok ? await languagesRes.json().catch(() => ({})) : {}),
-    contributors: formatContributors(contributorsRes.ok ? await contributorsRes.json().catch(() => []) : []),
-    readme: formatReadme(readmeText),
-  };
-}
-
-function formatSummary(repo: Repo): string {
-  const lines = [
-    ` ${repo.fullName}`,
-    ` ★ ${repo.stars.toLocaleString()}  ◆ ${repo.forks.toLocaleString()}  ${repo.language ?? "—"}`,
-    repo.description ? ` ${repo.description}` : "",
-    repo.topics.length ? ` topics: ${repo.topics.slice(0, 8).join(", ")}` : "",
-    ` ${repo.url}`,
-  ];
-  return lines.filter(Boolean).join("\n");
-}
-
-function formatLanguages(langs: LanguageMap): string {
-  const entries = Object.entries(langs);
-  if (entries.length === 0) return "  (no language data)";
-  const total = entries.reduce((s, [, v]) => s + v, 0);
-  const barW = 20;
-  return entries
-    .sort(([, a], [, b]) => b - a)
-    .slice(0, 8)
-    .map(([name, bytes]) => {
-      const pct = ((bytes / total) * 100).toFixed(1);
-      const filled = Math.round((bytes / total) * barW);
-      const bar = "█".repeat(filled) + "░".repeat(barW - filled);
-      return `  ${name.padEnd(16)} ${bar} ${pct}%`;
-    })
-    .join("\n");
-}
-
-function formatContributors(contributors: Contributor[]): string {
-  if (contributors.length === 0) return "  (no contributor data)";
-  return contributors
-    .slice(0, 5)
-    .map((c) => `  ▲ ${c.login.padEnd(20)} ${c.contributions} commits`)
-    .join("\n");
-}
-
-function formatReadme(readme: string): string {
-  if (!readme) return "  (no README)";
-  // Strip markdown formatting for terminal display
-  const stripped = readme
-    .replace(/```[\s\S]*?```/g, "[code block]")
-    .replace(/#{1,6}\s/g, "")
-    .replace(/\*\*(.+?)\*\*/g, "$1")
-    .replace(/\[(.+?)\]\(.+?\)/g, "$1")
-    .replace(/`([^`]+)`/g, "$1")
-    .split("\n")
-    .map((l) => l.trim())
-    .filter(Boolean);
-  
-  const lines = stripped.slice(0, 30);
-  if (stripped.length > 30) lines.push("... (more lines, open in browser to read full)");
-  return lines.map((l) => `  ${l}`).join("\n");
-}
-
-/** Build the full deep-dive display text from data. */
-export function buildDeepDiveText(data: DeepDiveData): string {
-  return [
-    "── Summary ──────────────────────────────────────",
-    data.summary,
-    "",
-    "── Languages ────────────────────────────────────",
-    data.languages,
-    "",
-    "── Top Contributors ─────────────────────────────",
-    data.contributors,
-    "",
-    "── README ───────────────────────────────────────",
-    data.readme,
-  ].join("\n");
-}
+/** Repo deep-dive — fetch and format rich repo details. */
+import type { Repo } from "./types";
+import { NetworkError } from "./errors";
+
+const USER_AGENT = "ghfind/1.0";
+
+/** Language breakdown: { [lang]: bytes } */
+type LanguageMap = Record<string, number>;
+
+/** Contributor summary */
+interface Contributor {
+  login: string;
+  contributions: number;
+}
+
+/** All deep-dive data for one repo. */
+export interface DeepDiveData {
+  summary: string;
+  languages: string;
+  contributors: string;
+  readme: string;
+}
+
+/** Fetch all deep-dive data for a repo. Returns formatted sections. */
+export async function fetchDeepDive(repo: Repo, token?: string): Promise<DeepDiveData> {
+  const auth = token ? { Authorization: `Bearer ${token}` } : {};
+  const headers = { "User-Agent": USER_AGENT, ...auth };
+
+  const [languagesRes, contributorsRes] = await Promise.all([
+    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/languages`, { headers }),
+    fetch(`https://api.github.com/repos/${repo.owner}/${repo.name}/contributors?per_page=5`, { headers }),
+  ]);
+
+  // README with branch fallback: main → master → README.rst
+  let readmeText = "";
+  for (const path of [`${repo.owner}/${repo.name}/main/README.md`, `${repo.owner}/${repo.name}/master/README.md`, `${repo.owner}/${repo.name}/main/README.rst`]) {
+    const r = await fetch(`https://raw.githubusercontent.com/${path}`, { headers });
+    if (r.ok) { readmeText = await r.text(); break; }
+  }
+
+  return {
+    summary: formatSummary(repo),
+    languages: formatLanguages(languagesRes.ok ? await languagesRes.json().catch(() => ({})) : {}),
+    contributors: formatContributors(contributorsRes.ok ? await contributorsRes.json().catch(() => []) : []),
+    readme: formatReadme(readmeText),
+  };
+}
+
+function formatSummary(repo: Repo): string {
+  const lines = [
+    ` ${repo.fullName}`,
+    ` ★ ${repo.stars.toLocaleString()}  ◆ ${repo.forks.toLocaleString()}  ${repo.language ?? "—"}`,
+    repo.description ? ` ${repo.description}` : "",
+    repo.topics.length ? ` topics: ${repo.topics.slice(0, 8).join(", ")}` : "",
+    ` ${repo.url}`,
+  ];
+  return lines.filter(Boolean).join("\n");
+}
+
+function formatLanguages(langs: LanguageMap): string {
+  const entries = Object.entries(langs);
+  if (entries.length === 0) return "  (no language data)";
+  const total = entries.reduce((s, [, v]) => s + v, 0);
+  const barW = 20;
+  return entries
+    .sort(([, a], [, b]) => b - a)
+    .slice(0, 8)
+    .map(([name, bytes]) => {
+      const pct = ((bytes / total) * 100).toFixed(1);
+      const filled = Math.round((bytes / total) * barW);
+      const bar = "█".repeat(filled) + "░".repeat(barW - filled);
+      return `  ${name.padEnd(16)} ${bar} ${pct}%`;
+    })
+    .join("\n");
+}
+
+function formatContributors(contributors: Contributor[]): string {
+  if (contributors.length === 0) return "  (no contributor data)";
+  return contributors
+    .slice(0, 5)
+    .map((c) => `  ▲ ${c.login.padEnd(20)} ${c.contributions} commits`)
+    .join("\n");
+}
+
+function formatReadme(readme: string): string {
+  if (!readme) return "  (no README)";
+  // Strip markdown formatting for terminal display
+  const stripped = readme
+    .replace(/```[\s\S]*?```/g, "[code block]")
+    .replace(/#{1,6}\s/g, "")
+    .replace(/\*\*(.+?)\*\*/g, "$1")
+    .replace(/\[(.+?)\]\(.+?\)/g, "$1")
+    .replace(/`([^`]+)`/g, "$1")
+    .split("\n")
+    .map((l) => l.trim())
+    .filter(Boolean);
+  
+  const lines = stripped.slice(0, 30);
+  if (stripped.length > 30) lines.push("... (more lines, open in browser to read full)");
+  return lines.map((l) => `  ${l}`).join("\n");
+}
+
+/** Build the full deep-dive display text from data. */
+export function buildDeepDiveText(data: DeepDiveData): string {
+  return [
+    "── Summary ──────────────────────────────────────",
+    data.summary,
+    "",
+    "── Languages ────────────────────────────────────",
+    data.languages,
+    "",
+    "── Top Contributors ─────────────────────────────",
+    data.contributors,
+    "",
+    "── README ───────────────────────────────────────",
+    data.readme,
+  ].join("\n");
+}

package/src/errors.ts

@@ -1,62 +1,59 @@
-/**
- * Structured error types with user-facing messages.
- * Every error knows what to tell the user and (optionally) what to do next.
- */
-
-export class SearchCliError extends Error {
-  constructor(
-    message: string,
-    public readonly userMessage: string,
-    public readonly recoverable: boolean = true,
-  ) {
-    super(message);
-    this.name = "SearchCliError";
-  }
-}
-
-export class NetworkError extends SearchCliError {
-  constructor() {
-    super(
-      "Network request failed",
-      "⚠ Network error — check your connection. Retrying in 5s... [r]etry now",
-    );
-    this.name = "NetworkError";
-  }
-}
-
-export class RateLimitError extends SearchCliError {
-  constructor(public readonly hasToken: boolean, resetSeconds?: number) {
-    const msg = hasToken
-      ? `⚠ API rate limit exceeded (5,000/hr). Resets in ${resetSeconds ?? "?"}s. [r]etry [c]hange token`
-      : "⚠ Rate limited (60/hr). Set GITHUB_TOKEN for 5,000/hr. [r]etry";
-    super(msg, msg);
-    this.name = "RateLimitError";
-  }
-}
-
-export class BadQueryError extends SearchCliError {
-  constructor(public readonly detail: string) {
-    super(`Invalid query: ${detail}`, `⚠ Invalid query: ${detail}`);
-    this.name = "BadQueryError";
-  }
-}
-
-export class NoResultsError extends SearchCliError {
-  constructor(public readonly query: string) {
-    super(
-      `No results for "${query}"`,
-      `🔍 No results for "${query}". Tips: check spelling, try fewer qualifiers, or [b]rowse trending`,
-    );
-    this.name = "NoResultsError";
-  }
-}
-
-export class ParseError extends SearchCliError {
-  constructor(source: string, detail: string) {
-    super(
-      `Parse error from ${source}: ${detail}`,
-      `⚠ Could not parse ${source}. GitHub may have changed the layout. [r]etry`,
-    );
-    this.name = "ParseError";
-  }
-}
+/** Structured error types with user-facing messages. */
+
+export class SearchCliError extends Error {
+  constructor(
+    message: string,
+    public readonly userMessage: string,
+    public readonly recoverable: boolean = true,
+  ) {
+    super(message);
+    this.name = "SearchCliError";
+  }
+}
+
+export class NetworkError extends SearchCliError {
+  constructor() {
+    super(
+      "Network request failed",
+      "⚠ Network error — check your connection. Retrying in 5s... [r]etry now",
+    );
+    this.name = "NetworkError";
+  }
+}
+
+export class RateLimitError extends SearchCliError {
+  constructor(public readonly hasToken: boolean, resetSeconds?: number) {
+    const msg = hasToken
+      ? `⚠ API rate limit exceeded (5,000/hr). Resets in ${resetSeconds ?? "?"}s. [r]etry [c]hange token`
+      : "⚠ Rate limited (60/hr). Set GITHUB_TOKEN for 5,000/hr. [r]etry";
+    super(msg, msg);
+    this.name = "RateLimitError";
+  }
+}
+
+export class BadQueryError extends SearchCliError {
+  constructor(public readonly detail: string) {
+    super(`Invalid query: ${detail}`, `⚠ Invalid query: ${detail}`);
+    this.name = "BadQueryError";
+  }
+}
+
+export class NoResultsError extends SearchCliError {
+  constructor(public readonly query: string) {
+    super(
+      `No results for "${query}"`,
+      `🔍 No results for "${query}". Tips: check spelling, try fewer qualifiers, or [b]rowse trending`,
+    );
+    this.name = "NoResultsError";
+  }
+}
+
+export class ParseError extends SearchCliError {
+  constructor(source: string, detail: string) {
+    super(
+      `Parse error from ${source}: ${detail}`,
+      `⚠ Could not parse ${source}. GitHub may have changed the layout. [r]etry`,
+    );
+    this.name = "ParseError";
+  }
+}

package/src/explore.ts

@@ -1,30 +1,29 @@
-/**
- * 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 {
-  name: string;
-  description: string;
-  repoCount: number;
-}
-
-/** Fetch popular topics from GitHub search API.
- *  Requires the `mercy-preview` media type for the /search/topics endpoint.
- */
-export async function fetchTopics(): Promise<TopicItem[]> {
-  const res = await fetch("https://api.github.com/search/topics?q=popular&per_page=30", {
-    headers: {
-      Accept: "application/vnd.github.mercy-preview+json",
-      "User-Agent": "search-cli",
-    },
-  });
-  if (!res.ok) throw new Error(`Topics API: HTTP ${res.status}`);
-  const data = await res.json() as { items?: Array<{ name: string; description?: string; score?: number }> };
-  return (data.items ?? []).map((item) => ({
-    name: item.name,
-    description: item.description || "",
-    repoCount: item.score || 0,
-  }));
-}
+/**
+ * Topic explorer — browse popular GitHub topics.
+ * 
+ * Selecting a topic triggers a search.
+ */
+export interface TopicItem {
+  name: string;
+  description: string;
+  repoCount: number;
+}
+
+/** Fetch popular topics from GitHub search API.
+ *  Requires the `mercy-preview` media type for the /search/topics endpoint.
+ */
+export async function fetchTopics(): Promise<TopicItem[]> {
+  const res = await fetch("https://api.github.com/search/topics?q=popular&per_page=30", {
+    headers: {
+      Accept: "application/vnd.github.mercy-preview+json",
+      "User-Agent": "search-cli",
+    },
+  });
+  if (!res.ok) throw new Error(`Topics API: HTTP ${res.status}`);
+  const data = await res.json() as { items?: Array<{ name: string; description?: string; score?: number }> };
+  return (data.items ?? []).map((item) => ({
+    name: item.name,
+    description: item.description || "",
+    repoCount: item.score || 0,
+  }));
+}