@nemo-cli/git 0.1.3 → 0.1.5

package/README.md

@@ -19,6 +19,8 @@ pnpm add @nemo-cli/git --global
 - **Conventional Commits**: Interactive commit wizard with type/scope selection from your commitlint config
 - **Smart Branch Management**: Advanced branch operations with merge status and time filtering
 - **Ticket Auto-Detection**: Automatically extracts ticket numbers from branch names for commit messages
+- **Interactive Commit Navigator**: Enhanced `ng blame` for browsing file history with full diff support
+- **Visual History Viewer**: Beautiful `ng hist` command with interactive graph display and keyboard navigation
 
 ## Usage
 
@@ -35,10 +37,53 @@ ng <command> -h
 # Example:
 ng commit -h
 ng branch -h
+ng blame -h
+ng hist -h
 ```
 
 ---
 
+## Command Reference
+
+### Quick Overview
+
+#### Top-Level Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `ng pull` | `ng pl` | Pull git branch with auto stash/pop |
+| `ng push` | `ng ps` | Push current branch to remote |
+| `ng checkout` | `ng co` | Checkout a branch with auto stash/pop |
+| `ng diff` | `ng di` | Show differences between branches or working directory |
+| `ng merge` | `ng mg` | Merge branches with auto stash/pop |
+| `ng stash` | `ng st` | Git stash management (see subcommands below) |
+| `ng blame` | - | View file commit history with interactive navigation |
+| `ng commit` | - | Interactive commit with conventional commits |
+| `ng status` | `ng s` | Show working tree status (interactive viewer) |
+| `ng hist` | `ng history` | Show git history with beautiful graph format |
+| `ng config` | - | Interactive git configuration manager |
+
+#### Branch Subcommands (`ng branch`)
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `ng branch clean` | - | Clean merged branches with time filtering |
+| `ng branch delete` | - | Delete local/remote branches with merge status check |
+| `ng branch list` | `ng branch ls` | List all branches with current indicator |
+
+#### Stash Subcommands (`ng stash`)
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `ng stash save` | `ng stash s` | Save current changes to stash |
+| `ng stash list` | `ng stash ls` | List all stashes |
+| `ng stash pop` | `ng stash p` | Pop the most recent stash |
+| `ng stash drop` | `ng stash d` | Drop/clear stashes |
+| `ng stash clear` | `ng stash c` | Clear all stashes |
+| `ng stash history` | `ng stash his` | View stash history from persistent index |
+
+---
+
 ## Commands
 
 ### Commit (`ng commit`)
@@ -188,21 +233,21 @@ ng branch clean
 
 ---
 
-### List Branches (`ng list` / `ng ls`)
+### List Branches (`ng branch list` / `ng branch ls`)
 
 List branches with current branch indicator.
 
 ```bash
 # List all branches (default)
-ng list
+ng branch list
 
 # Local branches only
-ng list -l
-ng list --local
+ng branch list -l
+ng branch list --local
 
 # Remote branches only
