feat: implement remote management and file lifecycle operations

Add comprehensive remote management with full CRUD operations and network support:
- Remote operations (add, remove, rename, list, get URLs)
- Network operations (fetch, push, clone) with advanced options
- Type-safe FetchOptions and PushOptions with builder patterns

Add complete file lifecycle management system:
- File restoration (checkout_file, restore with advanced options)
- Staging operations (reset_file for unstaging)
- File removal (rm, rm_with_options with force/recursive/cached modes)
- File movement (mv, mv_with_options with dry-run/verbose support)
- .gitignore management (add patterns, check status, list patterns)
- Type-safe RestoreOptions, RemoveOptions, MoveOptions with builders

Enhance error handling with Display trait implementation for GitError.

Add comprehensive examples demonstrating all new functionality with
real-world usage patterns and error handling scenarios.

Update documentation across README.md, PLAN.md, and CLAUDE.md to reflect
completed Phase 1 and Phase 2 implementation with full API reference.

Author: eugener

CLAUDE.md

@@ -56,10 +56,39 @@
   - Author struct: name, email, timestamp with Display implementation
   - CommitMessage: subject and optional body parsing
   - CommitDetails: full commit info including file changes and diff stats
-- **Core types**: Hash (in src/types.rs), IndexStatus, WorktreeStatus, FileEntry (in src/commands/status.rs), Branch, BranchList, BranchType (in src/commands/branch.rs), Commit, CommitLog, Author, CommitMessage, CommitDetails, LogOptions (in src/commands/log.rs), RepoConfig (in src/commands/config.rs)
+- **Core types**: Hash (in src/types.rs), IndexStatus, WorktreeStatus, FileEntry (in src/commands/status.rs), Branch, BranchList, BranchType (in src/commands/branch.rs), Commit, CommitLog, Author, CommitMessage, CommitDetails, LogOptions (in src/commands/log.rs), RepoConfig (in src/commands/config.rs), Remote, RemoteList, FetchOptions, PushOptions (in src/commands/remote.rs), RestoreOptions, RemoveOptions, MoveOptions (in src/commands/files.rs)
 - **Utility functions**: git(args, working_dir) -> Result<String>, git_raw(args, working_dir) -> Result<Output>
-- **Command modules**: status.rs, add.rs, commit.rs, branch.rs, log.rs, config.rs (in src/commands/)
-- **Testing**: 106+ tests covering all functionality with comprehensive edge cases
+- **Remote management**: Full remote operations with network support
+  - Repository::add_remote(name, url) -> Result<()> - add remote repository
+  - Repository::remove_remote(name) -> Result<()> - remove remote
+  - Repository::rename_remote(old_name, new_name) -> Result<()> - rename remote
+  - Repository::list_remotes() -> Result<RemoteList> - list all remotes with URLs
+  - Repository::get_remote_url(name) -> Result<String> - get remote URL
+  - Repository::fetch(remote) -> Result<()> - fetch from remote repository
+  - Repository::fetch_with_options(remote, options) -> Result<()> - fetch with FetchOptions
+  - Repository::push(remote, branch) -> Result<()> - push to remote repository
+  - Repository::push_with_options(remote, branch, options) -> Result<()> - push with PushOptions
+  - Repository::clone(url, path) -> Result<Repository> - clone repository (static method)
+  - Remote struct: name, fetch_url, push_url with proper URL handling
+  - RemoteList: Vec<Remote> with search methods (find, iter, len, is_empty)
+  - FetchOptions: prune, tags, all_remotes with builder pattern (with_prune, with_tags, with_all_remotes)
+  - PushOptions: force, tags, set_upstream with builder pattern (with_force, with_tags, with_set_upstream)
+- **File lifecycle operations**: Comprehensive file management with advanced options
+  - Repository::checkout_file(path) -> Result<()> - restore file from HEAD
+  - Repository::restore(paths, options) -> Result<()> - advanced restore with RestoreOptions
+  - Repository::reset_file(path) -> Result<()> - unstage specific file
+  - Repository::rm(paths) -> Result<()> - remove files from repository
+  - Repository::rm_with_options(paths, options) -> Result<()> - remove with RemoveOptions
+  - Repository::mv(source, destination) -> Result<()> - move/rename files
+  - Repository::mv_with_options(source, dest, options) -> Result<()> - move with MoveOptions
+  - Repository::ignore_add(patterns) -> Result<()> - add patterns to .gitignore
+  - Repository::ignore_check(path) -> Result<bool> - check if file is ignored
+  - Repository::ignore_list() -> Result<Vec<String>> - list current ignore patterns
+  - RestoreOptions: with_source(), with_staged(), with_worktree() - builder for restore configuration
+  - RemoveOptions: with_force(), with_recursive(), with_cached(), with_ignore_unmatch() - builder for remove configuration
+  - MoveOptions: with_force(), with_verbose(), with_dry_run() - builder for move configuration
+- **Command modules**: status.rs, add.rs, commit.rs, branch.rs, log.rs, config.rs, remote.rs, files.rs (in src/commands/)
+- **Testing**: 128+ tests covering all functionality with comprehensive edge cases
 - Run `cargo fmt && cargo build && cargo test && cargo clippy --all-targets --all-features -- -D warnings` after code changes
 - Make sure all examples are running
 
