github-search-cli 9.4.4 → 9.5.1

package/CHANGELOG.md

@@ -5,9 +5,111 @@ 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).
 
 ---
+
+## [9.5.1] — 2026-09-15
+
+### 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.
+- **`--help` listed `ghfind user <name>` twice** — the 9.5.0 usage block
+  carried a duplicated line, so the profile examples were printed twice. It
+  now appears once, and the `ghfind pkg` line is aligned with its neighbours.
+
+### Internal
+
+- **Test isolation** — seven suites derived their temp dirs from a
+  `Date.now()` stamp (`tmpdir()/<name>-<ms>`), a name two concurrent
+  `bun test` processes can collide on, which intermittently failed
+  bookmarks / config / doctor / history / login / saved-searches /
+  update-check tests. They now use `mkdtempSync`, which is unique and
+  collision-proof (the pattern `tests/releases.test.ts` already used), and
+  the login `readGhCliToken` / `persistToken` dirs are removed after use
+  instead of accumulating in the temp folder.
+- **Docs sync** (README ↔ `src/help.ts` ↔ `--help`): README gained
+  `--releases` / `--compare` / `pkg` examples plus Packages and Releases
+  feature rows; the TUI help screen gained the `Org profile` command-menu
+  entry the leader menu already had. `tests/cli-help.test.ts` pins the
+  `--help` usage block (no duplicate rows, one description column).
+- `package-lock.json` root version synced to 9.5.1 (`bun.lock` carries no
+  root version), and the release workflow's manual dispatch now runs the
+  gate only — the GitHub Release and npm publish jobs are tag-gated, so
+  dispatching from a branch can't create a release on a non-tag ref.
+- `--doctor` tests remove their temp config dirs after each test instead of
+  leaving them behind.
+- **CI was red on `windows-latest`** — `tests/landing.test.ts` source-greps
+  `src/tui.ts` for a snippet containing `\n`, but Windows checks the tree out
+  with CRLF, so the assertion could never match there while every other OS
+  passed. The source-grep helpers now normalise line endings before
+  asserting; `tests/overlay-registry.test.ts` does the same.
+
+---
+
+## [9.5.0] — 2026-09-15 (released)
+
+### 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 +184,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
@@ -77,6 +81,9 @@ ghfind "query" --pipe open   # open in browser
 ghfind "query" --pipe clone  # clone commands
 ghfind --trending --json     # trending as JSON
 ghfind --watch "query"       # poll every 300s
+ghfind --releases            # new releases for bookmarked repos
+ghfind --compare a/b c/d     # side-by-side comparison
+ghfind pkg "query" --json    # npm package search as JSON
 ```
 
 ### Completions
@@ -94,6 +101,7 @@ ghfind --completion fish | source
 <table>
 <tr><td><b>Search</b></td><td>Free-text + qualifiers (<code>language:</code>, <code>stars:</code>, <code>topic:</code>), sort by stars/updated/forks</td></tr>
 <tr><td><b>Trending</b></td><td>Today, week, month, year — filter by language</td></tr>
+<tr><td><b>Packages</b></td><td>npm registry search (beta) — <code>ghfind pkg "query"</code></td></tr>
 <tr><td><b>Bookmarks</b></td><td>Space → Bookmark / Bookmarks panel — save repos, tag them</td></tr>
 <tr><td><b>Deep-dive</b></td><td>Space → Deep-dive — languages, contributors, README, activity chart</td></tr>
 <tr><td><b>Compare</b></td><td>Space → Compare select / Compare view — side-by-side, select 2+ repos</td></tr>
@@ -103,7 +111,9 @@ 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>Releases</b></td><td><code>--releases</code> — new-release feed for bookmarked repos</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>
 <tr><td><b>Watch</b></td><td><code>--watch</code> — poll for new results</td></tr>
@@ -112,6 +122,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 +179,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 +237,14 @@ cd ghfind
 # With Bun (recommended for TUI)
 bun install
 bun start        # TUI
-bun test         # 215 tests
+bun test         # 295 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         # 295 tests
 npm run build    # build dist/
 
 > Want to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md) for commands,
@@ -235,31 +257,22 @@ npm run build    # build dist/
 
 Recent releases (full history in [CHANGELOG.md](CHANGELOG.md)):
 
-### 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`, `?`)
-- README viewer renders full markdown (headings, code blocks, lists, tables, blockquotes, rules) instead of stripping formatting
-- Widened compare table columns (min 35 chars), added Description + URL rows, and raised the topic cap to 5 per repo
-
-### v9.2.1
+### v9.5.1
 
-- npm package search (beta) and a new landing screen
-- Removed the bundled Bun binary — downloaded at install time instead; package size 39.5 MB → 100 KB
-- Postinstall failures no longer break `npm install`; `bun` dropped from engines
-- Fixed TUI layout on small terminals, trending visibility from the landing screen, and independent trending-tab fetches
+- 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.1.1
+### v9.5.0
 
-- Bundle `vendor/` and `dist/` for offline install
-- Postinstall exits non-zero on Bun download failure; bundled Bun 1.3.12 → 1.3.14
+- 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
 
-### v9.1.0
+### v9.3.0
 
-- Automatic update checking against the npm registry, with a Y/N/L modal
-- Leader menu (Space) consolidating all contextual actions
-- Topic explorer, notifications panel, saved searches, activity graph, README viewer
-- Tab qualifier auto-complete, PageUp/PageDown, `Ctrl+X` clear history, `Ctrl+C` clear notifications
-- TUI runs on Node.js 20+ via the downloaded Bun binary
+- 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`, `?`)
+- README viewer renders full markdown (headings, code blocks, lists, tables, blockquotes, rules) instead of stripping formatting
+- Widened compare table columns (min 35 chars), added Description + URL rows, and raised the topic cap to 5 per repo
 
 ---