-ng list -r
-ng list --remote
+ng branch list -r
+ng branch list --remote
 ```
 
 **Features:**
@@ -239,6 +284,180 @@ ng merge -r
 
 ---
 
+### Interactive Commit Navigator (`ng blame`)
+
+Browse file commit history with full diff support and interactive navigation.
+
+```bash
+# View commit history for a file
+ng blame <file-path>
+
+# Example
+ng blame src/commands/blame.ts
+ng blame packages/git/src/commands/blame.ts
+```
+
+**Features:**
+- ✅ **Full Diff Display**: Shows complete diff for each commit (not just commit messages)
+- ✅ **Interactive Navigation**: Browse through commits with keyboard shortcuts
+- ✅ **Smart Caching**: Fetches git history once, then navigates instantly
+- ✅ **Binary File Support**: Detects and handles binary files gracefully
+- ✅ **Large Diff Protection**: Limits display to 50 lines to prevent terminal overflow
+- ✅ **Follow File Renames**: Uses `--follow` to track history across renames
+
+**Interactive Controls:**
+
+| Key | Action | Description |
+|-----|--------|-------------|
+| `n` | Next commit | Move forward in time (to newer commits) |
+| `p` | Previous commit | Move backward in time (to older commits) |
+| `j` | Jump | Jump to a specific commit by number |
+| `q` | Quit | Exit the navigator |
+
+**Display Information:**
+
+Each commit shows:
+- 📝 Commit number (e.g., `Commit 3/10`)
+- 🔖 Short commit hash (8 characters, colored)
+- 👤 Author name (colored)
+- 📅 Commit date (dimmed)
+- 💬 Commit message
+- 📄 Full diff with git standard formatting (red for deletions, green for additions)
+
+**Special Handling:**
+
+- **Binary Files**: Shows "📄 Binary file - diff not available" instead of binary content
+- **Large Diffs**: Displays first 50 lines with truncation notice
+  ```
+  (Showing first 50 lines of 123)
+  ... (truncated)
+  ```
+- **Empty History**: Warns if file has no git history
+- **Missing Files**: Clear error if file doesn't exist
+
+**Example Output:**
+
+```
+Found 10 commits for src/commands/blame.ts
+Use [n/p] to navigate, [j] to jump, [q] to quit
+
+📝 Commit 1/10
+abc123de - John Doe - Mon Feb 2 12:00:00 2026
+feat(git): add interactive commit navigator
+
+--- Diff ---
+diff --git a/src/commands/blame.ts b/src/commands/blame.ts
+new file mode 100644
+index 0000000..1234567
+--- /dev/null
++++ b/src/commands/blame.ts
+@@ -0,0 +1,315 @@
++import path from 'node:path'
++import readline from 'node:readline'
+...
+
+--- Actions ---
+[n] Next commit [p] Previous commit [j] Jump [q] Quit
+```
+
+**Use Cases:**
+
+- 📖 **Code Review**: Understand how a file evolved over time
+- 🐛 **Bug Investigation**: Find when a specific line was changed
+- 📚 **Learning**: Study the development history of a feature
+- 🔍 **Audit**: Review all changes made to a critical file
+
+---
+
+### Git History Viewer (`ng hist` / `ng history`)
+
+Display git history with an interactive, scrollable graph view.
+
+```bash
+# Show full git history
+ng hist
+
+# Limit number of commits
+ng hist -n 20
+ng hist --number 50
+
+# Using alias
+ng history
+ng history -n 10
+```
+
+**Features:**
+- ✅ **Beautiful Graph Format**: Visualizes branch structure with commit tree
+- ✅ **Interactive Navigation**: Scroll through history with keyboard or mouse
+- ✅ **Optimized Display**: Automatically adjusts to terminal size
+- ✅ **Status Bar**: Shows current position and available shortcuts
+- ✅ **Color-Coded Output**:
+  - Cyan: Commit hash
+  - Green: Commit date
+  - Magenta: Author name
+  - Yellow: Branch references
+
+**Interactive Controls:**
+
+| Key | Action | Description |
+|-----|--------|-------------|
+| `↑` / `k` | Scroll up | Move up through commits |
+| `↓` / `j` | Scroll down | Move down through commits |
+| `gg` | Jump to top | Go to the oldest commit |
+| `G` | Jump to bottom | Go to the newest commit (Shift+G) |
+| `Page Up` | Page up | Scroll up one page |
+| `Page Down` | Page down | Scroll down one page |
+| `q` / `Enter` | Quit | Exit the viewer |
+
+**Display Information:**
+
+Each commit shows:
+- 🔖 Short commit hash (cyan, bold)
+- 📅 Commit date and time (green)
+- 👤 Author name (magenta)
+- 🌿 Branch and tag references (yellow)
+- 💬 Commit message
+
+**Status Bar:**
+
+```
+↑↓/jk: Scroll | gg/G: Top/Bottom | PgUp/PgDn | q: Quit | Lines 1-42/150
+```
+
+**Layout Optimization:**
+
+- Automatically calculates optimal view height based on terminal size
+- Reserves space for UI elements (borders, status bar)
+- Ensures minimum of 10 lines for content display
+- Removes unnecessary margins for maximum content visibility
+
+**Use Cases:**
+
+- 📊 **Project Overview**: Quickly see commit history and branch structure
+- 🔍 **Context Browsing**: Understand recent changes before switching branches
+- 📝 **Review History**: Check recent commits before pulling or pushing
+- 🎯 **Navigation**: Find specific commits in the history
+
+**Example Output:**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│* abc123de 2026-02-06 14:54:23 [GaoZimeng] (HEAD -> main)      │
+││  refactor(git): main increase hist viewer height line        │
+│* 1a40997 2026-02-06 14:52:15 [GaoZimeng]                      │
+││  feat(git): fetch remote branches before pull                │
+│* a3be508 2026-02-06 14:51:23 [GaoZimeng]                      │
+││  refactor(git): change branch selection from search to select│
+│* 172403f 2026-02-06 14:50:12 [GaoZimeng]                      │
+││  feat(git): enhance merge command with commit customization  │
+├─────────────────────────────────────────────────────────────────┤
+│ ↑↓/jk: Scroll | gg/G: Top/Bottom | PgUp/PgDn | q: Quit | Lines │
+│  1-10/150                                                        │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
 ### Stash Operations (`ng stash` / `ng st`)
 
 Advanced stash management.
@@ -418,6 +637,93 @@ ng branch clean
 # Confirm deletion
 ```
 
