fix(client): adjust Client to 1.7.0 server

.github/workflows/client-ci.yml

@@ -25,8 +25,8 @@ jobs:
       USE_STAGE: 'true' # Whether to include the stage repository.
       TRAVIS_DIR: hugegraph-client/assembly/travis
       # TODO: replace it with the (latest - n) commit id (n >= 15)
-      # hugegraph commit date: 2025-05-05
-      COMMIT_ID: 8c1ee71
+      # hugegraph commit date: 2025-11-4
+      COMMIT_ID: b7998c1
     strategy:
       fail-fast: false
       matrix:

.github/workflows/client-go-ci.yml

@@ -24,8 +24,8 @@ jobs:
       USE_STAGE: 'true' # Whether to include the stage repository.
       TRAVIS_DIR: hugegraph-client/assembly/travis
       # TODO: replace it with the (latest - n) commit id (n >= 15)
-      # hugegraph commit date: 2024-12-09
-      COMMIT_ID: f838897
+      # FIXME: hugegraph commit date: 2025-10-30
+      COMMIT_ID: 8c1ee71 # 5b3d295
     strategy:
       fail-fast: false
       matrix:
@@ -62,7 +62,7 @@ jobs:
 
       - name: Init Go env
         uses: actions/setup-go@v2.1.3
-        with: { go-version: '1.x' }
+        with: {go-version: '1.x'}
 
       - name: Go test
         run: |

.github/workflows/hubble-ci.yml

@@ -24,8 +24,8 @@ on:
 env:
   TRAVIS_DIR: hugegraph-hubble/hubble-dist/assembly/travis
   # TODO: replace it with the (latest - n) commit id (n >= 15)
-  # hugegraph commit date: 2024-12-09
-  COMMIT_ID: f838897
+  # FIXME: hugegraph commit date: 2025-10-30
+  COMMIT_ID: 8c1ee71 # 5b3d295
 
 jobs:
   hubble-ci:

.github/workflows/spark-connector-ci.yml

@@ -25,8 +25,8 @@ jobs:
     env:
       USE_STAGE: 'true' # Whether to include the stage repository.
       TRAVIS_DIR: hugegraph-spark-connector/assembly/travis
-      # hugegraph commit date: 2024-12-09
-      COMMIT_ID: f838897
+      # hugegraph commit date: 2025-10-30
+      COMMIT_ID: 5b3d295
     strategy:
       matrix:
         JAVA_VERSION: [ '11' ]

.github/workflows/tools-ci.yml

@@ -26,7 +26,8 @@ jobs:
       TRAVIS_DIR: hugegraph-tools/assembly/travis
       # TODO: could we use one param to unify it? or use a action template (could use one ci file)
       # TODO: replace it with the (latest - n) commit id (n >= 15)
-      COMMIT_ID: 29ecc0
+      # hugegraph commit date: 2025-11-4
+      COMMIT_ID: b7998c1
     strategy:
       matrix:
         JAVA_VERSION: [ '11' ]

.gitignore

@@ -102,3 +102,27 @@ Thumbs.db
 # client-go
 go.env
 
+# AI-IDE prompt files (We only keep AGENTS.md, other files could soft-linked it when needed)
+# Claude Projects
+CLAUDE.md
+CLAUDE_*.md
+# Gemini/Google
+GEMINI.md
+# GitHub Copilot / Microsoft
+copilot-instructions.md
+.copilot-instructions.md
+# Cursor IDE
+cursor-instructions.md
+.cursor-instructions.md
+cursor.md
+# Windsurf/Codeium
+windsurf.md
+windsurf-instructions.md
+codeium.md
+codeium-instructions.md
+# Other AI coding assistants
+.ai-instructions.md
+*.ai-prompt.md
+WARP.md
+
+

hugegraph-client/assembly/travis/install-hugegraph-from-source.sh

@@ -23,43 +23,45 @@ fi
 
 COMMIT_ID=$1
 HUGEGRAPH_GIT_URL="https://github.com/apache/hugegraph.git"
-GIT_DIR=hugegraph
 
