github-search-cli 9.5.0 → 9.5.1

package/CHANGELOG.md

@@ -6,7 +6,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Publish
 
 ---
 
-## [Unreleased]
+## [9.5.1] — 2026-09-15
 
 ### Fixed
 
@@ -20,7 +20,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Publish
   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
@@ -30,10 +29,40 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Publish
   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
+## [9.5.0] — 2026-09-15 (released)
 
 ### Added
 

package/README.md

@@ -81,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
@@ -98,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>
@@ -109,6 +113,7 @@ ghfind --completion fish | source
 <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>
@@ -232,14 +237,14 @@ cd ghfind
 # With Bun (recommended for TUI)
 bun install
 bun start        # TUI
-bun test         # 292 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         # 292 tests
+npm test         # 295 tests
 npm run build    # build dist/
 
 > Want to contribute? See [CONTRIBUTING.md](CONTRIBUTING.md) for commands,
@@ -252,13 +257,16 @@ npm run build    # build dist/
 
 Recent releases (full history in [CHANGELOG.md](CHANGELOG.md)):
 
+### v9.5.1
+
+- 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.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
 
@@ -266,26 +274,6 @@ Recent releases (full history in [CHANGELOG.md](CHANGELOG.md)):
 - 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
-
-- 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
-
-### v9.1.1
-
-- Bundle `vendor/` and `dist/` for offline install
-- Postinstall exits non-zero on Bun download failure; bundled Bun 1.3.12 → 1.3.14
-
-### v9.1.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
-
 ---
 
 ## License

package/dist/cli.js

@@ -1376,7 +1376,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.5.0";
+    cached = "9.5.1";
     return cached;
   }
   try {
@@ -2659,6 +2659,10 @@ function buildHelpSections() {
         { keys: "Packages", action: "Switch to npm packages" },
         { keys: "Export", action: "Export results to file" },
         { keys: "Share", action: "Share repo as text" },
+        {
+          keys: "Org profile",
+          action: "Org summary: repos, stars, top languages"
+        },
         { keys: "Topics", action: "Browse GitHub topics" },
         { keys: "Saved", action: "View saved searches" },
         { keys: "Notifs", action: "Check GitHub notifications" },
@@ -6114,12 +6118,11 @@ Usage:
   ghfind <query> --pipe <target>   Pipe to clone/open
   ghfind --trending --json         Trending repos as JSON
   ghfind --releases                Check bookmarks for new releases
-  ghfind --compare <repo1> <repo2> Compare two+ repos side-by-side
+  ghfind --compare <r1> <r2>       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 pkg <query> --json        Search npm packages, output JSON
+  ghfind pkg <query>               Search npm packages, text list
   ghfind --watch <query>           Watch mode (poll every Ns)
   ghfind init                      Run setup wizard
   ghfind login                     Import the gh CLI token or paste one

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-search-cli",
-  "version": "9.5.0",
+  "version": "9.5.1",
   "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.1.md

@@ -0,0 +1,36 @@
+# What's New in ghfind 9.5.1
+
+Two TUI bugs in the landing menu and the update panel, plus test-isolation work.
+
+### Fixed
+
+**Landing-screen keys no longer leak into the main view**
+
+- Pressing `/` on the landing menu focused the search input on top of it
+- `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, and the global handler
+  ignores everything while the landing menu owns the screen
+- Also fixed while routing keys: `b` on the landing screen opens bookmarks
+  (hint bar updated), and overlays opened from landing hide the menu instead
+  of drawing on top of it
+
+**Update panel no longer clips the changelog**
+
+- The modal was hard-capped at 16 rows with the release notes in a single
+  unsized text block, so anything past the first ~10 lines was invisible
+- The notes area is now a scrollable region (same mechanics as the
+  README/org viewers): `↑↓`/`j`/`k` move a fifth of a page,
+  `PageUp`/`PageDown` and `Home`/`End` jump, and a scrollbar appears when
+  content overflows
+- The panel is taller (24 rows), scroll position resets each time it opens,
+  and notes render at the panel's real width so wrapped lines don't clip
+  horizontally on narrow terminals
+
+### Internal
+
+- Seven test suites built temp dirs from a `Date.now()` stamp
+  (`tmpdir()/<name>-<ms>`), a name two concurrent `bun test` processes can
+  collide on. They now use `mkdtempSync`, and the login
+  `readGhCliToken` / `persistToken` dirs are cleaned up after use

package/src/cli.ts

@@ -261,12 +261,11 @@ Usage:
   ghfind <query> --pipe <target>   Pipe to clone/open
   ghfind --trending --json         Trending repos as JSON
   ghfind --releases                Check bookmarks for new releases
-  ghfind --compare <repo1> <repo2> Compare two+ repos side-by-side
+  ghfind --compare <r1> <r2>       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 pkg <query> --json        Search npm packages, output JSON
+  ghfind pkg <query>               Search npm packages, text list
   ghfind --watch <query>           Watch mode (poll every Ns)
   ghfind init                      Run setup wizard
   ghfind login                     Import the gh CLI token or paste one

package/src/help.ts

@@ -82,6 +82,10 @@ export function buildHelpSections(): HelpSection[] {
         { keys: "Packages", action: "Switch to npm packages" },
         { keys: "Export", action: "Export results to file" },
         { keys: "Share", action: "Share repo as text" },
+        {
+          keys: "Org profile",
+          action: "Org summary: repos, stars, top languages",
+        },
         { keys: "Topics", action: "Browse GitHub topics" },
         { keys: "Saved", action: "View saved searches" },
         { keys: "Notifs", action: "Check GitHub notifications" },