+### Investigating File History
+
+```bash
+# Understand how a file evolved over time
+ng blame src/utils/date.ts
+
+# Interactive navigation:
+# - Press 'n' to see next commit
+# - Press 'p' to go back to previous commit
+# - Press 'j' to jump to commit 5/10
+# - Press 'q' when done reviewing
+
+# Each commit shows:
+# - Full commit hash, author, date, message
+# - Complete diff (what changed)
+# - Current position (e.g., "Commit 3/10")
+```
+
+**Real-world scenarios:**
+
+- 🐛 **Bug Investigation**: Find when a bug was introduced
+  ```bash
+  ng blame src/auth/login.ts
+  # Press 'n' repeatedly to review changes chronologically
+  # Look for the commit that broke the functionality
+  ```
+
+- 📖 **Code Review**: Understand the evolution of a complex function
+  ```bash
+  ng blame src/api/handlers.ts
+  # Navigate through commits to see how the logic developed
+  ```
+
+- 🔍 **Audit Trail**: Review all changes to a security-critical file
+  ```bash
+  ng blame src/config/security.ts
+  # Use 'j' to jump to specific commits of interest
+  ```
+
+---
+
+### Browsing Project History
+
+```bash
+# View full git history with beautiful graph
+ng hist
+
+# View last 20 commits
+ng hist -n 20
+
+# Interactive navigation:
+# - Use ↑/↓ or j/k to scroll through commits
+# - Press 'gg' to jump to oldest commit
+# - Press 'G' (Shift+G) to jump to newest commit
+# - Use Page Up/Down to scroll by pages
+# - Press 'q' or Enter to exit
+
+# Features:
+# - Color-coded output (hash, date, author, branches)
+# - Visual commit graph showing branch structure
+# - Status bar showing current position
+# - Automatically adjusts to terminal size
+```
+
+**Real-world scenarios:**
+
+- 📊 **Before Pulling**: Check what's been committed recently
+  ```bash
+  ng hist -n 10
+  # Review recent commits before doing `ng pull`
+  ```
+
+- 🎯 **Finding Commits**: Locate a specific commit in history
+  ```bash
+  ng hist
+  # Press 'gg' to go to oldest commit
+  # Use ↓/j to scroll forward to find what you need
+  # Note the commit hash (e.g., abc123de)
+  ```
+
+- 🌿 **Branch Overview**: Understand branch structure and merges
+  ```bash
+  ng hist -n 50
+  # See how branches diverged and merged
+  # Identify branch points and merge commits
+  ```
+
 ---
 
 ## Comparison: Git vs `ng`
@@ -429,9 +735,21 @@ ng branch clean
 | Push | `git push` | `ng push` (interactive) |
 | Checkout | `git checkout` | `ng checkout` (auto stash + interactive) |
 | Branch delete | `git branch -D` | `ng branch delete` (merge status check) |
-| List branches | `git branch` | `ng list` (enhanced display) |
+| List branches | `git branch` | `ng branch list` (enhanced display) |
 | Merge | `git merge` | `ng merge` (auto stash + searchable) |
 | Stash | `git stash` | `ng stash` (enhanced management) |
+| Blame | `git blame` (line-by-line) | `ng blame` (full commit history with diff) |
+| Log/History | `git log` (static output) | `ng hist` (interactive graph viewer) |
+
+**Key Difference - `ng blame` vs `git blame`:**
+
+| Feature | `git blame` | `ng blame` |
+|---------|-------------|------------|
+| Shows | Line-by-line annotations | Full commit history with diffs |
+| Navigation | Scroll through file | Interactive commit navigation (n/p/j/q) |
+| Diff View | No (use separately) | Yes, included for each commit |
+| File Renames | Limited | Full support with `--follow` |
+| Best For | Finding who changed a line | Understanding file evolution |
 
 ---
 

package/dist/chunk-Ba_voAlZ.js

@@ -0,0 +1,32 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __require as n, __toESM as r, __commonJSMin as t };