github-search-cli 9.4.4 → 9.5.0

package/CHANGELOG.md

@@ -5,9 +5,82 @@ All notable changes to `github-search-cli` (published as the `ghfind` binary).
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Published versions and dates mirror [npm](https://www.npmjs.com/package/github-search-cli?activeTab=versions).
 
 ---
+
+## [Unreleased]
+
+### Fixed
+
+- **Landing-screen keys leaked into the main view** — pressing `/` on the
+  landing menu focused the search input on top of it, and `Space`, `t`, `c`,
+  `?`, and `q` all double-fired through the second key listener (help opened
+  and instantly closed; quit ran cleanup twice). The landing handler now
+  claims its keys with `stopPropagation()` via the `landingKeysActive` /
+  `landingConsumesKey` seam (previously built and tested but never wired),
+  and the global handler ignores everything while the landing menu owns the
+  screen. Also fixed while routing keys: `b` on the landing screen now opens
+  bookmarks (hint bar updated), and overlays opened from landing hide the
+  menu instead of drawing on top of it.
+
+- **Update panel clipped the changelog** — the modal was hard-capped at 16
+  rows and put the release notes in a single unsized text block, so anything
+  past the first ~10 lines of the notes was invisible with no hint that more
+  existed. The notes area is now a scrollable region (same mechanics as the
+  README/org viewers): `↑↓/jk` move a fifth of a page, `PageUp`/`PageDown`
+  and `Home`/`End` jump, a scrollbar shows when content overflows, and scroll
+  position resets each time the panel opens. The box is taller (24 rows), and
+  notes render at the panel's actual width so wrapped lines no longer clip
+  horizontally on narrow terminals.
+
+---
+
+## [9.5.0] — 2026-09-15
+
+### Added
+
+- **`ghfind user <name>`** — GitHub user profiles from the terminal, the
+  user-side counterpart to `ghfind org <name>`. Fetches the user's metadata
+  and public repos from the GitHub 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. Supports `--json`, `--csv`, `--markdown`,
+  `--count`, and `--limit` just like `org`, and honors `--token` for higher
+  rate limits. Leading `@` is stripped (`ghfind user @torvalds` works), and
+  Organization / Bot accounts are labeled with an `[org]` / `[bot]` badge in
+  text output (`[staff]` for site admins).
+
+### Fixed
+
+- `ghfind org <name>` mangled multi-word names with dashes (`ghfind org "in
+tech"` looked up `in-tech`) — names are now joined with spaces, which the
+  API handles. In practice org logins are single tokens, so existing one-word
+  lookups are unaffected.
+
+### Internal
+
+- `src/user.ts` mirrors the org-profile module shape: pure
+  `normalizeUser`/`normalizeUserRepo` aggregate functions testable with
+  fixtures, thin formatters, and a `fetchUserProfile` wrapper that degrades
+  gracefully when the repos request fails (metadata is still returned).
+- 27 new tests in `tests/user.test.ts` covering normalization, aggregation,
+  `@`-stripping, 404/network error paths, token headers, zero-repo users,
+  non-array API responses, badges, and all four formatters.
+- **TUI overlay registry seam** — `src/tui.ts` is 2,867 lines and was the
+  most-changed file in the repo (28 of the last 200 commits). A new
+  `src/tui/overlays/registry.ts` introduces the seam that future
+  migrations will consume: `Overlay` interface plus `OVERLAYS` array and
+  `getOverlay()` lookup. The first overlay (`help`) is extracted behind
+  it. Behaviour is unchanged. Migration is gradual; subsequent commits
+  move one overlay at a time and rewire `showOverlay()` to query the
+  registry. 6 guard tests in `tests/overlay-registry.test.ts` pin the
+  registry contract and source-grep `src/tui.ts` to fail on drift between
+  the registered ids and the dispatcher's union type.
+
+---
+
 ## [9.4.3] — 2026-09-13 (released)
 
 ### Added
+
 - nothing added
 
 ### Changed
@@ -82,27 +155,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Publish
 
 ---
 
-## [Unreleased]
-
-### Changed
-
-- **TUI overlay registry seam** — `src/tui.ts` is 2,867 lines and was the
-  most-changed file in the repo (28 of the last 200 commits). A new
-  `src/tui/overlays/registry.ts` introduces the seam that future
-  migrations will consume: `Overlay` interface plus `OVERLAYS` array and
-  `getOverlay()` lookup. The first overlay (`help`) is extracted behind
-  it. Behaviour is unchanged. Migration is gradual; subsequent commits
-  move one overlay at a time and rewire `showOverlay()` to query the
-  registry.
-
-### Added
-
-- 6 guard tests in `tests/overlay-registry.test.ts` pin the registry
-  contract and source-grep `src/tui.ts` to fail on drift between the
-  registered ids and the dispatcher's union type.
-
----
-
 ## [9.4.0] — 2026-08-28
 
 Release tracking for bookmarked repos, plus a bookmarks page and toast notifications in the TUI.

package/README.md

@@ -39,6 +39,8 @@ Or grab a **standalone binary** (no Node.js needed) from [GitHub Releases](https
 | Side-by-side repo compare                  | ✅       | ❌                       | ❌    |
 | Deep-dive (README, contributors, activity) | ✅       | ❌                       | ❌    |
 | npm package search                         | ✅       | ❌                       | ❌    |
+| Org profile                                | ✅       | ✅                       | ❌    |
+| User profile                               | ✅       | ❌                       | ❌    |
 | Pipeable JSON / CSV / Markdown export      | ✅       | JSON only                | ❌    |
 | No login required                          | ✅       | ❌                       | ❌    |
 
@@ -63,6 +65,8 @@ ghfind "language:Rust stars:>1000" --json | jq '.[].fullName'
 ghfind "language:Zig" --count
 ghfind --trending --json --since weekly
 ghfind login                    # import the gh CLI token or paste one
+ghfind org vercel               # org profile: repos, stars, top languages
+ghfind user torvalds            # user profile: repos, stars, followers
 ```
 
 ### Non-interactive
@@ -103,6 +107,7 @@ ghfind --completion fish | source
 <tr><td><b>Export</b></td><td>Space → Export — JSON, CSV, Markdown to file</td></tr>
 <tr><td><b>Share</b></td><td>Space → Share repo — copy repo link to clipboard</td></tr>
 <tr><td><b>Org profile</b></td><td>Space → Org profile — org summary: repos, stars, top languages (<code>ghfind org <name></code> in CLI)</td></tr>
+<tr><td><b>User profile</b></td><td>User summary like org profile — repos, stars, followers, top languages (<code>ghfind user <name></code>)</td></tr>
 <tr><td><b>Notifications</b></td><td>Space → Notifications — view & dismiss alerts</td></tr>
 <tr><td><b>Graph</b></td><td>Space → Activity graph — commit chart, fullscreen toggle</td></tr>
 <tr><td><b>Help</b></td><td><code>?</code> / <code>Ctrl+H</code> — keybindings reference</td></tr>
@@ -112,6 +117,16 @@ ghfind --completion fish | source
 <details>
 <summary>Keybindings</summary>
 
+**Landing screen** (the mode menu shown on launch)
+
+| Key                   | Action                       |
+| --------------------- | ---------------------------- |
+| `↑` / `↓` — `j` / `k` | Navigate mode cards          |
+| `Enter`               | Select mode / open Bookmarks |
+| `b`                   | Jump straight to Bookmarks   |
+| `?` or `h`            | Help overlay                 |
+| `q`                   | Quit ghfind                  |
+
 **Global shortcuts** (main view, no overlay active)
 
 | Key                   | Action                                         |
@@ -159,14 +174,16 @@ Actions shown depend on current mode (search vs trending) and selection:
 
 **Overlay-specific shortcuts**
 
-| Key             | Context                                              | Action                                      |
-| --------------- | ---------------------------------------------------- | ------------------------------------------- |
-| `Esc` / `q`     | Any overlay                                          | Close overlay                               |
-| `Enter`         | Leader / History / Saved / Export / Topics / Share   | Confirm selection                           |
-| `d`             | History / Bookmarks / Saved searches / Notifications | Delete current entry                        |
-| `Ctrl+X`        | History                                              | Clear all history                           |
-| `Ctrl+C`        | Notifications                                        | Dismiss all notifications                   |
-| `Y` / `N` / `L` | Update modal                                         | Yes (install) / No (skip) / Later (dismiss) |
+| Key                              | Context                                              | Action                                      |
+| -------------------------------- | ---------------------------------------------------- | ------------------------------------------- |
+| `Esc` / `q`                      | Any overlay                                          | Close overlay                               |
+| `Enter`                          | Leader / History / Saved / Export / Topics / Share   | Confirm selection                           |
+| `d`                              | History / Bookmarks / Saved searches / Notifications | Delete current entry                        |
+| `Ctrl+X`                         | History                                              | Clear all history                           |
+| `Ctrl+C`                         | Notifications                                        | Dismiss all notifications                   |
+| `Y` / `N` / `L`                  | Update modal                                         | Yes (install) / No (skip) / Later (dismiss) |
+| `↑` / `↓` — `j` / `k`            | Update modal                                         | Scroll release notes                        |
+| `PgUp` / `PgDn` / `Home` / `End` | Update modal                                         | Jump through release notes                  |
 
 Trending tabs: `1`–`5` (Today → All) or `←`/`→` — `h`/`l`
 
@@ -215,14 +232,14 @@ cd ghfind
 # With Bun (recommended for TUI)
 bun install
 bun start        # TUI
-bun test         # 215 tests
+bun test         # 292 tests
 bun run check    # format check + tests — the green gate
 bun run build    # build dist/
 
 # Or with npm
 npm install
 npm start        # TUI (requires Node 20+)
-npm test         # 215 tests
+npm test         # 292 tests
 npm run build    # build dist/
 
 > Want to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md) for commands,
@@ -235,6 +252,14 @@ npm run build    # build dist/
 
 Recent releases (full history in [CHANGELOG.md](CHANGELOG.md)):
 
+### v9.5.0
+
+- New `ghfind user <name>` command — user profiles like `ghfind org`: repos, total stars/forks, followers, top languages, top repos
+- Supports `--json`, `--csv`, `--markdown`, `--count`, `--limit`, `--token`; `@` prefix accepted
+- Fixed `ghfind org` mangling multi-word names with dashes
+- Fixed landing-screen keys leaking into the main view — `/`, `Space`, `t`, `c`, `?`, `q` all double-fired; `b` on the landing screen now opens Bookmarks
+- Fixed the update panel clipping the changelog — release notes are now scrollable (`↑↓`/`j`/`k`, `PgUp`/`PgDn`, `Home`/`End`) in a taller panel
+
 ### v9.3.0
 
 - Fixed `c` keybinding in TUI not adding repos to comparison — a missing closing brace in the space-key handler broke every later key handler (`c`, `t`, `?`)