-# download code and compile
-git clone --depth 150 ${HUGEGRAPH_GIT_URL} $GIT_DIR
-cd "${GIT_DIR}"
+git clone --depth 150 ${HUGEGRAPH_GIT_URL} hugegraph
+cd hugegraph
 git checkout "${COMMIT_ID}"
 mvn package -DskipTests -Dmaven.javadoc.skip=true -ntp
-
 # TODO: lack incubator after apache package release (update it later)
 cd hugegraph-server
-TAR=$(echo apache-hugegraph-*.tar.gz)
-tar zxf "${TAR}" -C ../../
+mv apache-hugegraph-*.tar.gz ../../
 cd ../../
-rm -rf "${GIT_DIR}"
-# TODO: lack incubator after apache package release (update it later)
-HTTP_SERVER_DIR=$(echo apache-hugegraph-*.*)
-HTTPS_SERVER_DIR="hugegraph_https"
-
-cp -r "${HTTP_SERVER_DIR}" "${HTTPS_SERVER_DIR}"
-
-# config auth options just for http server (must keep '/.')
-cp -rf "${TRAVIS_DIR}"/conf/. "${HTTP_SERVER_DIR}"/conf/
+rm -rf hugegraph
+tar zxf apache-hugegraph-*.tar.gz
 
+HTTPS_SERVER_DIR="hugegraph_https"
+mkdir ${HTTPS_SERVER_DIR}
+# TODO: lack incubator after apache package release (update it later)
+cp -r apache-hugegraph-*/. ${HTTPS_SERVER_DIR}
+cd "$(find apache-hugegraph-* | head -1)"
 # start HugeGraphServer with http protocol
-cd "${HTTP_SERVER_DIR}"
+sed -i 's|gremlin.graph=org.apache.hugegraph.HugeFactory|gremlin.graph=org.apache.hugegraph.auth.HugeFactoryAuthProxy|' conf/graphs/hugegraph.properties
+sed -i 's|#auth.authenticator=.*|auth.authenticator=org.apache.hugegraph.auth.StandardAuthenticator|' conf/rest-server.properties
+sed -i 's|#auth.admin_pa=.*|auth.admin_pa=pa|' conf/rest-server.properties
 echo -e "pa" | bin/init-store.sh || exit 1
 bin/start-hugegraph.sh || exit 1
 
-# config options for https server
-cd ../"${HTTPS_SERVER_DIR}"
+# Wait for server to initialize
+echo "Waiting 5 seconds for HugeGraph server to initialize..."
+sleep 5
+
+cd ../${HTTPS_SERVER_DIR}
 REST_SERVER_CONFIG="conf/rest-server.properties"
 GREMLIN_SERVER_CONFIG="conf/gremlin-server.yaml"
 sed -i "s?http://127.0.0.1:8080?https://127.0.0.1:8443?g" "$REST_SERVER_CONFIG"
 sed -i "s/#port: 8182/port: 8282/g" "$GREMLIN_SERVER_CONFIG"
 echo "gremlinserver.url=http://127.0.0.1:8282" >> ${REST_SERVER_CONFIG}
 
 # start HugeGraphServer with https protocol
-bin/init-store.sh
-bin/start-hugegraph.sh || (cat logs/hugegraph-server.log && exit 1)
+sed -i 's|gremlin.graph=org.apache.hugegraph.HugeFactory|gremlin.graph=org.apache.hugegraph.auth.HugeFactoryAuthProxy|' conf/graphs/hugegraph.properties
+sed -i 's|#auth.authenticator=.*|auth.authenticator=org.apache.hugegraph.auth.StandardAuthenticator|' conf/rest-server.properties
+sed -i 's|#auth.admin_pa=.*|auth.admin_pa=pa|' conf/rest-server.properties
+echo -e "pa" | bin/init-store.sh || exit 1
+bin/start-hugegraph.sh
 cd ../

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/AccessAPI.java

