github-search-cli 0.6.1 → 0.8.0

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();
+}

package/src/open-url.ts

@@ -0,0 +1,16 @@
+/**
+ * Open a URL in the user's default browser — platform-aware.
+ *
+ * only if the open/xdg-open pattern fails somewhere.
+ */
+
+export function openUrl(url: string): void {
+  try {
+    const p = process.platform;
+    if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
+    else if (p === "darwin") Bun.spawn(["open", url]);
+    else Bun.spawn(["xdg-open", url]);
+  } catch {
+    // non-critical — user can copy the URL manually
+  }
+}

package/src/output.ts

@@ -1,74 +1,68 @@
-/**
- * Output layer: render ranked results either as machine-readable JSON or as a
- * concise, human-readable list. This layer owns all presentation concerns so
- * the search/ranking logic stays presentation-free.
- */
-import type { Repo, SearchResponse } from "./types.ts";
-
-/** Format a number compactly (e.g. 1234 -> "1.2k"). */
-export function formatCount(n: number): string {
-  if (n < 1000) return String(n);
-  if (n < 1_000_000) return `${(n / 1000).toFixed(1).replace(/\.0$/, "")}k`;
-  return `${(n / 1_000_000).toFixed(1).replace(/\.0$/, "")}M`;
-}
-
-/** Format an ISO date as YYYY-MM-DD. */
-export function formatDate(iso: string): string {
-  const d = new Date(iso);
-  if (isNaN(d.getTime())) return "unknown";
-  return d.toISOString().slice(0, 10);
-}
-
-/** Emit stable, parseable JSON. */
-export function renderJson(response: SearchResponse, rawQuery: string): string {
-  return JSON.stringify(
-    {
-      query: rawQuery,
-      totalCount: response.totalCount,
-      count: response.repos.length,
-      rateLimited: response.rateLimited,
-      results: response.repos,
-    },
-    null,
-    2,
-  );
-}
-
-/** Emit a concise, readable list for terminals. */
-export function renderHuman(response: SearchResponse, rawQuery: string): string {
-  const lines: string[] = [];
-  lines.push(`Query: ${rawQuery}`);
-  lines.push(`Matches: ${response.repos.length} (total available: ${response.totalCount})`);
-  if (response.rateLimited) {
-    lines.push("⚠ Rate limit hit — results may be incomplete. Set GITHUB_TOKEN to raise limits.");
-  }
-  lines.push("");
-
-  if (response.repos.length === 0) {
-    lines.push("No repositories found.");
-    return lines.join("\n");
-  }
-
-  response.repos.forEach((repo, i) => {
-    lines.push(renderRepo(i + 1, repo));
-    lines.push("");
-  });
-
-  return lines.join("\n").trimEnd();
-}
-
-function renderRepo(index: number, repo: Repo): string {
-  const lang = repo.language ?? "—";
-  const stars = formatCount(repo.stars);
-  const updated = formatDate(repo.updatedAt);
-  const tags: string[] = [];
-  if (repo.archived) tags.push("archived");
-  if (repo.isFork) tags.push("fork");
-  const tagStr = tags.length ? ` [${tags.join(", ")}]` : "";
-
-  const header = `${index}. ${repo.fullName}${tagStr}`;
-  const meta = `   ★ ${stars}  •  ${lang}  •  updated ${updated}`;
-  const desc = repo.description ? `   ${repo.description}` : "   (no description)";
-  const url = `   ${repo.url}`;
-  return [header, meta, desc, url].join("\n");
+/** Output layer: render ranked results as JSON or human-readable list. */
+import type { Repo, SearchResponse } from "./types";
+
+/** Format a number compactly (e.g. 1234 -> "1.2k", 999999 -> "1M"). */
+export function formatCount(n: number): string {
+  if (n < 1000) return String(n);
+  if (n >= 999_500) return "1M"; // ponytail: round 999500+ up before showing 1000k
+  if (n < 1_000_000) return `${(n / 1000).toFixed(1).replace(/\.0$/, "")}k`;
+  return `${(n / 1_000_000).toFixed(1).replace(/\.0$/, "")}M`;
+}
+
+export function formatDate(iso: string): string {
+  const d = new Date(iso);
+  if (isNaN(d.getTime())) return "unknown";
+  return d.toISOString().slice(0, 10);
+}
+
+export function renderJson(response: SearchResponse, rawQuery: string): string {
+  return JSON.stringify(
+    {
+      query: rawQuery,
+      totalCount: response.totalCount,
+      count: response.repos.length,
+      rateLimited: response.rateLimited,
+      results: response.repos,
+    },
+    null,
+    2,
+  );
+}
+
+export function renderHuman(response: SearchResponse, rawQuery: string): string {
+  const lines: string[] = [];
+  lines.push(`Query: ${rawQuery}`);
+  lines.push(`Matches: ${response.repos.length} (total available: ${response.totalCount})`);
+  if (response.rateLimited) {
+    lines.push("⚠ Rate limit hit — results may be incomplete. Set GITHUB_TOKEN to raise limits.");
+  }
+  lines.push("");
+
+  if (response.repos.length === 0) {
+    lines.push("No repositories found.");
+    return lines.join("\n");
+  }
+
+  response.repos.forEach((repo, i) => {
+    lines.push(renderRepo(i + 1, repo));
+    lines.push("");
+  });
+
+  return lines.join("\n").trimEnd();
+}
+
+function renderRepo(index: number, repo: Repo): string {
+  const lang = repo.language ?? "—";
+  const stars = formatCount(repo.stars);
+  const updated = formatDate(repo.updatedAt);
+  const tags: string[] = [];
+  if (repo.archived) tags.push("archived");
+  if (repo.isFork) tags.push("fork");
+  const tagStr = tags.length ? ` [${tags.join(", ")}]` : "";
+
+  const header = `${index}. ${repo.fullName}${tagStr}`;
+  const meta = `   ★ ${stars}  •  ${lang}  •  updated ${updated}`;
+  const desc = repo.description ? `   ${repo.description}` : "   (no description)";
+  const url = `   ${repo.url}`;
+  return [header, meta, desc, url].join("\n");
 }

package/src/pipe.ts

@@ -1,65 +1,54 @@
-/**
- * Pipe-friendly format modifiers — output repo data as lines for shell piping.
- */
-import type { Repo } from "./types.ts";
-
-export type FormatLine = "urls" | "names" | "ssh-urls" | "clone-commands" | "ids";
-
-/** Format repos as one URL per line. */
-export function formatUrls(repos: Repo[]): string {
-  return repos.map((r) => r.url).join("\n");
-}
-
-/** Format repos as one owner/repo per line. */
-export function formatNames(repos: Repo[]): string {
-  return repos.map((r) => r.fullName).join("\n");
-}
-
-/** Format repos as one git@github.com URL per line. */
-export function formatSshUrls(repos: Repo[]): string {
-  return repos.map((r) => `git@github.com:${r.fullName}.git`).join("\n");
-}
-
-/** Format repos as ready-to-paste git clone commands. */
-export function formatCloneCommands(repos: Repo[]): string {
-  return repos.map((r) => `git clone git@github.com:${r.fullName}.git`).join("\n");
-}
-
-/** Format repos as GitHub repo IDs, one per line. */
-export function formatIds(repos: Repo[]): string {
-  return repos.map((r) => String(r.id)).join("\n");
-}
-
-/** Format repos in the given line format. */
-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;
-    }
-  }
-}
-
-async function openUrl(url: string): Promise<void> {
-  const p = process.platform;
-  const args = p === "win32" ? ["cmd", "/c", "start", "", url]
-    : p === "darwin" ? ["open", url]
-    : ["xdg-open", url];
-  Bun.spawn(args);
-}
+/**
+ * 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/saved-searches.ts

@@ -1,58 +1,58 @@
-/**
- * Saved searches — named queries you can re-run anytime.
- */
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-import type { SavedSearch, SortStrategy } from "./types.ts";
-import { stateDir } from "./config.ts";
-
-const SAVED_FILE = join(stateDir(), "saved-searches.json");
-
-function loadRaw(): SavedSearch[] {
-  mkdirSync(stateDir(), { recursive: true });
-  try {
-    return JSON.parse(readFileSync(SAVED_FILE, "utf-8")) as SavedSearch[];
-  } catch {
-    return [];
-  }
-}
-
-function saveRaw(searches: SavedSearch[]): void {
-  mkdirSync(stateDir(), { recursive: true });
-  writeFileSync(SAVED_FILE, JSON.stringify(searches, null, 2));
-}
-
-/** Get all saved searches, sorted by last run time (most recent first). */
-export function getSavedSearches(): SavedSearch[] {
-  return loadRaw().sort((a, b) => (b.lastRunAt ?? b.createdAt) - (a.lastRunAt ?? a.createdAt));
-}
-
-/** Save a new search. Overwrites if name already exists. */
-export function saveSearch(name: string, query: string, mode: "search" | "trending", sort: SortStrategy, limit: number, tab?: string): SavedSearch {
-  const searches = loadRaw();
-  const now = Date.now();
-  const existing = searches.findIndex((s) => s.name === name);
-  const entry: SavedSearch = { name, query, mode, sort, limit, tab, createdAt: now, lastRunAt: now };
-  if (existing >= 0) {
-    searches[existing] = { ...searches[existing], ...entry, createdAt: searches[existing].createdAt };
-  } else {
-    searches.push(entry);
-  }
-  saveRaw(searches);
-  return entry;
-}
-
-/** Delete a saved search by name. */
-export function deleteSavedSearch(name: string): void {
-  saveRaw(loadRaw().filter((s) => s.name !== name));
-}
-
-/** Update lastRunAt for a saved search. */
-export function touchSavedSearch(name: string): void {
-  const searches = loadRaw();
-  const found = searches.find((s) => s.name === name);
-  if (found) {
-    found.lastRunAt = Date.now();
-    saveRaw(searches);
-  }
-}
+/**
+ * Saved searches — named queries you can re-run anytime.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import type { SavedSearch, SortStrategy } from "./types";
+import { stateDir } from "./config";
+
+const SAVED_FILE = join(stateDir(), "saved-searches.json");
+
+function loadRaw(): SavedSearch[] {
+  mkdirSync(stateDir(), { recursive: true });
+  try {
+    return JSON.parse(readFileSync(SAVED_FILE, "utf-8")) as SavedSearch[];
+  } catch {
+    return [];
+  }
+}
+
+function saveRaw(searches: SavedSearch[]): void {
+  mkdirSync(stateDir(), { recursive: true });
+  writeFileSync(SAVED_FILE, JSON.stringify(searches, null, 2));
+}
+
+/** Get all saved searches, sorted by last run time (most recent first). */
+export function getSavedSearches(): SavedSearch[] {
+  return loadRaw().sort((a, b) => (b.lastRunAt ?? b.createdAt) - (a.lastRunAt ?? a.createdAt));
+}
+
+/** Save a new search. Overwrites if name already exists. */
+export function saveSearch(name: string, query: string, mode: "search" | "trending", sort: SortStrategy, limit: number, tab?: string): SavedSearch {
+  const searches = loadRaw();
+  const now = Date.now();
+  const existing = searches.findIndex((s) => s.name === name);
+  const entry: SavedSearch = { name, query, mode, sort, limit, tab, createdAt: now, lastRunAt: now };
+  if (existing >= 0) {
+    searches[existing] = { ...searches[existing], ...entry, createdAt: searches[existing].createdAt };
+  } else {
+    searches.push(entry);
+  }
+  saveRaw(searches);
+  return entry;
+}
+
+/** Delete a saved search by name. */
+export function deleteSavedSearch(name: string): void {
+  saveRaw(loadRaw().filter((s) => s.name !== name));
+}
+
+/** Update lastRunAt for a saved search. */
+export function touchSavedSearch(name: string): void {
+  const searches = loadRaw();
+  const found = searches.find((s) => s.name === name);
+  if (found) {
+    found.lastRunAt = Date.now();
+    saveRaw(searches);
+  }
+}