github-search-cli 9.4.3 → 9.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-search-cli",
-  "version": "9.4.3",
+  "version": "9.5.0",
   "description": "Search GitHub from your terminal — repo search, trending repos, npm package search, bookmarks, deep-dive, compare, export. Keyboard-driven TUI + pipeable CLI.",
   "type": "module",
   "packageManager": "bun@1",

package/release-notes/9.5.0.md

@@ -0,0 +1,30 @@
+# What's New in ghfind 9.5.0
+
+User profiles from the terminal, plus an org-lookup fix.
+
+### Added
+
+**`ghfind user <name>`** — the user-side counterpart to `ghfind org <name>`
+
+- Fetches a GitHub user's metadata and public repos from the REST API and
+  aggregates them into one summary: public repo count, total stars/forks of
+  the fetched repos, followers/following, top languages by repo count,
+  top 5 repos by stars, and the 5 most recently pushed repos
+- `ghfind user torvalds`, `ghfind user @torvalds` (leading `@` stripped)
+- Same output flags as `org`: `--json`, `--csv`, `--markdown`, `--count`,
+  `--limit`, `--token`
+- Organization / Bot accounts are labeled with an `[org]` / `[bot]` badge in
+  text output; site admins get `[staff]`
+
+### Fixed
+
+- `ghfind org <name>` joined multi-word names with dashes (`"in tech"` →
+  `in-tech`) — now joined with spaces, which the API handles. Single-token
+  org lookups are unaffected.
+
+### Internal
+
+- `src/user.ts` mirrors the org-profile module shape: pure normalize/aggregate
+  functions, thin formatters, graceful degradation when the repos request
+  fails (user metadata is still returned)
+- 27 new tests in `tests/user.test.ts`

package/src/cli.ts

@@ -36,6 +36,13 @@ import {
   formatOrgMarkdown,
   formatOrgText,
 } from "./org";
+import {
+  fetchUserProfile,
+  formatUserCsv,
+  formatUserJson,
+  formatUserMarkdown,
+  formatUserText,
+} from "./user";
 import { checkAndNotify, allCachedReleases } from "./releases";
 import { runInitWizard } from "./init";
 import { runLoginWizard } from "./login";
@@ -79,6 +86,7 @@ interface CLIFlags {
   compare: string[]; // repo fullNames to compare
   doctor: boolean;
   org?: string; // org profile lookup (ghfind org <name>)
+  user?: string; // user profile lookup (ghfind user <name>)
 }
 
 function parseArgs(args: string[]): CLIFlags {
@@ -184,12 +192,22 @@ function parseArgs(args: string[]): CLIFlags {
         flags.completion = args[++i];
         break;
       case "org": {
-        // Collect org name until next flag (allows multi-word quoted names)
+        // Collect org name until next flag (single token — GitHub org logins
+        // contain no spaces; a quoted multi-word name is an error)
         const parts: string[] = [];
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
           parts.push(args[++i]);
         }
-        flags.org = parts.join("-");
+        flags.org = parts.join(" ");
+        break;
+      }
+      case "user": {
+        // Collect user name until next flag (single token, same as org)
+        const userParts: string[] = [];
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          userParts.push(args[++i]);
+        }
+        flags.user = userParts.join(" ");
         break;
       }
       case "--compare": {
@@ -245,6 +263,8 @@ Usage:
   ghfind --releases                Check bookmarks for new releases
   ghfind --compare <repo1> <repo2> Compare two+ repos side-by-side
   ghfind org <name> --json         Org profile: repos, stars, top languages
+  ghfind user <name> --json        User profile: repos, stars, top languages
+  ghfind user <name> --json        User profile: repos, stars, top languages
   ghfind pkg <query> --json         Search npm packages, output JSON
   ghfind pkg <query>                Search npm packages, text list
   ghfind --watch <query>           Watch mode (poll every Ns)
@@ -334,6 +354,12 @@ Options:
     return;
   }
 
+  // User profile mode — same shape as org profile
+  if (flags.user !== undefined) {
+    await runUserProfile(flags, outputFormat);
+    return;
+  }
+
   const isNonInteractive =
     outputFormat ||
     flags.count ||
@@ -370,6 +396,33 @@ function buildSearchContext(flags: CLIFlags): SearchContext {
   };
 }
 
