gh-manager-cli 1.10.6 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.11.0](https://github.com/wiiiimm/gh-manager-cli/compare/v1.10.6...v1.11.0) (2025-09-01)
+
+
+### Features
+
+* add modal-based visibility filtering and sort selection ([1c72224](https://github.com/wiiiimm/gh-manager-cli/commit/1c72224b4854f69481bb21f089a926dc2c18e53f))
+
 ## [1.10.6](https://github.com/wiiiimm/gh-manager-cli/compare/v1.10.5...v1.10.6) (2025-09-01)
 
 

package/README.md

@@ -10,25 +10,20 @@
 
 Interactive terminal app to browse and manage your personal GitHub repositories. Built with Ink (React for CLIs) and the GitHub GraphQL API.
 
+<p align="center">
+  <img src="docs/demo_interactive.gif" alt="Interactive demo of gh-manager-cli" width="900" />
+  <br />
+  <em>Fast, keyboard-first GitHub repo management from your terminal</em>
+ </p>
+
 ## Screenshots
 
 <div align="center">
-
-### Repository Listing
-Browse your repositories with rich metadata, sorting, and filtering options.
-
-<img src="docs/demo_repo_listing.png" alt="Repository listing interface showing repositories with metadata" width="800">
-
-### Authentication Flow  
-Secure GitHub token authentication with validation and persistence.
-
-<img src="docs/demo_login.png" alt="Login screen prompting for GitHub token" width="800">
-
-### Delete Confirmation
-Safe repository deletion with two-step confirmation process.
-
-<img src="docs/demo_delete_confirmation.png" alt="Delete confirmation dialog with security prompts" width="800">
-
+  <img src="docs/demo_repo_listing.png" alt="Repository listing with metadata" width="31%" />
+  <img src="docs/demo_login.png" alt="GitHub token authentication flow" width="31%" />
+  <img src="docs/demo_delete_confirmation.png" alt="Two-step delete confirmation" width="31%" />
+  <br />
+  <sub>Listing • Auth • Delete confirmation</sub>
 </div>
 
 ## Quick Start
@@ -46,28 +41,34 @@ On first run, you'll be prompted for a GitHub Personal Access Token.
 - **Token Authentication**: Secure PAT storage with validation and persistence
 - **Repository Listing**: Browse all your personal repositories with metadata (stars, forks, language, etc.)
 - **Live Pagination**: Infinite scroll with automatic page prefetching
-- **Real-time Sorting**: Server-side sorting by updated, pushed, name, or stars (with direction toggle)
+- **Interactive Sorting**: Modal-based sort selection (updated, pushed, name, stars) with direction toggle
 - **Smart Search**: Server-side search through repository names and descriptions (3+ characters)
+- **Visibility Filtering**: Modal-based visibility filter (All, Public, Private, Internal for enterprise) with server-side filtering
+- **Fork Status Tracking**: Toggle display of commits behind upstream for forked repositories
 - **Repository Actions**:
   - View detailed info (`I`) - Shows repository metadata, language, size, and timestamps
   - Open in browser (Enter/`O`)
-  - Delete repository (`Del` or `Ctrl+Backspace`) with secure two-step confirmation
+  - Delete repository (`Del` or `Backspace`) with secure two-step confirmation
   - Archive/unarchive repositories (`Ctrl+A`) with confirmation prompts
   - Sync forks with upstream (`Ctrl+S`) with automatic conflict detection
 
 ### User Interface & Experience
 - **Keyboard Navigation**: Full keyboard control (arrow keys, PageUp/Down, `Ctrl+G`/`G`)
 - **Display Density**: Toggle between compact/cozy/comfy spacing (`T`)
-- **Visual Indicators**: Fork status, private/archived badges, language colors
+- **Visual Indicators**: Fork status, private/archived badges, language colors, visibility status
+- **Interactive Modals**: Sort selection, visibility filtering, and organization switching via modal dialogs
+- **Balanced Layout**: Repository items with spacing above and below for better visual hierarchy
 - **Loading States**: Contextual loading screens for sorting and refreshing operations
 - **Rate Limit Monitoring**: Live API usage display with visual warnings
+- **Improved Layout**: Balanced spacing above and below repository items for better visual hierarchy
 
 ### Technical Features
-- **Preference Persistence**: UI settings (sort, density) saved between sessions
+- **Preference Persistence**: UI settings (sort, density, visibility filter, fork tracking) saved between sessions
+- **Server-side Filtering**: Visibility filtering performed at GitHub API level for accurate pagination
 - **Cross-platform**: Works on macOS, Linux, and Windows
 - **Secure Storage**: Token stored with proper file permissions (0600)
 - **Error Handling**: Graceful error recovery with retry mechanisms
-- **Performance**: Efficient GraphQL queries with virtualized rendering
+- **Performance**: Efficient GraphQL queries with virtualized rendering and server-side filtering
 
 ## Installation
 
@@ -139,31 +140,65 @@ The app needs a GitHub token to read your repositories.
 
 Note: Tokens are stored in plaintext on disk with restricted permissions. Future work may add OS keychain support.
 
+### PAT Permissions & Scopes
+
+Choose the least-privileged token for the features you plan to use:
+
+- Browsing/searching repos (public only): `public_repo`
+- Browsing/searching repos (includes private): `repo`
+- Archive/Unarchive repository: `repo` (and you must have admin or maintainer rights on the repo)
+- Sync fork with upstream: `repo` (you must have push rights to your fork)
+- Delete repository: `delete_repo` (and admin rights on the repo)
+
+Notes:
+- Organization repositories may require that your token is SSO-authorized if the org enforces SSO.
+- If organization data doesn’t appear in the switcher, ensure your token is authorized for that org and consider adding `read:org` (some org setups require it to list memberships).
+- Fine-grained PATs: grant Repository access to the repos you need and enable at least:
+  - Metadata: Read
+  - Contents: Read (list/search), Read & Write (sync/archive)
+  - Administration: Manage (only if you need delete)
+  If in doubt, the classic `repo` scope plus `delete_repo` (for deletion) is the simplest equivalent.
+
 ## Usage
 
 Launch the app, then use the keys below:
 
-- Navigation: Up/Down, PageUp/PageDown, `Ctrl+G` (top), `G` (bottom)
-- Refresh: `R`
-- Search: `/` to enter search mode, type 3+ characters for server-side search
+### Navigation & View Controls
+- **Top/Bottom**: `Ctrl+G` (top), `G` (bottom)
+- **Page Navigation**: ↑↓ Arrow keys, PageUp/PageDown
+- **Search**: `/` to enter search mode, type 3+ characters for server-side search
   - Down arrow or Enter: Start browsing search results
   - Esc: Clear search and return to full repository list
-- Sorting: `S` to cycle field (updated → pushed → name → stars → forks), `D` to toggle direction
-- Display density: `T` to toggle compact/cozy/comfy
-- Workspace switcher: `W` to switch between personal account and organizations
-- Repository info: `I` to view detailed metadata (size, language, timestamps)
-- Open in browser: Enter or `O`
-- Delete repository: `Del` or `Ctrl+Backspace` (with confirmation modal)
-  - Uses GitHub REST API (requires `delete_repo` scope and admin rights)
-  - Two-step confirm: type code → confirm (Y/Enter)
-  - Confirm: press `Y` or Enter
+- **Sort**: `S` opens sort modal with options:
+  - Updated: When the repository was last modified
+  - Pushed: When code was last pushed
+  - Name: Alphabetical by repository name
+  - Stars: Number of stars
+- **Sort Direction**: `D` to toggle ascending/descending
+- **Display Density**: `T` to toggle compact/cozy/comfy
+- **Fork Status**: `F` to toggle showing commits behind upstream
+- **Visibility Filter**: `V` opens modal (All, Public, Private, Internal for enterprise)
+
+### Navigation & Account
+- **Open in browser**: Enter or `O`
+- **Refresh**: `R`
+- **Organization switcher**: `W` to switch between personal account and organizations
+- **Logout**: `Ctrl+L`
+- **Quit**: `Q`
+
+### Repository Actions
+- **Repository info**: `I` to view detailed metadata (size, language, timestamps)
+- **Cache info**: `Ctrl+I` to inspect Apollo cache status
+- **Archive/Unarchive**: `Ctrl+A` with confirmation prompt
+- **Delete repository**: `Del` or `Backspace` (with two-step confirmation modal)
+  - Type confirmation code → confirm (Y/Enter)
   - Cancel: press `C` or Esc
-- Archive/Unarchive: `Ctrl+A`
-- Sync fork with upstream: `Ctrl+S` (for forks only, shows commit status and handles conflicts)
-- Logout: `Ctrl+L`
-- Toggle fork metrics: `F`
-- Quit: `Q`
-- Esc: cancels modals, clears search, or returns to normal listing (does not quit)
+- **Sync fork**: `Ctrl+S` (for forks only, shows commit status and handles conflicts)
+
+### General
+- **Esc**: Cancels modals, clears search, or returns to normal listing (does not quit)
+
+The header displays the current owner context (Personal Account or Organization name), active sort and direction, fork status tracking state, and active search/filter.
 
 Status bar shows loaded count vs total. A rate-limit line displays `remaining/limit` and the reset time; it turns yellow when remaining ≤ 10% of the limit.
 
@@ -284,6 +319,8 @@ Recently implemented:
 - ✅ Organization support and switching (press `W`)
 - ✅ Enhanced server-side search with improved UX
 - ✅ Smart infinite scroll with 80% prefetch trigger
+- ✅ Modal-based sort and visibility filtering
+- ✅ Server-side visibility filtering for accurate pagination
 
 Highlights on deck:
 - Optional OS keychain storage via `keytar`

package/dist/{chunk-XCFI3TG5.js → chunk-75Y3BQBE.js}

@@ -118,7 +118,7 @@ async function fetchViewerOrganizations(client) {
   const res = await client(query);
   return res.viewer.organizations.nodes;
 }
-async function fetchViewerReposPage(client, first, after, orderBy, includeForkTracking = true, ownerAffiliations = ["OWNER"], organizationLogin) {
+async function fetchViewerReposPage(client, first, after, orderBy, includeForkTracking = true, ownerAffiliations = ["OWNER"], organizationLogin, privacy) {
   const sortField = orderBy?.field || "UPDATED_AT";
   const sortDirection = orderBy?.direction || "DESC";
   const isOrgContext = !!organizationLogin;
@@ -132,6 +132,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
         $sortField: RepositoryOrderField!
         $sortDirection: OrderDirection!
         $orgLogin: String!
+        $privacy: RepositoryPrivacy
       ) {
         rateLimit {
           limit
@@ -143,6 +144,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             first: $first
             after: $after
             orderBy: { field: $sortField, direction: $sortDirection }
+            privacy: $privacy
           ) {
             totalCount
             pageInfo {
@@ -207,7 +209,8 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
       after: after ?? null,
       sortField,
       sortDirection,
-      orgLogin: organizationLogin
+      orgLogin: organizationLogin,
+      privacy: privacy ?? null
     });
     const data2 = res2.organization.repositories;
     return {
@@ -227,6 +230,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
       $sortField: RepositoryOrderField!
       $sortDirection: OrderDirection!
       $affiliations: [RepositoryAffiliation!]!
+      $privacy: RepositoryPrivacy
     ) {
       rateLimit {
         limit
@@ -239,6 +243,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
           first: $first
           after: $after
           orderBy: { field: $sortField, direction: $sortDirection }
+          privacy: $privacy
         ) {
           totalCount
           pageInfo {
@@ -303,7 +308,8 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
     after: after ?? null,
     sortField,
     sortDirection,
-    affiliations: ownerAffiliations
+    affiliations: ownerAffiliations,
+    privacy: privacy ?? null
   });
   const data = res.viewer.repositories;
   return {
@@ -314,7 +320,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
     rateLimit: res.rateLimit
   };
 }
-async function fetchViewerReposPageUnified(token, first, after, orderBy, includeForkTracking = true, fetchPolicy = "cache-first", ownerAffiliations = ["OWNER"], organizationLogin) {
+async function fetchViewerReposPageUnified(token, first, after, orderBy, includeForkTracking = true, fetchPolicy = "cache-first", ownerAffiliations = ["OWNER"], organizationLogin, privacy) {
   const isApolloEnabled = true;
   const debug = process.env.GH_MANAGER_DEBUG === "1";
   const isOrgContext = !!organizationLogin;
@@ -328,14 +334,14 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
       const sortField = orderBy?.field || "UPDATED_AT";
       const sortDirection = orderBy?.direction || "DESC";
       let q;
-      let variables = { first, after: after ?? null, sortField, sortDirection };
+      let variables = { first, after: after ?? null, sortField, sortDirection, privacy: privacy ?? null };
       if (isOrgContext) {
         variables.orgLogin = organizationLogin;
         q = ap.gql`
-          query OrgRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $orgLogin: String!) {
+          query OrgRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $orgLogin: String!, $privacy: RepositoryPrivacy) {
             rateLimit { limit remaining resetAt }
             organization(login: $orgLogin) {
-              repositories(first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }) {
+              repositories(first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }, privacy: $privacy) {
                 totalCount
                 pageInfo { endCursor hasNextPage }
                 nodes {
@@ -366,10 +372,10 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
       } else {
         variables.affiliations = ownerAffiliations;
         q = ap.gql`
-          query ViewerRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $affiliations: [RepositoryAffiliation!]!) {
+          query ViewerRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $affiliations: [RepositoryAffiliation!]!, $privacy: RepositoryPrivacy) {
             rateLimit { limit remaining resetAt }
             viewer {
-              repositories(ownerAffiliations: $affiliations, first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }) {
+              repositories(ownerAffiliations: $affiliations, first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }, privacy: $privacy) {
                 totalCount
                 pageInfo { endCursor hasNextPage }
                 nodes {
@@ -424,7 +430,7 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
   }
   if (debug) console.log("\u{1F4E1} Using Octokit fallback...");
   const octo = makeClient(token);
-  return fetchViewerReposPage(octo, first, after, orderBy, includeForkTracking, ownerAffiliations, organizationLogin);
+  return fetchViewerReposPage(octo, first, after, orderBy, includeForkTracking, ownerAffiliations, organizationLogin, privacy);
 }
 async function searchRepositoriesUnified(token, viewer, text, first, after, sortKey = "UPDATED_AT", sortDir = "DESC", includeForkTracking = true, fetchPolicy = "network-only") {
   const q = `${text} user:${viewer} in:name,description fork:true`;

package/dist/{github-6IFMCQKW.js → github-6OEBCAUZ.js}

@@ -17,7 +17,7 @@ import {
   updateCacheAfterArchive,
   updateCacheAfterDelete,
   updateCacheWithRepository
-} from "./chunk-XCFI3TG5.js";
+} from "./chunk-75Y3BQBE.js";
 export {
   archiveRepositoryById,
   deleteRepositoryRest,