@@ -28,8 +28,8 @@
 
 public class AccessAPI extends AuthAPI {
 
-    public AccessAPI(RestClient client, String graph) {
-        super(client, graph);
+    public AccessAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/AuthAPI.java

@@ -23,11 +23,17 @@
 
 public abstract class AuthAPI extends API {
 
-    private static final String PATH = "graphs/%s/auth/%s";
+    private static final String PATH = "graphspaces/%s/auth/%s";
+    private static final String USER_PATH = "auth/%s";
 
-    public AuthAPI(RestClient client, String graph) {
+    public AuthAPI(RestClient client) {
         super(client);
-        this.path(PATH, graph, this.type());
+        this.path(USER_PATH, this.type());
+    }
+
+    public AuthAPI(RestClient client, String graphSpace) {
+        super(client);
+        this.path(PATH, graphSpace, this.type());
     }
 
     public static String formatEntityId(Object id) {
@@ -40,11 +46,6 @@ public static String formatEntityId(Object id) {
     }
 
     public static String formatRelationId(Object id) {
-        if (id == null) {
-            return null;
-        } else if (id instanceof AuthElement) {
-            id = ((AuthElement) id).id();
-        }
-        return String.valueOf(id);
+        return formatEntityId(id);
     }
 }

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/BelongAPI.java

@@ -28,8 +28,8 @@
 
 public class BelongAPI extends AuthAPI {
 
-    public BelongAPI(RestClient client, String graph) {
-        super(client, graph);
+    public BelongAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/GroupAPI.java

@@ -29,8 +29,8 @@
 
 public class GroupAPI extends AuthAPI {
 
-    public GroupAPI(RestClient client, String graph) {
-        super(client, graph);
+    public GroupAPI(RestClient client) {
+        super(client);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/LoginAPI.java

@@ -25,8 +25,8 @@
 
 public class LoginAPI extends AuthAPI {
 
-    public LoginAPI(RestClient client, String graph) {
-        super(client, graph);
+    public LoginAPI(RestClient client) {
+        super(client);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/LogoutAPI.java

@@ -24,8 +24,8 @@
 
 public class LogoutAPI extends AuthAPI {
 
-    public LogoutAPI(RestClient client, String graph) {
-        super(client, graph);
+    public LogoutAPI(RestClient client) {
+        super(client);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/ManagerAPI.java

@@ -30,8 +30,8 @@
 
 public class ManagerAPI extends AuthAPI {
 
-    public ManagerAPI(RestClient client, String graph) {
-        super(client, graph);
+    public ManagerAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     public UserManager create(UserManager userManager) {
@@ -80,8 +80,7 @@ public boolean checkDefaultRole(String graphSpace, String role,
             params.put("graph", graph);
         }
         RestResult result = this.client.get(path, params);
-        return (boolean) result.readObject(Map.class).getOrDefault("check",
-                                                                   false);
+        return (boolean) result.readObject(Map.class).getOrDefault("check", false);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/ProjectAPI.java

@@ -33,8 +33,8 @@ public class ProjectAPI extends AuthAPI {
     private static final String ACTION_ADD_GRAPH = "add_graph";
     private static final String ACTION_REMOVE_GRAPH = "remove_graph";
 
-    public ProjectAPI(RestClient client, String graph) {
-        super(client, graph);
+    public ProjectAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     @Override
@@ -75,8 +75,7 @@ public Project addGraphs(Object projectId, Set<String> graphs) {
         RestResult result = this.client.put(this.path(),
                                             formatEntityId(projectId),
                                             project,
-                                            ImmutableMap.of("action",
-                                                            ACTION_ADD_GRAPH));
+                                            ImmutableMap.of("action", ACTION_ADD_GRAPH));
         return result.readObject(Project.class);
     }
 
@@ -86,8 +85,7 @@ public Project removeGraphs(Object projectId, Set<String> graphs) {
         RestResult result = this.client.put(this.path(),
                                             formatEntityId(projectId),
                                             project,
-                                            ImmutableMap.of("action",
-                                                            ACTION_REMOVE_GRAPH));
+                                            ImmutableMap.of("action", ACTION_REMOVE_GRAPH));
         return result.readObject(Project.class);
     }
 }

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/TargetAPI.java

@@ -29,8 +29,8 @@
 
 public class TargetAPI extends AuthAPI {
 
-    public TargetAPI(RestClient client, String graph) {
-        super(client, graph);
+    public TargetAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/TokenAPI.java

@@ -24,8 +24,8 @@
 
 public class TokenAPI extends AuthAPI {
 
-    public TokenAPI(RestClient client, String graph) {
-        super(client, graph);
+    public TokenAPI(RestClient client) {
+        super(client);
     }
 
     @Override

hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/UserAPI.java

@@ -30,8 +30,8 @@
 
 public class UserAPI extends AuthAPI {
 
-    public UserAPI(RestClient client, String graph) {
-        super(client, graph);
+    public UserAPI(RestClient client, String graphSpace) {
+        super(client, graphSpace);
     }
 
     @Override
@@ -44,13 +44,10 @@ public User create(User user) {
         return result.readObject(User.class);
     }
 
-    public Map<String, List<Map<String, String>>> createBatch(List<Map<String,
-            String>> data) {
+    public Map<String, List<Map<String, String>>> createBatch(List<Map<String, String>> data) {
         String path = String.join("/", this.path(), "batch");
         RestResult result = this.client.post(path, data);
-        Map<String, List<Map<String, String>>> resultList =
-                (Map<String, List<Map<String, String>>>) result.readObject(Map.class);
-        return resultList;
+        return (Map<String, List<Map<String, String>>>) result.readObject(Map.class);
     }
 
     public User get(Object id) {

hugegraph-client/src/main/java/org/apache/hugegraph/api/graph/GraphMetricsAPI.java

@@ -89,7 +89,7 @@ public Map<String, ElementCount> getEVCountByMonth(String monthStr) {
 
         // convert json to Map<String, TypeCount>
         Map<String, Object> elementCounts = resp.readObject(Map.class);
-        for(Map.Entry<String, Object> entry : elementCounts.entrySet()) {
+        for (Map.Entry<String, Object> entry : elementCounts.entrySet()) {
             String strDate = entry.getKey();
             Object elementCountMap = entry.getValue();
             ElementCount elementCount =
@@ -138,7 +138,7 @@ public Map<String, TypeCount> getTypeCountByMonth(String monthStr) {
 
         // convert json to Map<String, TypeCount>
         Map<String, Object> typeCounts = resp.readObject(Map.class);
-        for(Map.Entry<String, Object> entry : typeCounts.entrySet()) {
+        for (Map.Entry<String, Object> entry : typeCounts.entrySet()) {
             String strDate = entry.getKey();
             Object typeCountMap = entry.getValue();
             TypeCount typeCount =

hugegraph-client/src/main/java/org/apache/hugegraph/api/kvstore/KvStoreAPI.java

@@ -14,6 +14,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  */
+
 package org.apache.hugegraph.api.kvstore;
 
 import java.util.LinkedHashMap;

hugegraph-client/src/main/java/org/apache/hugegraph/api/traverser/EdgeExistenceAPI.java

@@ -17,7 +17,6 @@
 
 package org.apache.hugegraph.api.traverser;
 
-
 import org.apache.hugegraph.api.graph.GraphAPI;
 import org.apache.hugegraph.client.RestClient;
 import org.apache.hugegraph.rest.RestResult;

hugegraph-client/src/main/java/org/apache/hugegraph/api/traverser/VariablesAPI.java

@@ -14,6 +14,7 @@
  * License for the specific language governing permissions and limitations
  * under the License.
  */
+
 package org.apache.hugegraph.api.traverser;
 
 import org.apache.hugegraph.client.RestClient;

hugegraph-client/src/main/java/org/apache/hugegraph/client/RestClient.java

@@ -19,7 +19,6 @@
 
 import java.util.Map;
 
-import org.apache.hugegraph.driver.VersionManager;
 import org.apache.hugegraph.exception.ServerException;
 import org.apache.hugegraph.rest.AbstractRestClient;
 import org.apache.hugegraph.rest.ClientException;