+/** `ghfind user <name>` — aggregate user profile: metadata, stars, top languages, top repos. */
+async function runUserProfile(
+  flags: CLIFlags,
+  outputFormat?: ExportFormat,
+): Promise<void> {
+  try {
+    const profile = await fetchUserProfile(flags.user!, {
+      token: flags.token,
+      limit: flags.limit,
+    });
+    if (outputFormat === "json") {
+      console.log(formatUserJson(profile));
+    } else if (outputFormat === "csv") {
+      console.log(formatUserCsv(profile));
+    } else if (outputFormat === "markdown") {
+      console.log(formatUserMarkdown(profile));
+    } else if (flags.count) {
+      console.log(profile.publicRepoCount);
+    } else {
+      console.log(formatUserText(profile));
+    }
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
+
 /** `ghfind org <name>` — aggregate org profile: metadata, stars, top languages, top repos. */
 async function runOrgProfile(
   flags: CLIFlags,

package/src/help.ts

@@ -110,6 +110,10 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "d", action: "Delete entry (history, saved)" },
         { keys: "↑ ↓ / j k", action: "Navigate overlay list" },
         { keys: "← → / h l", action: "Navigate tabs / panels" },
+        {
+          keys: "PgUp/PgDn",
+          action: "Scroll update notes; Home/End jump to ends",
+        },
       ],
     },
     {

package/src/tui.ts

@@ -122,6 +122,11 @@ import {
   recordPreUpdateState,
 } from "./update-check";
 import { debugLog } from "./storage";
+import {
+  landingConsumesKey,
+  landingKeysActive,
+  moveSelection,
+} from "./landing";
 const colors: Record<string, string> = {
   bg: "#3D3B3B",
   surface: "#4a4848",
@@ -494,7 +499,8 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
   }
 
   const landingHint = new TextRenderable(renderer, {
-    content: "   \u2191\u2193 Navigate  \u21E9 Select  [?]help  [q]uit",
+    content:
+      "   \u2191\u2193 Navigate  \u21E9 Select  [b]ookmarks  [?]help  [q]uit",
     fg: colors.muted,
     bg: colors.bg,
     height: 1,
@@ -525,29 +531,42 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     }
   }
 
-  // Landing keyboard handler
+  // Landing keyboard handler. Registered before the global handler below,
+  // and both listeners receive the same key event — so keys the landing
+  // screen consumes must be claimed with stopPropagation(), or the global
+  // handler re-reads them (e.g. "/" focusing the search input on top of the
+  // menu, or "?" opening help and instantly closing it again).
   renderer.keyInput.on("keypress", (key) => {
-    if (currentMode === "landing") {
-      if (key.name === "up" || key.name === "k") {
-        landingSelected = Math.max(0, landingSelected - 1);
-        updateLandingCards();
-        renderer.requestRender();
-      } else if (key.name === "down" || key.name === "j") {
-        landingSelected = Math.min(
-          landingOptions.length - 1,
-          landingSelected + 1,
-        );
-        updateLandingCards();
-        renderer.requestRender();
-      } else if (key.name === "enter" || key.name === "return") {
-        landingOptions[landingSelected].action();
-      } else if (key.name === "?" || key.name === "h") {
-        showOverlay(currentOverlay === "help" ? "none" : "help");
-      } else if (key.name === "q") {
-        cleanup();
-      }
-      return;
+    if (!landingKeysActive(currentMode, currentOverlay)) return;
+    if (key.name === "up" || key.name === "k") {
+      landingSelected = moveSelection(
+        landingSelected,
+        -1,
+        landingOptions.length,
+      );
+      updateLandingCards();
+      renderer.requestRender();
+    } else if (key.name === "down" || key.name === "j") {
+      landingSelected = moveSelection(
+        landingSelected,
+        1,
+        landingOptions.length,
+      );
+      updateLandingCards();
+      renderer.requestRender();
+    } else if (key.name === "enter" || key.name === "return") {
+      landingOptions[landingSelected].action();
+    } else if (key.name === "b") {
+      refreshBookmarks();
+      showOverlay("bookmarks");
+    } else if (key.name === "?" || key.name === "h") {
+      showOverlay(currentOverlay === "help" ? "none" : "help");
+    } else if (key.name === "q") {
+      cleanup();
+    } else {
+      return; // not a landing key — let the global handler see it
     }
+    if (landingConsumesKey(key.name)) key.stopPropagation();
   });
 
   // Hide main content so overlays can take 100% of the content area
@@ -598,6 +617,9 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
       return;
     }
     currentOverlay = type;
+    // An overlay opened from the landing screen must hide the menu too
+    // (hideMainContent only covers the search/trending/toolbar boxes).
+    landingBox.visible = false;
     // Leader menu is a floating overlay — main content stays visible behind it
     if (type !== "leader") {
       hideMainContent();
@@ -630,6 +652,8 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     } else if (type === "update") {
       updateDim.visible = true;
       updateBox.visible = true;
+      // Fresh notes start at the top of the changelog
+      updateScroll.scrollTop = 0;
       // Selection is driven by updateSelectedOption + the global key handler
       // (see the "Update panel" block); there is no focusable Select here.
     }
@@ -1049,9 +1073,9 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     visible: false,
     position: "absolute",
     width: "55%",
-    height: 16,
+    height: 24,
     left: "22.5%",
-    top: "25%",
+    top: "20%",
     backgroundColor: colors.surfaceDim,
     border: true,
     borderStyle: "rounded",
@@ -1069,6 +1093,25 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     fg: colors.accent,
     bg: colors.surfaceDim,
   });
