github-search-cli 0.7.0 → 0.8.0

package/src/export.ts

@@ -1,64 +1,63 @@
-/**
- * Export — format repos as JSON, CSV, Markdown, or plain text.
- */
-import { writeFileSync } from "fs";
-import type { Repo } from "./types.ts";
-
-export type ExportFormat = "json" | "csv" | "markdown" | "text";
-
-/** Format repos as JSON string. */
-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 = `./search-cli-export-${ts}.${ext}`;
-  writeFileSync(path, formatRepos(repos, format), "utf-8");
-  return path;
-}
+/**
+ * Export — format repos as JSON, CSV, Markdown, or plain text.
+ */
+import { writeFileSync } from "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/help.ts

@@ -1,9 +1,4 @@
-/**
- * Help screen — structured sections rendered by OpenTUI components.
- *
- * Each section has a title (with category color) and formatted rows.
- * The TUI builds these into Box + TextRenderable components inside a ScrollBox.
- */
+/** Help screen — structured sections rendered by OpenTUI components. */
 
 export interface HelpRow {
   keys: string;
@@ -25,23 +20,20 @@ export function buildHelpSections(): HelpSection[] {
       titleColor: "blue",
       rows: [
         { keys: "↑ ↓ / j k", action: "Move selection" },
-        { keys: "Enter / o", action: "Open repo in browser" },
+        { keys: "Enter", action: "Open repo in browser" },
         { keys: "/", action: "Focus search input" },
-        { keys: "t", action: "Toggle search / trending" },
+        { keys: "Space", action: "Open command menu" },
         { keys: "? / Ctrl+H", action: "Toggle this help screen" },
         { keys: "q", action: "Quit" },
       ],
     },
     {
-      title: " Search Mode ",
+      title: " Main View ",
       titleColor: "green",
       rows: [
-        { keys: "s", action: "Cycle sort: best-match → stars → …" },
-        { keys: "l", action: "Cycle limit: 10 → 25 → 50 → 100" },
-        { keys: "r", action: "Refresh / re-run last search" },
-        { keys: "g", action: "Toggle activity graph fullscreen" },
         { keys: "Tab", action: "Auto-complete qualifier" },
-        { keys: "b", action: "Bookmark / unbookmark selected repo" },
+        { keys: "PageDown", action: "Next page of results" },
+        { keys: "PageUp", action: "Scroll to top of results" },
       ],
     },
     {
@@ -50,32 +42,32 @@ export function buildHelpSections(): HelpSection[] {
       rows: [
         { keys: "1-5", action: "Switch tab: Today → Week → Month → …" },
         { keys: "← → / h l", action: "Navigate tabs" },
-        { keys: "r", action: "Refresh" },
       ],
     },
     {
-      title: " Power Tools ",
+      title: " Command Menu (Space)",
       titleColor: "purple",
       rows: [
-        { keys: "d", action: "Deep-dive: README + commit activity" },
-        { keys: "c", action: "Add/remove repo from comparison" },
-        { keys: "C (Shift+c)", action: "Show comparison view" },
-        { keys: "E (Shift+e)", action: "Topic explorer" },
-        { keys: "B (Shift+b)", action: "Bookmarks panel" },
-        { keys: "PageDown / Ctrl+F", action: "Next page of results" },
-        { keys: "PageUp / Ctrl+B", action: "Scroll to top of results" },
+        { keys: "Sort", action: "Cycle sort: best-match → stars → …" },
+        { keys: "Limit", action: "Cycle limit: 10 → 25 → 50 → 100" },
+        { keys: "Refresh", action: "Re-run current search" },
+        { keys: "Graph", action: "Toggle commit activity chart" },
+        { keys: "Readme", action: "Full README viewer" },
+        { keys: "Deep-dive", action: "Languages + contributors + excerpt" },
+        { keys: "Bookmark", action: "Save / unsave selected repo" },
+        { keys: "Compare", action: "Add to / remove from comparison" },
+        { keys: "Trending", action: "Switch to trending browser" },
       ],
+      note: "Also: Open, History, Export, Share, Topics, Saved, Notifs, Help",
     },
     {
-      title: " Overlays ",
+      title: " Overlay Keys ",
       titleColor: "teal",
       rows: [
-        { keys: "Ctrl+R", action: "Search history" },
-        { keys: "Ctrl+O", action: "Saved searches" },
-        { keys: "Ctrl+E", action: "Export results" },
-        { keys: "Ctrl+N", action: "Notifications" },
-        { keys: "Ctrl+S", action: "Save current search" },
-        { keys: "Ctrl+P", action: "Share selected repo" },
+        { keys: "Esc / q", action: "Close any overlay" },
+        { keys: "Enter", action: "Confirm selection / run action" },
+        { keys: "d", action: "Delete entry (history, bookmarks, saved)" },
+        { keys: "↑ ↓ / j k", action: "Navigate overlay list" },
       ],
     },
     {

package/src/history.ts

@@ -1,91 +1,91 @@
-/**
- * Persistent search history — append-only JSONL with rotation.
- */
-import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, unlinkSync } from "fs";
-import { join } from "path";
-import type { HistoryEntry } from "./types.ts";
-import { stateDir } from "./config.ts";
-
-const HISTORY_FILE = join(stateDir(), "history.jsonl");
-const MAX_ENTRIES = 500;
-
-function ensureDir() {
-  mkdirSync(stateDir(), { recursive: true });
-}
-
-/** Append one entry to the history log. */
-export function appendHistory(entry: HistoryEntry): void {
-  ensureDir();
-  const line = JSON.stringify(entry) + "\n";
-  try {
-    appendFileSync(HISTORY_FILE, line, "utf-8");
-  } catch {
-    // non-critical
-  }
-}
-
-/** Read all history entries, newest first, deduplicating consecutive identical queries. */
-export function readHistory(): HistoryEntry[] {
-  try {
-    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
-    if (!raw) return [];
-    const lines = raw.split("\n").filter(Boolean);
-    const entries: HistoryEntry[] = lines.map((l) => JSON.parse(l) as HistoryEntry);
-
-    // Sorted oldest-first in file; reverse to newest-first
-    entries.reverse();
-
-    // Deduplicate consecutive identical queries (keep newest)
-    const deduped: HistoryEntry[] = [];
-    let lastQuery: string | undefined;
-    for (const e of entries) {
-      if (e.query !== lastQuery) {
-        deduped.push(e);
-        lastQuery = e.query;
-      }
-    }
-    return deduped;
-  } catch {
-    return [];
-  }
-}
-
-/** Delete a single history entry by index (0 = newest). */
-export function deleteHistoryEntry(index: number): void {
-  const entries = readHistory();
-  if (index < 0 || index >= entries.length) return;
-  const removed = entries[index];
-  // Rewrite file without the removed entry
-  const remaining = entries.filter((e) => e.timestamp !== removed.timestamp || e.query !== removed.query);
-  ensureDir();
-  // Reverse back to oldest-first for file order
-  writeFileSync(HISTORY_FILE, remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
-}
-
-/** Clear all history. */
-export function clearHistory(): void {
-  try {
-    writeFileSync(HISTORY_FILE, "");
-  } catch {
-    // non-critical
-  }
-}
-
-/** Rotate history to max entries (trim oldest). */
-export function rotateHistory(): void {
-  const entries = readHistory();
-  if (entries.length <= MAX_ENTRIES) return;
-  const trimmed = entries.slice(0, MAX_ENTRIES);
-  ensureDir();
-  writeFileSync(HISTORY_FILE, trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
-}
-
-/** Count entries in history file. */
-export function historyCount(): number {
-  try {
-    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
-    return raw ? raw.split("\n").length : 0;
-  } catch {
-    return 0;
-  }
-}
+/**
+ * Persistent search history — append-only JSONL with rotation.
+ */
+import { existsSync, mkdirSync, readFileSync, appendFileSync, writeFileSync, unlinkSync } from "fs";
+import { join } from "path";
+import type { HistoryEntry } from "./types";
+import { stateDir } from "./config";
+
+const HISTORY_FILE = join(stateDir(), "history.jsonl");
+const MAX_ENTRIES = 500;
+
+function ensureDir() {
+  mkdirSync(stateDir(), { recursive: true });
+}
+
+/** Append one entry to the history log. */
+export function appendHistory(entry: HistoryEntry): void {
+  ensureDir();
+  const line = JSON.stringify(entry) + "\n";
+  try {
+    appendFileSync(HISTORY_FILE, line, "utf-8");
+  } catch {
+    // non-critical
+  }
+}
+
+/** Read all history entries, newest first, deduplicating consecutive identical queries. */
+export function readHistory(): HistoryEntry[] {
+  try {
+    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
+    if (!raw) return [];
+    const lines = raw.split("\n").filter(Boolean);
+    const entries: HistoryEntry[] = lines.map((l) => JSON.parse(l) as HistoryEntry);
+
+    // Sorted oldest-first in file; reverse to newest-first
+    entries.reverse();
+
+    // Deduplicate consecutive identical queries (keep newest)
+    const deduped: HistoryEntry[] = [];
+    let lastQuery: string | undefined;
+    for (const e of entries) {
+      if (e.query !== lastQuery) {
+        deduped.push(e);
+        lastQuery = e.query;
+      }
+    }
+    return deduped;
+  } catch {
+    return [];
+  }
+}
+
+/** Delete a single history entry by index (0 = newest). */
+export function deleteHistoryEntry(index: number): void {
+  const entries = readHistory();
+  if (index < 0 || index >= entries.length) return;
+  const removed = entries[index];
+  // Rewrite file without the removed entry
+  const remaining = entries.filter((e) => e.timestamp !== removed.timestamp || e.query !== removed.query);
+  ensureDir();
+  // Reverse back to oldest-first for file order
+  writeFileSync(HISTORY_FILE, remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
+}
+
+/** Clear all history. */
+export function clearHistory(): void {
+  try {
+    writeFileSync(HISTORY_FILE, "");
+  } catch {
+    // non-critical
+  }
+}
+
+/** Rotate history to max entries (trim oldest). */
+export function rotateHistory(): void {
+  const entries = readHistory();
+  if (entries.length <= MAX_ENTRIES) return;
+  const trimmed = entries.slice(0, MAX_ENTRIES);
+  ensureDir();
+  writeFileSync(HISTORY_FILE, trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n");
+}
+
+/** Count entries in history file. */
+export function historyCount(): number {
+  try {
+    const raw = readFileSync(HISTORY_FILE, "utf-8").trim();
+    return raw ? raw.split("\n").length : 0;
+  } catch {
+    return 0;
+  }
+}

package/src/init.ts

@@ -1,55 +1,55 @@
-/**
- * `search-cli init` wizard — interactive one-time config setup.
- * 
- * ponytail: simple stdin prompts, no curses/readline UI.
- */
-import { createInterface } from "readline";
-import { saveConfig } from "./config.ts";
-import { listThemes } from "./themes.ts";
-import type { Config, SortStrategy } from "./types.ts";
-
-function ask(query: string): Promise<string> {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(query, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-export async function runInitWizard(): Promise<void> {
-  console.log("");
-  console.log("  search-cli setup wizard");
-  console.log("  ──────────────────────");
-  console.log("");
-
-  const token = await ask("  GitHub token (optional, press Enter to skip): ");
-  if (token && !token.startsWith("ghp_") && !token.startsWith("github_pat_") && !token.startsWith("gho_")) {
-    console.log("  ⚠ Token doesn't look like a GitHub token (should start with ghp_, gho_, or github_pat_)");
-  }
-
-  const sortStr = await ask("  Default sort [best-match/stars/updated/forks] (best-match): ");
-  const limitStr = await ask("  Default result limit [10-100] (50): ");
-
-  const themes = listThemes();
-  const themeStr = await ask(`  Theme [${themes.join("/")}] (tokyo-night): `);
-
-  const config: Config = {
-    defaultSort: (["best-match", "stars", "updated", "forks"].includes(sortStr)
-      ? sortStr
-      : "best-match") as SortStrategy,
-    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr) || 50)),
-    theme: themes.includes(themeStr) ? themeStr : "tokyo-night",
-    cacheTtlSeconds: 300,
-    defaultTab: "search",
-  };
-
-  if (token) config.githubToken = token;
-
-  saveConfig(config);
-  const { configPath } = await import("./config.ts");
-  console.log(`  ✓ Config saved to ${configPath()}`);
-  console.log("  Run 'search-cli' to start browsing!");
-  console.log("");
-}
+/**
+ * `ghfind init` wizard — interactive one-time config setup.
+ * 
+ * ponytail: simple stdin prompts, no curses/readline UI.
+ */
+import { createInterface } from "readline";
+import { saveConfig } from "./config";
+import { listThemes } from "./themes";
+import type { Config, SortStrategy } from "./types";
+
+function ask(query: string): Promise<string> {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(query, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+export async function runInitWizard(): Promise<void> {
+  console.log("");
+  console.log("  ghfind setup wizard");
+  console.log("  ──────────────────────");
+  console.log("");
+
+  const token = await ask("  GitHub token (optional, press Enter to skip): ");
+  if (token && !token.startsWith("ghp_") && !token.startsWith("github_pat_") && !token.startsWith("gho_")) {
+    console.log("  ⚠ Token doesn't look like a GitHub token (should start with ghp_, gho_, or github_pat_)");
+  }
+
+  const sortStr = await ask("  Default sort [best-match/stars/updated/forks] (best-match): ");
+  const limitStr = await ask("  Default result limit [10-100] (50): ");
+
+  const themes = listThemes();
+  const themeStr = await ask(`  Theme [${themes.join("/")}] (tokyo-night): `);
+
+  const config: Config = {
+    defaultSort: (["best-match", "stars", "updated", "forks"].includes(sortStr)
+      ? sortStr
+      : "best-match") as SortStrategy,
+    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr) || 50)),
+    theme: themes.includes(themeStr) ? themeStr : "tokyo-night",
+    cacheTtlSeconds: 300,
+    defaultTab: "search",
+  };
+
+  if (token) config.githubToken = token;
+
+  saveConfig(config);
+  const { configPath } = await import("./config.ts");
+  console.log(`  ✓ Config saved to ${configPath()}`);
+  console.log("  Run 'ghfind' to start browsing!");
+  console.log("");
+}

package/src/notifications.ts

@@ -1,69 +1,65 @@
-/**
- * Notification center — ephemeral alerts for rate limits, watch changes, etc.
- * 
- * ponytail: in-memory + last-session persistence. Skip 24h auto-clean.
- */
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-import { stateDir } from "./config.ts";
-
-export interface Notification {
-  id: number;
-  type: "info" | "warning" | "rate-limit" | "watch-change" | "upgrade";
-  icon: string;
-  message: string;
-  timestamp: number;
-}
-
-let nextId = 1;
-let notifs: Notification[] = [];
-const MAX_NOTIFS = 50;
-const FILE = join(stateDir(), "notifications.json");
-
-function load(): void {
-  try {
-    notifs = JSON.parse(readFileSync(FILE, "utf-8"));
-    nextId = (Math.max(...notifs.map((n) => n.id), 0) + 1);
-  } catch {
-    notifs = [];
-  }
-}
-
-function save(): void {
-  mkdirSync(stateDir(), { recursive: true });
-  writeFileSync(FILE, JSON.stringify(notifs));
-}
-
-export function addNotification(type: Notification["type"], message: string): Notification {
-  if (notifs.length === 0) load();
-  const n: Notification = { id: nextId++, type, icon: iconFor(type), message, timestamp: Date.now() };
-  notifs.unshift(n);
-  if (notifs.length > MAX_NOTIFS) notifs = notifs.slice(0, MAX_NOTIFS);
-  save();
-  return n;
-}
-
-function iconFor(type: Notification["type"]): string {
-  switch (type) {
-    case "info": return "ℹ";
-    case "warning": return "⚠";
-    case "rate-limit": return "🚫";
-    case "watch-change": return "🔔";
-    case "upgrade": return "📦";
-  }
-}
-
-export function getNotifications(): Notification[] {
-  if (notifs.length === 0) load();
-  return [...notifs];
-}
-
-export function dismissNotification(id: number): void {
-  notifs = notifs.filter((n) => n.id !== id);
-  save();
-}
-
-export function dismissAll(): void {
-  notifs = [];
-  save();
-}
+/** Notification center — ephemeral alerts for rate limits, watch changes, etc. */
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { stateDir } from "./config";
+
+export interface Notification {
+  id: number;
+  type: "info" | "warning" | "rate-limit" | "watch-change" | "upgrade";
+  icon: string;
+  message: string;
+  timestamp: number;
+}
+
+let nextId = 1;
+let notifs: Notification[] = [];
+const MAX_NOTIFS = 50;
+const FILE = join(stateDir(), "notifications.json");
+
+function load(): void {
+  try {
+    notifs = JSON.parse(readFileSync(FILE, "utf-8"));
+    nextId = (Math.max(...notifs.map((n) => n.id), 0) + 1);
+  } catch {
+    notifs = [];
+  }
+}
+
+function save(): void {
+  mkdirSync(stateDir(), { recursive: true });
+  writeFileSync(FILE, JSON.stringify(notifs));
+}
+
+export function addNotification(type: Notification["type"], message: string): Notification {
+  if (notifs.length === 0) load();
+  const n: Notification = { id: nextId++, type, icon: iconFor(type), message, timestamp: Date.now() };
+  notifs.unshift(n);
+  if (notifs.length > MAX_NOTIFS) notifs = notifs.slice(0, MAX_NOTIFS);
+  save();
+  return n;
+}
+
+function iconFor(type: Notification["type"]): string {
+  switch (type) {
+    case "info": return "ℹ";
+    case "warning": return "⚠";
+    case "rate-limit": return "🚫";
+    case "watch-change": return "🔔";
+    case "upgrade": return "📦";
+  }
+}
+
+export function getNotifications(): Notification[] {
+  if (notifs.length === 0) load();
+  return [...notifs];
+}
+
+export function dismissNotification(id: number): void {
+  notifs = notifs.filter((n) => n.id !== id);
+  save();
+}
+
+export function dismissAll(): void {
+  notifs = [];
+  save();
+}