feat(git): add revert commit operation

- implement GitTool.revert to revert a commit by hash
- update GitEdit.schema to support revert operation and argument
- document @git_edit revert usage in README and help texts
- handle revert operation in git_edit tool logic

Author: jinzhongjia

README.md

@@ -156,6 +156,7 @@ In any CodeCompanion chat buffer, use `@git_read` or `@git_edit` to perform Git
 • `@git_edit rebase [--onto ONTO] [--base BASE] [--interactive BOOL]` - Rebase current branch onto another.
   WARNING: `interactive` rebase opens an editor and is not suitable for automated environments. It can also rewrite history.
 • `@git_edit cherry_pick --cherry_pick_commit_hash HASH` - Apply the changes introduced by some existing commits.
+• `@git_edit revert --revert_commit_hash HASH` - Revert a commit.
 
 #### Safety Features
 

doc/codecompanion-gitcommit.txt

@@ -419,6 +419,7 @@ GitIgnore Management~
 • `@git_edit push: Push changes to a remote repository (WARNING: force push is dangerous)
 • `@git_edit rebase: Rebase current branch (WARNING: interactive rebase is dangerous)
 • `@git_edit cherry_pick: Apply changes from existing commits
+• `@git_edit revert: Revert a commit
 • `@git_edit push [--remote REMOTE] [--branch BRANCH] [--force BOOL]` - Push changes to a remote repository.
   WARNING: `force` push is dangerous and can overwrite remote history. Use with extreme caution.
 

lua/codecompanion/_extensions/gitcommit/tools/git.lua

@@ -438,5 +438,16 @@ function GitTool.cherry_pick(commit_hash)
   return execute_git_command(cmd)
 end
 
+---Revert a commit
+---@param commit_hash string The commit hash to revert
+---@return boolean success, string output
+function GitTool.revert(commit_hash)
+  if not commit_hash then
+    return false, "Commit hash is required for revert"
+  end
+  local cmd = "git revert --no-edit " .. vim.fn.shellescape(commit_hash)
+  return execute_git_command(cmd)
+end
+
 M.GitTool = GitTool
 return M

lua/codecompanion/_extensions/gitcommit/tools/git_edit.lua

@@ -29,6 +29,7 @@ GitEdit.schema = {
             "push",
             "rebase",
             "cherry_pick",
+            "revert",
             "help",
           },
           description = "The write-access Git operation to perform.",
@@ -111,6 +112,10 @@ GitEdit.schema = {
               type = "string",
               description = "The commit hash to cherry-pick",
             },
+            revert_commit_hash = {
+              type = "string",
+              description = "The commit hash to revert",
+            },
           },
           additionalProperties = false,
         },
@@ -143,6 +148,7 @@ GitEdit.system_prompt = [[## Git Edit Tool (`git_edit`)
 - `rebase`: Rebase current branch onto another (args: onto, base, interactive)
   WARNING: `interactive` rebase opens an editor and is not suitable for automated environments. It can also rewrite history.
 - `cherry_pick`: Apply the changes introduced by some existing commits (args: cherry_pick_commit_hash)
+- `revert`: Revert a commit (args: revert_commit_hash)
 - `help`: Show available edit operations
 ]]
 
@@ -164,6 +170,7 @@ Available write-access Git operations:
 • push: Push changes to a remote repository (WARNING: force push is dangerous)
 • rebase: Rebase current branch (WARNING: interactive rebase is dangerous)
 • cherry_pick: Apply changes from existing commits
+• revert: Revert a commit
       ]]
       return { status = "success", data = help_text }
     end
@@ -220,6 +227,11 @@ Available write-access Git operations:
         return { status = "error", data = "Commit hash is required for cherry-pick" }
       end
       success, output = GitTool.cherry_pick(op_args.cherry_pick_commit_hash)
+    elseif operation == "revert" then
+      if not op_args.revert_commit_hash then
+        return { status = "error", data = "Commit hash is required for revert" }
+      end
+      success, output = GitTool.revert(op_args.revert_commit_hash)
     else
       return { status = "error", data = "Unknown Git edit operation: " .. operation }
     end