@@ -73,6 +102,9 @@ The `examples/` directory contains comprehensive demonstrations of library funct
 - **commit_workflows.rs**: Commit operations and Hash type - commit(), commit_with_author(), Hash methods
 - **branch_operations.rs**: Complete branch management - create/delete/checkout branches, BranchList filtering, branch type handling, search operations
 - **commit_history.rs**: Comprehensive commit history & log operations - demonstrates all commit querying APIs, filtering, analysis, and advanced LogOptions usage
+- **config_operations.rs**: Repository configuration management - user setup, configuration values, repository-scoped settings
+- **remote_operations.rs**: Complete remote management - add/remove/rename remotes, fetch/push operations with options, network operations, error handling
+- **file_lifecycle_operations.rs**: Comprehensive file management - restore/reset/remove/move operations, .gitignore management, advanced file lifecycle workflows, staging area manipulation
 - **error_handling.rs**: Comprehensive error handling patterns - GitError variants, recovery strategies
 
 Run examples with: `cargo run --example <example_name>`

PLAN.md

@@ -12,41 +12,54 @@
 - Commit history and log operations with filtering
 - Error handling with comprehensive GitError types
 - Cross-platform compatibility (OS-agnostic temp directories)
-
-## Phase 1: Essential Remote Operations (High Priority)
-
-### Remote Management
-- [ ] `repo.add_remote(name, url)` - Add remote repository
-- [ ] `repo.remove_remote(name)` - Remove remote
-- [ ] `repo.list_remotes()` - List all remotes with URLs
-- [ ] `repo.rename_remote(old_name, new_name)` - Rename remote
-- [ ] `repo.get_remote_url(name)` - Get remote URL
-
-### Network Operations
-- [ ] `repo.fetch(remote)` / `repo.fetch_all()` - Fetch from remotes
-- [ ] `repo.pull()` / `repo.pull_from(remote, branch)` - Pull changes
-- [ ] `repo.push()` / `repo.push_to(remote, branch)` - Push changes
-- [ ] `repo.clone(url, path)` - Clone repository (static method)
-- [ ] Progress callbacks for network operations
-
-### Remote Branch Tracking
+- **Remote management with full CRUD operations**
+- **Network operations (fetch, push, clone) with advanced options**
+- **File lifecycle operations (restore, reset, remove, move, .gitignore management)**
+
+## ✅ Phase 1: Essential Remote Operations (COMPLETED)
+
+### ✅ Remote Management
+- [x] `repo.add_remote(name, url)` - Add remote repository
+- [x] `repo.remove_remote(name)` - Remove remote
+- [x] `repo.list_remotes()` - List all remotes with URLs
+- [x] `repo.rename_remote(old_name, new_name)` - Rename remote
+- [x] `repo.get_remote_url(name)` - Get remote URL
+
+### ✅ Network Operations
+- [x] `repo.fetch(remote)` / `repo.fetch_with_options()` - Fetch from remotes
+- [x] `repo.push(remote, branch)` / `repo.push_with_options()` - Push changes
+- [x] `repo.clone(url, path)` - Clone repository (static method)
+- [x] Advanced options with FetchOptions and PushOptions
+- [x] Type-safe builder patterns for network operations
+
+## ✅ Phase 2: File Lifecycle Operations (COMPLETED)
+
+### ✅ File Management
+- [x] `repo.checkout_file(path)` - Restore file from HEAD
+- [x] `repo.reset_file(path)` - Unstage specific file
+- [x] `repo.rm(paths)` - Remove files from repository
+- [x] `repo.rm_with_options(paths, options)` - Remove with advanced options
+- [x] `repo.mv(from, to)` - Move/rename files in repository
+- [x] `repo.mv_with_options(source, dest, options)` - Move with advanced options
+- [x] `repo.restore(paths, options)` - Restore files from specific commit with advanced options
+
+### ✅ Ignore Management
+- [x] `repo.ignore_add(patterns)` - Add patterns to .gitignore
+- [x] `repo.ignore_check(file)` - Check if file is ignored
+- [x] `repo.ignore_list()` - List current ignore patterns
+
+### ✅ Advanced File Operations
+- [x] RestoreOptions with source, staged, and worktree control
+- [x] RemoveOptions with force, recursive, cached, and ignore-unmatch
+- [x] MoveOptions with force, verbose, and dry-run modes
+- [x] Type-safe builder patterns for all file operations
+
+### 🔄 Remote Branch Tracking (Future Enhancement)
 - [ ] `repo.branch_set_upstream(branch, remote_branch)` - Set tracking
 - [ ] `repo.branch_track(local, remote)` - Track remote branch
 - [ ] Remote branch listing and status
+- [ ] Pull operations (fetch + merge)
 
-## Phase 2: File Lifecycle Operations (High Priority)
-
-### File Management
-- [ ] `repo.checkout_file(path)` - Restore file from HEAD
-- [ ] `repo.reset_file(path)` - Unstage specific file
-- [ ] `repo.rm(paths)` - Remove files from repository
-- [ ] `repo.mv(from, to)` - Move/rename files in repository
-- [ ] `repo.restore(paths, source)` - Restore files from specific commit
-
-### Ignore Management
-- [ ] `repo.ignore_add(patterns)` - Add patterns to .gitignore
-- [ ] `repo.ignore_check(file)` - Check if file is ignored
-- [ ] `repo.ignore_list()` - List current ignore patterns
 
 ## Phase 3: Release Management (Medium Priority)