Improve gitgo with comprehensive comments and documentation enhancements

- Add detailed English/Chinese comments to new_git.go core implementation
- Add English/Chinese comments to gcm.go Git operation methods
- Add English/Chinese comments to git_up.go Git info fetch functions
- Improve utils.go with complete English/Chinese documentation
- Add comprehensive test function comments to each test file
- Update README.md and README.zh.md with related project links (gitgo ↔ gogit)
- Optimize README wording with improved naming (Repo abbreviation)
- Update Go version badge from 1.25+ to 1.22--1.25 matching go.mod requirements
- Add 1.25.x to GitHub Actions test matrix in release.yml
- Update dependencies in go.mod and go.sum
- Enhance test coverage in git_up_test.go with edge cases

Author: yyle88

.github/workflows/release.yml

@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go: [ "1.22.x", "1.23.x", "1.24.x", "stable" ]
+        go: [ "1.22.x", "1.23.x", "1.24.x", "1.25.x", "stable" ]
     steps:
       - uses: actions/checkout@v4
 

README.md

@@ -1,7 +1,7 @@
 [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/go-xlan/gitgo/release.yml?branch=main&label=BUILD)](https://github.com/go-xlan/gitgo/actions/workflows/release.yml?query=branch%3Amain)
 [![GoDoc](https://pkg.go.dev/badge/github.com/go-xlan/gitgo)](https://pkg.go.dev/github.com/go-xlan/gitgo)
 [![Coverage Status](https://img.shields.io/coveralls/github/go-xlan/gitgo/main.svg)](https://coveralls.io/github/go-xlan/gitgo?branch=main)
-[![Supported Go Versions](https://img.shields.io/badge/Go-1.22--1.25-lightgrey.svg)](https://go.dev/)
+[![Supported Go Versions](https://img.shields.io/badge/Go-1.22--1.25-lightgrey.svg)](https://github.com/go-xlan/gitgo)
 [![GitHub Release](https://img.shields.io/github/release/go-xlan/gitgo.svg)](https://github.com/go-xlan/gitgo/releases)
 [![Go Report Card](https://goreportcard.com/badge/github.com/go-xlan/gitgo)](https://goreportcard.com/report/github.com/go-xlan/gitgo)
 
@@ -19,11 +19,16 @@ Streamlined Git command execution engine with fluent chaining interface and comp
 
 ## Main Features
 
-🔗 **Fluent Chaining Interface**: Method chaining for complex Git workflows with automatic error propagation
-⚡ **Comprehensive Git Operations**: Full coverage of Git commands including commit, push, pull, and branch management
-🔍 **Smart State Detection**: Intelligent checking for staged/unstaged changes, clean working trees, and repository status
-🎯 **Error Handling**: Robust error propagation with detailed context and debug information
-📋 **Repository Querying**: Advanced repository introspection with branch, commit, and status information
+🔗 **Fluent Chaining Interface**: Method chaining with complex Git workflows and automatic issue propagation
+⚡ **Comprehensive Git Operations**: Complete Git commands coverage including commit, push, fetch, and branch management
+🔍 **Smart State Detection**: Intelligent checking on staged and unstaged changes, clean working trees, and repo status
+🎯 **Issue Handling**: Robust issue propagation with detailed context and debug information
+📋 **Repo Querying**: Advanced repo introspection with branch, commit, and status information
+
+## Related Projects
+
+- **[gogit](https://github.com/go-xlan/gogit)** - Enhanced Git operations toolkit with go-git foundation, providing pure Go implementation without CLI dependencies
+- **[gitgo](https://github.com/go-xlan/gitgo)** (this project) - Streamlined Git command execution engine with fluent chaining interface
 
 ## Installation
 
@@ -70,7 +75,7 @@ func main() {
 
 ⬆️ **Source:** [Source](internal/demos/demo1x/main.go)
 
-### Repository State Detection
+### Repo State Detection
 
 ```go
 package main
@@ -116,7 +121,7 @@ func main() {
 
 ⬆️ **Source:** [Source](internal/demos/demo2x/main.go)
 
-### Tags and Repository Information
+### Tags and Repo Information
 
 ```go
 package main
@@ -161,42 +166,41 @@ func main() {
 
 ⬆️ **Source:** [Source](internal/demos/demo3x/main.go)
 
-
 ## API Reference
 
 ### Core Methods
 
-- `New(path string) *Gcm` - Create new Git command manager
-- `NewGcm(path, execConfig) *Gcm` - Create with custom configuration
+- `New(path string) *Gcm` - Create new Git command engine
+- `NewGcm(path, execConfig) *Gcm` - Create with custom settings
 
 ### Git Operations
 
-- `Status() *Gcm` - Display working tree status
-- `Add() *Gcm` - Stage all changes
+- `Status() *Gcm` - Show working tree status
+- `Add() *Gcm` - Stage changes
 - `Commit(message) *Gcm` - Create commit with message
-- `Push() *Gcm` - Push to remote repository
-- `Pull() *Gcm` - Pull from remote repository
+- `Push() *Gcm` - Push to remote repo
+- `Pull() *Gcm` - Fetch and merge from remote repo
 
 ### Branch Management
 
 - `CheckoutNewBranch(name) *Gcm` - Create and switch to new branch
 - `Checkout(name) *Gcm` - Switch to existing branch
-- `GetCurrentBranch() (string, error)` - Get current branch name
-- `ListBranches() ([]string, error)` - List all branches
+- `GetCurrentBranch() (string, error)` - Get the branch name
+- `ListBranches() ([]string, error)` - Get branches as a list
 
-### Repository State
+### Repo State
 
-- `HasStagingChanges() (bool, error)` - Check for staged changes
-- `HasUnstagedChanges() (bool, error)` - Check for unstaged changes
-- `HasChanges() (bool, error)` - Check for any changes
-- `GetCommitCount() (int, error)` - Get total commit count
-- `GitCommitHash(ref) (string, error)` - Get commit hash for reference
-- `GetRemoteURL(remote) (string, error)` - Get remote repository URL
+- `HasStagingChanges() (bool, error)` - Check staged changes existence
+- `HasUnstagedChanges() (bool, error)` - Check unstaged changes existence
+- `HasChanges() (bool, error)` - Check changes existence
+- `GetCommitCount() (int, error)` - Get commit count
+- `GitCommitHash(ref) (string, error)` - Get commit hash with reference
+- `GetRemoteURL(remote) (string, error)` - Get remote repo URL
 
-### Error Handling
+### Issue Handling
 
-- `Result() ([]byte, error)` - Get output and check for errors
-- `MustDone() *Gcm` - Panic if error occurred
+- `Result() ([]byte, error)` - Get output and check issues
+- `MustDone() *Gcm` - Panic when issues happen
 
 <!-- TEMPLATE (EN) BEGIN: STANDARD PROJECT FOOTER -->
 <!-- VERSION 2025-09-06 04:53:24.895249 +0000 UTC -->
@@ -212,44 +216,44 @@ MIT License. See [LICENSE](LICENSE).
 Contributions are welcome! Report bugs, suggest features, and contribute code:
 
 - 🐛 **Found a bug?** Open an issue on GitHub with reproduction steps
-- 💡 **Have a feature idea?** Create an issue to discuss the suggestion
-- 📖 **Documentation confusing?** Report it so we can improve
-- 🚀 **Need new features?** Share the use cases to help us understand requirements
+- 💡 **Have a feature idea?** Create an issue to discuss the concept
+- 📖 **Documentation confusing?** Report it and we can enhance
+- 🚀 **Need new features?** Share the use cases to help us understand needs
 - ⚡ **Performance issue?** Help us optimize through reporting slow operations
 - 🔧 **Configuration problem?** Ask questions about complex setups
 - 📢 **Follow project progress?** Watch the repo to get new releases and features
-- 🌟 **Success stories?** Share how this package improved the workflow
-- 💬 **Feedback?** We welcome suggestions and comments
+- 🌟 **Success stories?** Share how this package helped the workflow
+- 💬 **Feedback?** We welcome input and comments
 
 ---
 
 ## 🔧 Development
 
-New code contributions, follow this process:
+When contributing new code, follow this process:
 
-1. **Fork**: Fork the repo on GitHub (using the webpage UI).
-2. **Clone**: Clone the forked project (`git clone https://github.com/yourname/repo-name.git`).
+1. **Fork**: Fork the repo on GitHub (using the webpage UI)
+2. **Clone**: Clone the forked project (`git clone https://github.com/yourname/repo-name.git`)
 3. **Navigate**: Navigate to the cloned project (`cd repo-name`)
-4. **Branch**: Create a feature branch (`git checkout -b feature/xxx`).
+4. **Branch**: Create a feature branch (`git checkout -b feature/xxx`)
 5. **Code**: Implement the changes with comprehensive tests
-6. **Testing**: (Golang project) Ensure tests pass (`go test ./...`) and follow Go code style conventions
-7. **Documentation**: Update documentation to support client-facing changes and use significant commit messages
+6. **Testing**: (Golang project) Make sure tests pass (`go test ./...`) and follow Go code conventions
+7. **Documentation**: Update documentation to support changes and write commit messages with substance
 8. **Stage**: Stage changes (`git add .`)
-9. **Commit**: Commit changes (`git commit -m "Add feature xxx"`) ensuring backward compatible code
-10. **Push**: Push to the branch (`git push origin feature/xxx`).
-11. **PR**: Open a pull request on GitHub (on the GitHub webpage) with detailed description.
+9. **Commit**: Commit changes (`git commit -m "Add feature xxx"`) with backward compatible code
+10. **Push**: Push to the branch (`git push origin feature/xxx`)
+11. **PR**: Open a PR on GitHub (on the GitHub webpage) with detailed description
 
-Please ensure tests pass and include relevant documentation updates.
+Make sure tests pass and include documentation updates as needed.
 
 ---
 
 ## 🌟 Support
 
-Welcome to contribute to this project via submitting merge requests and reporting issues.
+Welcome to contribute to this project through submitting PRs and reporting issues.
 
 **Project Support:**
 
-- ⭐ **Give GitHub stars** if this project helps you
+- ⭐ **Give GitHub stars** when this project helps you
 - 🤝 **Share with teammates** and (golang) programming friends
 - 📝 **Write tech blogs** about development tools and workflows - we provide content writing support
 - 🌟 **Join the ecosystem** - committed to supporting open source and the (golang) development scene

README.zh.md

@@ -1,7 +1,7 @@
 [![GitHub Workflow Status (branch)](https://img.shields.io/github/actions/workflow/status/go-xlan/gitgo/release.yml?branch=main&label=BUILD)](https://github.com/go-xlan/gitgo/actions/workflows/release.yml?query=branch%3Amain)
 [![GoDoc](https://pkg.go.dev/badge/github.com/go-xlan/gitgo)](https://pkg.go.dev/github.com/go-xlan/gitgo)
 [![Coverage Status](https://img.shields.io/coveralls/github/go-xlan/gitgo/main.svg)](https://coveralls.io/github/go-xlan/gitgo?branch=main)
-[![Supported Go Versions](https://img.shields.io/badge/Go-1.22--1.25-lightgrey.svg)](https://go.dev/)
+[![Supported Go Versions](https://img.shields.io/badge/Go-1.22--1.25-lightgrey.svg)](https://github.com/go-xlan/gitgo)
 [![GitHub Release](https://img.shields.io/github/release/go-xlan/gitgo.svg)](https://github.com/go-xlan/gitgo/releases)
 [![Go Report Card](https://goreportcard.com/badge/github.com/go-xlan/gitgo)](https://goreportcard.com/report/github.com/go-xlan/gitgo)
 
@@ -19,12 +19,17 @@
 
 ## 核心特性
 
-🔗 **流式链式接口**: 复杂 Git 工作流的方法链式调用，具有自动错误传播
+🔗 **流式链式接口**: 复杂 Git 工作流的方法链式调用，具有自动问题传播
 ⚡ **全面 Git 操作**: 完整覆盖 Git 命令，包括提交、推送、拉取和分支管理
-🔍 **智能状态检测**: 智能检查暂存/未暂存更改、干净工作树和仓库状态
-🎯 **错误处理**: 强大的错误传播，具有详细上下文和调试信息
+🔍 **智能状态检测**: 智能检查暂存和未暂存更改、干净工作树和仓库状态
+🎯 **问题处理**: 强健的问题传播，具有详细上下文和调试信息
 📋 **仓库查询**: 高级仓库信息查询，包括分支、提交和状态信息
 
+## 关联项目
+
+- **[gogit](https://github.com/go-xlan/gogit)** - 增强型 Git 操作工具包，基于 go-git 实现，提供纯 Go 实现无需 CLI 依赖
+- **[gitgo](https://github.com/go-xlan/gitgo)**（本项目）- 流式 Git 命令执行引擎，具有流畅的链式调用接口
+
 ## 安装
 
 ```bash
@@ -165,37 +170,37 @@ func main() {
 
 ### 核心方法
 
-- `New(path string) *Gcm` - 创建新的 Git 命令管理器
-- `NewGcm(path, execConfig) *Gcm` - 使用自定义配置创建
+- `New(path string) *Gcm` - 创建新的 Git 命令引擎
+- `NewGcm(path, execConfig) *Gcm` - 使用自定义设置创建
 
 ### Git 操作
 
 - `Status() *Gcm` - 显示工作树状态
-- `Add() *Gcm` - 暂存所有更改
+- `Add() *Gcm` - 暂存更改
 - `Commit(message) *Gcm` - 创建带消息的提交
 - `Push() *Gcm` - 推送到远程仓库
-- `Pull() *Gcm` - 从远程仓库拉取
+- `Pull() *Gcm` - 从远程仓库获取并合并
 
 ### 分支管理
 
 - `CheckoutNewBranch(name) *Gcm` - 创建并切换到新分支
 - `Checkout(name) *Gcm` - 切换到现有分支
-- `GetCurrentBranch() (string, error)` - 获取当前分支名称
-- `ListBranches() ([]string, error)` - 列出所有分支
+- `GetCurrentBranch() (string, error)` - 获取分支名称
+- `ListBranches() ([]string, error)` - 获取分支列表
 
 ### 仓库状态
 
-- `HasStagingChanges() (bool, error)` - 检查暂存更改
-- `HasUnstagedChanges() (bool, error)` - 检查未暂存更改
-- `HasChanges() (bool, error)` - 检查任何更改
-- `GetCommitCount() (int, error)` - 获取总提交数量
-- `GitCommitHash(ref) (string, error)` - 获取引用的提交哈希
+- `HasStagingChanges() (bool, error)` - 检查暂存更改是否存在
+- `HasUnstagedChanges() (bool, error)` - 检查未暂存更改是否存在
+- `HasChanges() (bool, error)` - 检查更改是否存在
+- `GetCommitCount() (int, error)` - 获取提交数量
+- `GitCommitHash(ref) (string, error)` - 使用引用获取提交哈希
 - `GetRemoteURL(remote) (string, error)` - 获取远程仓库 URL
 
-### 错误处理
+### 问题处理
 
-- `Result() ([]byte, error)` - 获取输出并检查错误
-- `MustDone() *Gcm` - 如果发生错误则触发 panic
+- `Result() ([]byte, error)` - 获取输出并检查问题
+- `MustDone() *Gcm` - 当问题发生时触发 panic
 
 <!-- TEMPLATE (ZH) BEGIN: STANDARD PROJECT FOOTER -->
 <!-- VERSION 2025-09-06 04:53:24.895249 +0000 UTC -->
@@ -232,7 +237,7 @@ MIT 许可证。详见 [LICENSE](LICENSE)。
 4. **分支**：创建功能分支（`git checkout -b feature/xxx`）
 5. **编码**：实现您的更改并编写全面的测试
 6. **测试**：（Golang 项目）确保测试通过（`go test ./...`）并遵循 Go 代码风格约定
-7. **文档**：为面向用户的更改更新文档，并使用有意义的提交消息
+7. **文档**：为面向用户的更改更新文档，并编写有内容的提交消息
 8. **暂存**：暂存更改（`git add .`）
 9. **提交**：提交更改（`git commit -m "Add feature xxx"`）确保向后兼容的代码
 10. **推送**：推送到分支（`git push origin feature/xxx`）