+  // ponytail: notes render as plain text with \n; keep it a column so lines stack
+  const updateScroll = new ScrollBoxRenderable(renderer, {
+    flexGrow: 1,
+    backgroundColor: colors.surfaceDim,
+    scrollY: true,
+    scrollX: false,
+    viewportOptions: { backgroundColor: colors.surfaceDim },
+    contentOptions: {
+      backgroundColor: colors.surfaceDim,
+      flexDirection: "column",
+    },
+    scrollbarOptions: {
+      width: 1,
+      trackOptions: {
+        backgroundColor: colors.surfaceDim,
+        foregroundColor: colors.muted,
+      },
+    },
+  });
 
   // Horizontal option boxes
   let updateSelectedOption = 0;
@@ -1146,13 +1189,14 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
   updateOptionsRow.add(laterBox);
 
   const updateFooter = new TextRenderable(renderer, {
-    content: "  ←→ select  Enter  Esc/q close",
+    content: "  ↑↓/jk/PgUp/PgDn scroll  ←→ select  Enter  Esc/q close",
     fg: colors.muted,
     bg: colors.surfaceDim,
     height: 1,
     paddingX: 1,
   });
-  updateBox.add(updateText);
+  updateBox.add(updateScroll);
+  updateScroll.add(updateText);
   updateBox.add(updateOptionsRow);
   updateBox.add(updateFooter);
   root.add(updateDim);
@@ -1558,8 +1602,14 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     if (state.lastInstalledVersion === currentVersion) return;
     // We just upgraded — show notes for the new version
     const notes = fetchReleaseNotes(currentVersion);
+    // Box is 55% of the terminal; subtract border + padding so wrapped
+    // lines never clip horizontally.
+    const notesWidth = Math.max(
+      30,
+      Math.floor((process.stdout.columns || 80) * 0.55) - 8,
+    );
     const notesBlock = notes
-      ? renderMarkdown(notes, { width: 60 })
+      ? renderMarkdown(notes, { width: notesWidth })
       : "  No release notes found for this version.";
     updateSelectedOption = 0;
     updateText.content = `  Updated ghfind ${state.lastInstalledVersion} → ${currentVersion}\n\n${notesBlock}`;
@@ -1580,8 +1630,12 @@ export async function launchBrowser(theme_override?: string): Promise<void> {
     if (latest) {
       updateSelectedOption = 0;
       const notes = fetchReleaseNotes(latest);
+      const notesWidth = Math.max(
+        30,
+        Math.floor((process.stdout.columns || 80) * 0.55) - 8,
+      );
       const notesBlock = notes
-        ? renderMarkdown(notes, { width: 60 })
+        ? renderMarkdown(notes, { width: notesWidth })
         : `  A new version is available\n\n  Current: ${currentVersion}\n  Latest:   ${latest}\n\n  Run "npm install -g ghfind"`;
       updateText.content = `  A new version is available\n\n  Current: ${currentVersion}\n  Latest:   ${latest}\n\n${notesBlock}`;
       renderUpdateOptions();
@@ -2755,6 +2809,24 @@ ${pack.description ?? ""}`;
           renderer.requestRender();
           return;
         }
+        // Notes area is scrollable — ↑↓/jk move a fifth of a page,
+        // PageUp/PageDown/Home/End jump, all via the ScrollBox's native
+        // handler (same semantics as the readme/org viewers); ←/→ still
+        // drive the button row, not the scrollbar.
+        if (
+          key.name === "pageup" ||
+          key.name === "pagedown" ||
+          key.name === "home" ||
+          key.name === "end" ||
+          key.name === "up" ||
+          key.name === "down" ||
+          key.name === "j" ||
+          key.name === "k"
+        ) {
+          updateScroll.handleKeyPress(key);
+          renderer.requestRender();
+          return;
+        }
         if (key.name === "left" || key.name === "h") {
           updateSelectedOption = Math.max(0, updateSelectedOption - 1);
           renderUpdateOptions();
@@ -2803,6 +2875,14 @@ ${pack.description ?? ""}`;
 
     // ── Main view handling (no overlay active) ────────────────────────
 
+    // The landing screen owns the keyboard: its handler above already
+    // consumed its keys, and everything else must be ignored here so hidden
+    // main-view bindings (search focus, leader menu, theme, compare, quit)
+    // can't fire through the landing menu.
+    if (currentMode === "landing") {
+      return;
+    }
+
     // q quits
     if (key.name === "q") {
       if (graphFullscreen) {