feat(git): WIP: Add push test #12350

Author: wanling0000

jablib/src/main/java/org/jabref/logic/git/GitHandler.java

@@ -215,7 +215,7 @@ public void fetchOnCurrentBranch() throws IOException {
 
     /**
      * Try to locate the Git repository root by walking up the directory tree starting from the given path.
-     * If a directory containing a `.git` folder is found, a new GitHandler is created and returned.
+     * If a directory containing a .git folder is found, a new GitHandler is created and returned.
      *
      * @param anyPathInsideRepo Any file or directory path that is assumed to be inside a Git repository
      * @return Optional containing a GitHandler initialized with the repository root, or empty if not found
@@ -230,4 +230,8 @@ public static Optional<GitHandler> fromAnyPath(Path anyPathInsideRepo) {
         }
         return Optional.empty();
     }
+
+    public File getRepositoryPathAsFile() {
+        return repositoryPathAsFile;
+    }
 }

jablib/src/main/java/org/jabref/logic/git/status/GitStatusChecker.java

@@ -0,0 +1,90 @@
+package org.jabref.logic.git.status;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.Optional;
+
+import org.jabref.logic.git.GitHandler;
+import org.jabref.logic.git.io.GitRevisionLocator;
+
+import org.eclipse.jgit.api.Git;
+import org.eclipse.jgit.api.Status;
+import org.eclipse.jgit.api.errors.GitAPIException;
+import org.eclipse.jgit.lib.ObjectId;
+import org.eclipse.jgit.lib.Repository;
+import org.eclipse.jgit.revwalk.RevCommit;
+import org.eclipse.jgit.revwalk.RevWalk;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * GitStatusChecker 用于从任意路径检测当前 Git 仓库状态。
+ * 如果找不到仓库，返回 tracking = false 的 GitStatusSnapshot；
+ * 否则返回完整状态（tracking + syncStatus + conflict）。
+ */
+public class GitStatusChecker {
+    private static final Logger LOGGER = LoggerFactory.getLogger(GitStatusChecker.class);
+
+    public static GitStatusSnapshot checkStatus(Path anyPathInsideRepo) {
+        Optional<GitHandler> maybeHandler = GitHandler.fromAnyPath(anyPathInsideRepo);
+
+        if (maybeHandler.isEmpty()) {
+            return new GitStatusSnapshot(false, SyncStatus.UNTRACKED, false, Optional.empty());
+        }
+        GitHandler handler = maybeHandler.get();
+
+        try (Git git = Git.open(handler.getRepositoryPathAsFile())) {
+            Repository repo = git.getRepository();
+            Status status = git.status().call();
+            boolean hasConflict = !status.getConflicting().isEmpty();
+
+            ObjectId localHead = repo.resolve("HEAD");
+            ObjectId remoteHead = repo.resolve("@{u}");
+            SyncStatus syncStatus = determineSyncStatus(repo, localHead, remoteHead);
+
+            return new GitStatusSnapshot(
+                    true,
+                    syncStatus,
+                    hasConflict,
+                    Optional.ofNullable(localHead).map(ObjectId::getName)
+            );
+        } catch (IOException | GitAPIException e) {
+            LOGGER.warn("Failed to check Git status: " + e.getMessage());
+            return new GitStatusSnapshot(
+                    true,
+                    SyncStatus.UNKNOWN,
+                    false,
+                    Optional.empty()
+            );
+        }
+    }
+
+    private static SyncStatus determineSyncStatus(Repository repo, ObjectId localHead, ObjectId remoteHead) throws IOException {
+        if (localHead == null || remoteHead == null) {
+            return SyncStatus.UNKNOWN;
+        }
+
+        if (localHead.equals(remoteHead)) {
+            return SyncStatus.UP_TO_DATE;
+        }
+
+        try (RevWalk walk = new RevWalk(repo)) {
+            RevCommit localCommit = walk.parseCommit(localHead);
+            RevCommit remoteCommit = walk.parseCommit(remoteHead);
+            RevCommit mergeBase = GitRevisionLocator.findMergeBase(repo, localCommit, remoteCommit);
+
+            boolean ahead = !localCommit.equals(mergeBase);
+            boolean behind = !remoteCommit.equals(mergeBase);
+
+            if (ahead && behind) {
+                return SyncStatus.DIVERGED;
+            } else if (ahead) {
+                return SyncStatus.AHEAD;
+            } else if (behind) {
+                return SyncStatus.BEHIND;
+            } else {
+                return SyncStatus.UNKNOWN;
+            }
+        }
+    }
+}

jablib/src/main/java/org/jabref/logic/git/status/SyncStatus.java

@@ -0,0 +1,11 @@
+package org.jabref.logic.git.status;
+
+public enum SyncStatus {
+    UP_TO_DATE,      // Local and remote are in sync
+    BEHIND,          // Local is behind remote, pull needed
+    AHEAD,           // Local is ahead of remote, push needed
+    DIVERGED,        // Both local and remote have new commits; merge required
+    CONFLICT,        // Merge conflict detected
+    UNTRACKED,       // Not under Git control
+    UNKNOWN          // Status couldn't be determined
+}