diff --git a/.codex-task/GLOBAL-TODO.md b/.codex-task/GLOBAL-TODO.md
new file mode 100644
index 000000000..581f0124f
--- /dev/null
+++ b/.codex-task/GLOBAL-TODO.md
@@ -0,0 +1,11 @@
+# 全局 TODO
+
+仅记录各 goal 完成后仍有价值、但不属于已完成 goal 的后续事项。
+
+## Hubble 2.0
+
+- 完成 Hubble UI/UX 重构：基于真实双模式与 Chrome 基线完成三方向选型，交付“理解图、准备数据、查询分析”三个核心旅程，并以能力映射、可访问性、性能和发布包回归收口。
+- 现代化 React、Ant Design、X6/Graphin/G6、Dagre 与构建链；先固化核心页面、图交互、性能和浏览器回归基线，再分批升级并清理兼容层。
+- HugeGraph Server 提供保留 Schema 的 data-only clear API 后，恢复 Hubble“仅清数据”能力及权限、默认图和失败合同测试。
+- 重构 Gremlin Basic 认证，移除 HTTP Session 中的短期明文凭据，并验证 token 生命周期。
+- 发布加固：建立逐 JAR license/native allowlist 与 NOTICE 审计，RC 使用正式发布密钥验证 `.sha512`/`.asc`。
diff --git a/.github/actions/get-hugegraph-commit/action.yml b/.github/actions/get-hugegraph-commit/action.yml
index f6cf438d7..b73b49451 100644
--- a/.github/actions/get-hugegraph-commit/action.yml
+++ b/.github/actions/get-hugegraph-commit/action.yml
@@ -1,22 +1,49 @@
-name: 'Get HugeGraph stable commit id'
-description: 'Fetch the latest HugeGraph release commit SHA and expose it as output and env variable'
+name: 'Get HugeGraph commit id'
+description: 'Fetch a HugeGraph PR or latest release commit SHA and expose it as output and env variable'
+
+inputs:
+ server-pr-number:
+ description: 'HugeGraph Server PR number to use as integration baseline'
+ required: false
+ default: ''
outputs:
commit_id:
- description: 'The commit SHA of the latest HugeGraph release'
+ description: 'The HugeGraph commit SHA selected as integration baseline'
value: ${{ steps.get-commit.outputs.commit_id }}
+ fetch_ref:
+ description: 'Fetchable HugeGraph git ref selected as integration baseline'
+ value: ${{ steps.get-commit.outputs.fetch_ref }}
runs:
using: composite
steps:
- name: Get HugeGraph stable commit id
id: get-commit
- uses: actions/github-script@v7
+ uses: actions/github-script@v9
with:
script: |
const owner = 'apache';
const repo = 'hugegraph';
+ const serverPrNumber = '${{ inputs.server-pr-number }}';
try {
+ if (serverPrNumber) {
+ const pull_number = Number(serverPrNumber);
+ if (!Number.isInteger(pull_number) || pull_number <= 0) {
+ throw new Error(`Invalid server PR number: ${serverPrNumber}`);
+ }
+ const { data: pull } = await github.rest.pulls.get({
+ owner, repo, pull_number
+ });
+ const sha = pull.head.sha;
+ const fetchRef = `refs/pull/${pull_number}/head`;
+ core.exportVariable('COMMIT_ID', sha);
+ core.exportVariable('COMMIT_REF', fetchRef);
+ core.setOutput('commit_id', sha);
+ core.setOutput('fetch_ref', fetchRef);
+ console.log(`Using HugeGraph Server PR #${pull_number} ${fetchRef} (${sha})`);
+ return;
+ }
const { data: release } = await github.rest.repos.getLatestRelease({ owner, repo });
const tagName = release.tag_name;
const { data: ref } = await github.rest.git.getRef({
@@ -30,7 +57,9 @@ runs:
throw new Error(`Unexpected ref type: ${ref.object.type}`);
}
core.exportVariable('COMMIT_ID', sha);
+ core.exportVariable('COMMIT_REF', `refs/tags/${tagName}`);
core.setOutput('commit_id', sha);
+ core.setOutput('fetch_ref', `refs/tags/${tagName}`);
console.log(`Using HugeGraph release ${tagName} (${sha})`);
} catch (error) {
core.setFailed(`Failed to get HugeGraph commit: ${error.message}`);
diff --git a/.github/actions/setup-java-env/action.yml b/.github/actions/setup-java-env/action.yml
index 18b136123..9d897bfd0 100644
--- a/.github/actions/setup-java-env/action.yml
+++ b/.github/actions/setup-java-env/action.yml
@@ -19,7 +19,7 @@ runs:
using: composite
steps:
- name: Install JDK ${{ inputs.java-version }}
- uses: actions/setup-java@v4
+ uses: actions/setup-java@v5
with:
java-version: ${{ inputs.java-version }}
distribution: ${{ inputs.distribution }}
diff --git a/.github/actions/upload-coverage/action.yml b/.github/actions/upload-coverage/action.yml
index 7b07b84f2..143da955b 100644
--- a/.github/actions/upload-coverage/action.yml
+++ b/.github/actions/upload-coverage/action.yml
@@ -14,7 +14,7 @@ runs:
using: composite
steps:
- name: Upload coverage to Codecov
- uses: codecov/codecov-action@v4
+ uses: codecov/codecov-action@v7
with:
token: ${{ inputs.token }}
- file: ${{ inputs.file }}
+ files: ${{ inputs.file }}
diff --git a/.github/labeler.yml b/.github/labeler.yml
index e1ee55ba0..62bb14990 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -18,16 +18,19 @@
#
# Pull Request Labeler Github Action Configuration: https://github.com/marketplace/actions/labeler
-name: Add Scope Label
-
client:
- - hugegraph-client*/**/*
-# - hugegraph-client-go/**/*
+ - changed-files:
+ - any-glob-to-any-file: 'hugegraph-client*/**/*'
+# - any-glob-to-any-file: 'hugegraph-client-go/**/*'
hubble:
- - hugegraph-hubble/**/*
+ - changed-files:
+ - any-glob-to-any-file: 'hugegraph-hubble/**/*'
loader:
- - hugegraph-loader/**/*
+ - changed-files:
+ - any-glob-to-any-file: 'hugegraph-loader/**/*'
tools:
- - hugegraph-tools/**/*
+ - changed-files:
+ - any-glob-to-any-file: 'hugegraph-tools/**/*'
spark:
- - hugegraph-spark-connector/**/*
+ - changed-files:
+ - any-glob-to-any-file: 'hugegraph-spark-connector/**/*'
diff --git a/.github/workflows/client-ci.yml b/.github/workflows/client-ci.yml
index 9ed4e723f..e076dd256 100644
--- a/.github/workflows/client-ci.yml
+++ b/.github/workflows/client-ci.yml
@@ -5,7 +5,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-client/**
- hugegraph-dist/**
@@ -32,7 +32,7 @@ jobs:
steps:
- name: Fetch code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
diff --git a/.github/workflows/client-go-ci.yml b/.github/workflows/client-go-ci.yml
index 9c14711e9..520d92d95 100644
--- a/.github/workflows/client-go-ci.yml
+++ b/.github/workflows/client-go-ci.yml
@@ -4,7 +4,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-client-go/**
- hugegraph-dist/**
@@ -30,7 +30,7 @@ jobs:
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
@@ -52,9 +52,10 @@ jobs:
commit-id: ${{ steps.get-commit.outputs.commit_id }}
- name: Init Go env
- uses: actions/setup-go@v5
+ uses: actions/setup-go@v6
with:
go-version: '1.x'
+ cache-dependency-path: hugegraph-client-go/go.sum
- name: Go test
run: |
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 314b54df7..83c3e4d9d 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -38,10 +38,10 @@ jobs:
steps:
- name: Checkout repository
- uses: actions/checkout@v3
+ uses: actions/checkout@v7
- name: Setup Java JDK
- uses: actions/setup-java@v3
+ uses: actions/setup-java@v5
with:
distribution: 'zulu'
java-version: '11'
@@ -53,12 +53,12 @@ jobs:
mv -vf .github/configs/settings.xml $HOME/.m2/settings.xml
- name: Use Node.js 16
- uses: actions/setup-node@v3
+ uses: actions/setup-node@v6
with:
node-version: '16'
# Initializes the CodeQL tools for scanning.
- name: Initialize CodeQL
- uses: github/codeql-action/init@v2
+ uses: github/codeql-action/init@v4
with:
languages: ${{ matrix.language }}
# If you wish to specify custom queries, you can do so here or in a config file.
@@ -73,7 +73,7 @@ jobs:
# If this step fails, then you should remove it and run the build manually (see below)
- if: matrix.language == 'python' || matrix.language == 'javascript'
name: Autobuild
- uses: github/codeql-action/autobuild@v2
+ uses: github/codeql-action/autobuild@v4
- if: matrix.language == 'java'
name: Build Java
@@ -91,12 +91,12 @@ jobs:
# ./location_of_script_within_repo/buildscript.sh
- name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@v2
+ uses: github/codeql-action/analyze@v4
dependency-review:
runs-on: ubuntu-latest
steps:
- name: 'Checkout Repository'
- uses: actions/checkout@v3
+ uses: actions/checkout@v7
- name: 'Dependency Review'
- uses: actions/dependency-review-action@v2
+ uses: actions/dependency-review-action@v5.0.0
diff --git a/.github/workflows/hubble-ci.yml b/.github/workflows/hubble-ci.yml
index 2b09e74ff..5445dbb0b 100644
--- a/.github/workflows/hubble-ci.yml
+++ b/.github/workflows/hubble-ci.yml
@@ -5,7 +5,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-hubble/**
- hugegraph-dist/**
@@ -23,6 +23,8 @@ on:
env:
TRAVIS_DIR: hugegraph-hubble/hubble-dist/assembly/travis
+ HUGEGRAPH_SERVER_COMMIT: 99936be5f41fccd193f120e01206e3cf3c73a050
+ HUGEGRAPH_SERVER_FETCH_REF: refs/heads/master
jobs:
hubble-ci:
@@ -37,27 +39,74 @@ jobs:
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
- - name: Get HugeGraph stable commit id
- id: get-commit
- uses: ./.github/actions/get-hugegraph-commit
-
- name: Setup Java environment
uses: ./.github/actions/setup-java-env
with:
java-version: ${{ matrix.JAVA_VERSION }}
- distribution: 'adopt'
+ distribution: 'temurin'
use-stage: ${{ env.USE_STAGE }}
- name: Set up Python ${{ matrix.python-version }}
- uses: actions/setup-python@v5
+ uses: actions/setup-python@v6
with:
python-version: ${{ matrix.python-version }}
cache: 'pip'
+ - name: Set up Node.js 18.20.8
+ uses: actions/setup-node@v6
+ with:
+ node-version: '18.20.8'
+
+ # we also should cache python & yarn & downloads to avoid useless work
+ - name: Cache Maven packages
+ uses: actions/cache@v6
+ with:
+ path: ~/.m2/repository
+ key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+ restore-keys: |
+ ${{ runner.os }}-maven-
+
+ - name: Cache Node modules
+ uses: actions/cache@v6
+ with:
+ path: |
+ hugegraph-hubble/hubble-fe/node_modules
+ hugegraph-hubble/hubble-fe/node
+ ~/.cache/yarn
+ key: ${{ runner.os }}-node-${{ hashFiles('**/package.json', '**/yarn.lock') }}
+ restore-keys: |
+ ${{ runner.os }}-node-
+
+ - name: Cache Playwright browsers
+ uses: actions/cache@v6
+ with:
+ path: ~/.cache/ms-playwright
+ key: ${{ runner.os }}-playwright-${{ hashFiles('hugegraph-hubble/hubble-fe/yarn.lock') }}
+
+ - name: Cache HugeGraph Server
+ uses: actions/cache@v6
+ with:
+ path: ~/hugegraph-cache-${{ env.HUGEGRAPH_SERVER_COMMIT }}
+ key: ${{ runner.os }}-hugegraph-server-${{ env.HUGEGRAPH_SERVER_COMMIT }}
+
+ - name: Frontend i18n check
+ working-directory: hugegraph-hubble/hubble-fe
+ env:
+ NODE_OPTIONS: --max-old-space-size=4096
+ run: |
+ yarn install --frozen-lockfile --network-timeout 600000 --prefer-offline --ignore-engines
+ yarn lint
+ yarn i18n:check
+ node --test ../hubble-dist/assembly/travis/ui_auth.test.js
+
+ - name: Install Playwright Chromium
+ working-directory: hugegraph-hubble/hubble-fe
+ run: yarn playwright install --with-deps chromium
+
- name: Compile
run: |
mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip=true -DskipTests -ntp
@@ -66,8 +115,19 @@ jobs:
- name: Prepare env and service
env:
- COMMIT_ID: ${{ steps.get-commit.outputs.commit_id }}
+ COMMIT_ID: ${{ env.HUGEGRAPH_SERVER_COMMIT }}
+ COMMIT_REF: ${{ env.HUGEGRAPH_SERVER_FETCH_REF }}
+ NODE_OPTIONS: --max-old-space-size=4096
run: |
+ echo "=== Environment Info ==="
+ node -v
+ yarn -v
+ echo "NODE_OPTIONS: $NODE_OPTIONS"
+ echo "COMMIT_ID: $COMMIT_ID"
+ echo "COMMIT_REF: $COMMIT_REF"
+ free -h || true
+ echo "======================="
+
python -m pip install -r ${TRAVIS_DIR}/requirements.txt
cd hugegraph-hubble
mvn package -Dmaven.test.skip=true
@@ -77,17 +137,61 @@ jobs:
./stop-hubble.sh
cd ../../../
pwd
- $TRAVIS_DIR/install-hugegraph.sh $COMMIT_ID
+ $TRAVIS_DIR/install-hugegraph.sh $COMMIT_ID $COMMIT_REF
+
+ - name: Release package audit
+ env:
+ GNUPGHOME: ${{ runner.temp }}/hubble-release-gate-gpghome
+ run: |
+ HUBBLE_TARBALL="$(ls hugegraph-hubble/target/apache-hugegraph-hubble-*.tar.gz | head -n 1)"
+ if [[ -z "${HUBBLE_TARBALL}" ]]; then
+ echo "Hubble tarball not found" >&2
+ exit 1
+ fi
+
+ mkdir -p "${GNUPGHOME}"
+ chmod 700 "${GNUPGHOME}"
+ shasum -a 512 "${HUBBLE_TARBALL}" > "${HUBBLE_TARBALL}.sha512"
+ printf '%s\n' \
+ '%no-protection' \
+ 'Key-Type: RSA' \
+ 'Key-Length: 2048' \
+ 'Subkey-Type: RSA' \
+ 'Subkey-Length: 2048' \
+ 'Name-Real: Hubble CI Release Gate' \
+ 'Name-Email: hubble-ci-release-gate@example.invalid' \
+ 'Expire-Date: 0' \
+ '%commit' \
+ > "${RUNNER_TEMP}/hubble-release-gate-key.conf"
+ gpg --batch --generate-key "${RUNNER_TEMP}/hubble-release-gate-key.conf"
+ gpg --batch --yes --armor --detach-sign "${HUBBLE_TARBALL}"
+ bash "${TRAVIS_DIR}/check-hubble-dist.sh" "${HUBBLE_TARBALL}" \
+ --require-sidecars \
+ --json-output hugegraph-hubble/target/hubble-dist-check.json
- name: Unit test
run: mvn test -P unit-test -pl hugegraph-hubble/hubble-be -ntp
- name: API test
- env:
- CI: false
run: |
- cd hugegraph-hubble && ls
- hubble-dist/assembly/travis/run-api-test.sh
+ cd hugegraph-hubble
+ HUBBLE_TARBALL="$(ls target/apache-hugegraph-hubble-*.tar.gz | head -n 1)"
+ HUBBLE_694_EVIDENCE_DIR=target/hubble-live-acceptance \
+ hubble-dist/assembly/travis/verify-hubble-issue-694.sh \
+ "${HUBBLE_TARBALL}" http://127.0.0.1:8080
+
+ - name: Upload Hubble smoke evidence
+ if: ${{ always() }}
+ uses: actions/upload-artifact@v7
+ with:
+ name: hubble-smoke-java-${{ matrix.JAVA_VERSION }}-${{ github.run_attempt }}
+ path: |
+ hugegraph-hubble/target/hubble-dist-check.json
+ hugegraph-hubble/target/hubble-live-acceptance/**/*.json
+ hugegraph-hubble/target/hubble-live-acceptance/**/*.png
+ hugegraph-hubble/target/hubble-live-acceptance/**/*.log
+ if-no-files-found: warn
+ retention-days: 14
- name: Upload coverage to Codecov
uses: ./.github/actions/upload-coverage
diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml
index 18cb05b4a..26285abb5 100644
--- a/.github/workflows/labeler.yml
+++ b/.github/workflows/labeler.yml
@@ -28,7 +28,7 @@ jobs:
pull-requests: write
runs-on: ubuntu-latest
steps:
- - uses: actions/labeler@v4
+ - uses: actions/labeler@v6
with:
repo-token: "${{ secrets.GITHUB_TOKEN }}"
sync-labels: true
diff --git a/.github/workflows/license-checker.yml b/.github/workflows/license-checker.yml
index ef51a265e..3b2d3d701 100644
--- a/.github/workflows/license-checker.yml
+++ b/.github/workflows/license-checker.yml
@@ -23,7 +23,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
pull_request:
jobs:
@@ -31,10 +31,10 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
# More info could refer to: https://github.com/apache/skywalking-eyes
- name: Check License Header
- uses: apache/skywalking-eyes@main
+ uses: apache/skywalking-eyes@29bd646002b63bb4c0ed1648d1654c35fb8ff027 # main 2026-07-12
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
@@ -54,14 +54,14 @@ jobs:
USE_STAGE: 'true' # Whether to include the stage repository.
steps:
- name: Checkout source
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
- name: Set up JDK 11
- uses: actions/setup-java@v3
+ uses: actions/setup-java@v5
with:
java-version: '11'
- distribution: 'adopt'
+ distribution: 'temurin'
- name: Use Node.js 16
- uses: actions/setup-node@v3
+ uses: actions/setup-node@v6
with:
node-version: '16'
diff --git a/.github/workflows/loader-ci.yml b/.github/workflows/loader-ci.yml
index a7b085ab3..f8eee02d3 100644
--- a/.github/workflows/loader-ci.yml
+++ b/.github/workflows/loader-ci.yml
@@ -5,7 +5,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-loader/**
- hugegraph-dist/**
@@ -43,7 +43,7 @@ jobs:
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
@@ -55,17 +55,17 @@ jobs:
uses: ./.github/actions/setup-java-env
with:
java-version: ${{ matrix.JAVA_VERSION }}
- distribution: 'adopt'
+ distribution: 'temurin'
use-stage: ${{ env.USE_STAGE }}
- name: Cache Hadoop
- uses: actions/cache@v4
+ uses: actions/cache@v6
with:
path: ~/hadoop-3.3.6.tar.gz
key: ${{ runner.os }}-hadoop-3.3.6
- name: Cache HugeGraph Server
- uses: actions/cache@v4
+ uses: actions/cache@v6
with:
path: ~/hugegraph-cache-${{ steps.get-commit.outputs.commit_id }}
key: ${{ runner.os }}-hugegraph-server-${{ steps.get-commit.outputs.commit_id }}
diff --git a/.github/workflows/spark-connector-ci.yml b/.github/workflows/spark-connector-ci.yml
index b61b56e2f..50693024a 100644
--- a/.github/workflows/spark-connector-ci.yml
+++ b/.github/workflows/spark-connector-ci.yml
@@ -5,7 +5,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-spark-connector/**
- hugegraph-dist/**
@@ -31,7 +31,7 @@ jobs:
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
@@ -43,7 +43,7 @@ jobs:
uses: ./.github/actions/setup-java-env
with:
java-version: ${{ matrix.JAVA_VERSION }}
- distribution: 'adopt'
+ distribution: 'temurin'
use-stage: ${{ env.USE_STAGE }}
- name: Compile
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index 64b62dc5a..c46000e85 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -12,7 +12,7 @@ jobs:
pull-requests: write
steps:
- - uses: actions/stale@v8
+ - uses: actions/stale@v10
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
stale-issue-message: 'Due to the lack of activity, the current issue is marked as stale and will be closed after 20 days, any update will remove the stale label'
diff --git a/.github/workflows/tools-ci.yml b/.github/workflows/tools-ci.yml
index dda37f3e3..340f71aa1 100644
--- a/.github/workflows/tools-ci.yml
+++ b/.github/workflows/tools-ci.yml
@@ -5,7 +5,7 @@ on:
push:
branches:
- master
- - /^release-.*$/
+ - 'release-*'
paths:
- hugegraph-tools/**
- hugegraph-dist/**
@@ -31,7 +31,7 @@ jobs:
steps:
- name: Fetch Code
- uses: actions/checkout@v4
+ uses: actions/checkout@v7
with:
fetch-depth: 2
@@ -43,7 +43,7 @@ jobs:
uses: ./.github/actions/setup-java-env
with:
java-version: ${{ matrix.JAVA_VERSION }}
- distribution: 'adopt'
+ distribution: 'temurin'
use-stage: ${{ env.USE_STAGE }}
- name: Compile
diff --git a/.gitignore b/.gitignore
index 528ddad73..1467dcafc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -103,6 +103,25 @@ Thumbs.db
go.env
# AI-IDE prompt files (We only keep AGENTS.md, other files could soft-linked it when needed)
+# Local AI-agent workspaces and run evidence
+.codex-task/*
+!.codex-task/GLOBAL-TODO.md
+.autonomous/
+.claude/
+superpowers/
+
+# Local Hubble runtime / extracted distributions
+/db*.db
+/db*.trace.db
+/logs/
+/hugegraph-hubble/apache-hugegraph-hubble-*/
+/hugegraph-hubble/hubble-dist/apache-hugegraph-hubble-*/
+/hugegraph-loader/apache-hugegraph-loader-*/
+
+# Local dependency analysis reports
+/hugegraph-dist/scripts/dependency/current-dependencies.txt
+/hugegraph-dist/scripts/dependency/result.txt
+
# Claude Projects
CLAUDE.md
CLAUDE_*.md
@@ -124,5 +143,4 @@ codeium-instructions.md
.ai-instructions.md
*.ai-prompt.md
WARP.md
-
-
+/.agents
diff --git a/.serena/project.yml b/.serena/project.yml
index edbab5745..4fec60fbc 100644
--- a/.serena/project.yml
+++ b/.serena/project.yml
@@ -1,22 +1,29 @@
-
-# list of languages for which language servers are started; choose from:
-# al bash clojure cpp csharp
-# csharp_omnisharp dart elixir elm erlang
-# fortran fsharp go groovy haskell
-# haxe java julia kotlin lua
-# markdown
-# matlab nix pascal perl php
-# php_phpactor powershell python python_jedi r
+# list of languages for which language servers are started (LSP backend only); choose from:
+# ada al angular ansible bash
+# bsl clojure cpp cpp_ccls crystal
+# csharp csharp_omnisharp cue dart elixir
+# elm erlang fortran fsharp gdscript
+# go groovy haskell haxe hlsl
+# html java json julia kotlin
+# latex lean4 lua luau markdown
+# matlab msl nix ocaml pascal
+# perl php php_phpactor php_phpantom powershell
+# python python_jedi python_pyrefly python_ty r
# rego ruby ruby_solargraph rust scala
-# swift terraform toml typescript typescript_vts
-# vue yaml zig
-# (This list may be outdated. For the current list, see values of Language enum here:
-# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
-# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# scss solidity svelte swift systemverilog
+# terraform toml typescript typescript_vts vue
+# yaml zig
+# (This list may be outdated; generated with scripts/print_language_list.py;
+# For the current list, see values of Language enum here:
+# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py)
+# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
# Note:
# - For C, use cpp
# - For JavaScript, use typescript
+# - For Angular projects, use angular (subsumes typescript+html; requires `npm install` in the project root)
+# - For Svelte projects, use svelte (subsumes typescript/javascript for .svelte projects; requires npm)
+# - For SCSS / Sass / plain CSS, use scss (some-sass-language-server handles all three)
# - For Free Pascal/Lazarus, use pascal
# Special requirements:
# Some languages require additional setup/installations.
@@ -46,56 +53,18 @@ read_only: false
# list of tool names to exclude.
# This extends the existing exclusions (e.g. from the global configuration)
-#
-# Below is the complete list of tools for convenience.
-# To make sure you have the latest list of tools, and to view their descriptions,
-# execute `uv run scripts/print_tool_overview.py`.
-#
-# * `activate_project`: Activates a project based on the project name or path.
-# * `check_onboarding_performed`: Checks whether project onboarding was already performed.
-# * `create_text_file`: Creates/overwrites a file in the project directory.
-# * `delete_memory`: Delete a memory file. Should only happen if a user asks for it explicitly,
-# for example by saying that the information retrieved from a memory file is no longer correct
-# or no longer relevant for the project.
-# * `edit_memory`: Replaces content matching a regular expression in a memory.
-# * `execute_shell_command`: Executes a shell command.
-# * `find_file`: Finds files in the given relative paths
-# * `find_referencing_symbols`: Finds symbols that reference the given symbol using the language server backend
-# * `find_symbol`: Performs a global (or local) search using the language server backend.
-# * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
-# * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
-# * `initial_instructions`: Provides instructions Serena usage (i.e. the 'Serena Instructions Manual')
-# for clients that do not read the initial instructions when the MCP server is connected.
-# * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
-# * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
-# * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
-# * `list_memories`: List available memories. Any memory can be read using the `read_memory` tool.
-# * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
-# * `read_file`: Reads a file within the project directory.
-# * `read_memory`: Read the content of a memory file. This tool should only be used if the information
-# is relevant to the current task. You can infer whether the information
-# is relevant from the memory file name.
-# You should not read the same memory file multiple times in the same conversation.
-# * `rename_memory`: Renames or moves a memory. Moving between project and global scope is supported
-# (e.g., renaming "global/foo" to "bar" moves it from global to project scope).
-# * `rename_symbol`: Renames a symbol throughout the codebase using language server refactoring capabilities.
-# For JB, we use a separate tool.
-# * `replace_content`: Replaces content in a file (optionally using regular expressions).
-# * `replace_symbol_body`: Replaces the full definition of a symbol using the language server backend.
-# * `safe_delete_symbol`:
-# * `search_for_pattern`: Performs a search for a pattern in the project.
-# * `write_memory`: Write some information (utf-8-encoded) about this project that can be useful for future tasks to a memory in md format.
-# The memory name should be meaningful.
+# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
excluded_tools: []
# initial prompt for the project. It will always be given to the LLM upon activating the project
# (contrary to the memories, which are loaded on demand).
initial_prompt: ""
-# the name by which the project can be referenced within Serena
+# the name by which the project can be referenced within Serena/when chatting with the LLM.
project_name: "toolchain"
# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default).
# This extends the existing inclusions (e.g. from the global configuration).
+# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
included_optional_tools: []
# list of mode names to that are always to be included in the set of active modes
@@ -106,15 +75,19 @@ included_optional_tools: []
# Set this to a list of mode names to always include the respective modes for this project.
base_modes: []
-# list of mode names that are to be activated by default.
-# The full set of modes to be activated is base_modes + default_modes.
-# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# list of mode names that are to be activated by default, overriding the setting in the global configuration.
+# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
+# If the setting is undefined/empty, the default_modes from the global configuration (serena_config.yml) apply.
# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# Therefore, you can set this to [] if you do not want the default modes defined in the global config to apply
+# for this project.
# This setting can, in turn, be overridden by CLI parameters (--mode).
+# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
default_modes: []
# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html
fixed_tools: []
# time budget (seconds) per tool call for the retrieval of additional symbol information
@@ -149,6 +122,47 @@ ignored_memory_patterns: []
# advanced configuration option allowing to configure language server-specific options.
# Maps the language key to the options.
-# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available.
-# No documentation on options means no options are available.
+# The settings are considered only if the project is trusted (see global configuration to define trusted projects).
+# See https://oraios.github.io/serena/02-usage/050_configuration.html#language-server-specific-settings
ls_specific_settings: {}
+
+# list of mode names to be activated additionally for this project, e.g. ["query-projects"]
+# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes.
+# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
+added_modes:
+
+# list of workspace folder paths (LSP backend only).
+# These folders will be used to build up Serena's symbol index.
+# Paths must be within the project root and should thus be relative to the project root.
+# Furthermore, the paths should not be filtered by ignore settings.
+# Default setting: The entire project root folder (".") is considered.
+# In (large) monorepos, this can be used to index only subfolders of the project root, e.g.
+# ls_workspace_folders:
+# - "./subproject1"
+# - "./subproject2"
+ls_workspace_folders:
+- .
+
+# list of additional workspace folder paths for cross-package reference support.
+# Paths can be absolute or relative to the project root.
+# Each folder is registered as an LSP workspace folder, enabling language servers to discover
+# symbols and references across package boundaries, but these folders are not indexed by Serena,
+# i.e. the respective symbols will not be found using Serena's symbol search tools.
+# Example:
+# additional_workspace_folders:
+# - ../sibling-package
+# - ../shared-lib
+ls_additional_workspace_folders: []
+
+# optional shell command to run before the language backend (LSP or JetBrains) is initialised.
+# the command runs in the project root directory and is only executed if the project is trusted
+# (see trusted_project_path_patterns in the global configuration).
+# serena waits for the command to exit: a non-zero exit code is logged as an error but does not
+# abort activation. a per-project timeout (activation_command_timeout, default 180s) is the safety
+# backstop for non-terminating commands; on expiry the process is killed and activation continues.
+# example: activation_command: "npx nx run-many -t build"
+activation_command:
+
+# maximum time in seconds to wait for activation_command to complete before killing it (default 180s).
+# must be a positive number.
+activation_command_timeout: 180.0
diff --git a/AGENTS.md b/AGENTS.md
index f398d6ad6..4aa6cceaa 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,7 +4,7 @@ This file provides guidance to AI coding assistants (Claude Code, Cursor, GitHub
## Project Overview
-Apache HugeGraph Toolchain - a multi-module Maven project providing utilities for the HugeGraph graph database. Current version: 1.7.0.
+Apache HugeGraph Toolchain - a multi-module Maven project providing utilities for the HugeGraph graph database. It relies on the Java Client to power loaders, CLI tools, and the modernized Hubble platform.
## Build Commands
@@ -130,22 +130,6 @@ hugegraph-loader, hugegraph-tools, hugegraph-hubble, hugegraph-spark-connector
| tools | `hugegraph-tools/src/main/java` | `org.apache.hugegraph` |
| spark | `hugegraph-spark-connector/src/main/scala` | `org.apache.hugegraph.spark` |
-## Running Applications
-
-### Hubble (Web UI on port 8088)
-```bash
-cd hugegraph-hubble/apache-hugegraph-hubble-*/bin
-./start-hubble.sh # Background
-./start-hubble.sh -f # Foreground
-./stop-hubble.sh # Stop
-```
-
-### Loader
-```bash
-cd hugegraph-loader/apache-hugegraph-loader-*
-./bin/hugegraph-loader.sh [options]
-```
-
## Docker
```bash
diff --git a/README.md b/README.md
index 3d848a2ec..322e6bda5 100644
--- a/README.md
+++ b/README.md
@@ -234,12 +234,12 @@ client := hugegraph.NewClient("http://localhost:8080", "hugegraph")
**Purpose**: Web-based graph management and visualization platform
**Key Features**:
-- Schema management with visual editor
-- Data loading interface
-- Graph visualization and exploration
-- Gremlin query console
-- Multi-graph workspace management
-- User authentication and authorization
+- Multi-graph workspace & connection management
+- Interactive schema management with graphical editor
+- Comprehensive data loading dashboard
+- Dynamic graph visualization with path and topology canvas
+- Built-in Gremlin query console & algorithm explorer
+- Fine-grained user authentication & multi-language localization (i18n)
**Technology Stack**: Spring Boot + React + TypeScript + MobX + Ant Design
diff --git a/hugegraph-client/pom.xml b/hugegraph-client/pom.xml
index 745a37370..09895cc0d 100644
--- a/hugegraph-client/pom.xml
+++ b/hugegraph-client/pom.xml
@@ -61,12 +61,10 @@
org.apache.hugegraph
hg-pd-client
- 1.5.0
org.apache.hugegraph
hg-pd-grpc
- 1.5.0
@@ -78,10 +76,9 @@
${compiler.source}
${compiler.target}
-
- 500
-
+ -Xmaxerrs
+ 500
-Xlint:unchecked
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/UserAPI.java b/hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/UserAPI.java
index 018c8dbe6..ff43a01c9 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/UserAPI.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/api/auth/UserAPI.java
@@ -69,6 +69,12 @@ public List list(int limit) {
return result.readList(this.type(), User.class);
}
+ public User getByName(String name) {
+ Map params = ImmutableMap.of("name", name);
+ RestResult result = this.client.get(this.path(), params);
+ return result.readObject(User.class);
+ }
+
public User update(User user) {
String id = formatEntityId(user.id());
RestResult result = this.client.put(this.path(), id, user);
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/api/graphs/GraphsAPI.java b/hugegraph-client/src/main/java/org/apache/hugegraph/api/graphs/GraphsAPI.java
index 030cf1260..073adaf23 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/api/graphs/GraphsAPI.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/api/graphs/GraphsAPI.java
@@ -18,6 +18,7 @@
package org.apache.hugegraph.api.graphs;
import java.util.ArrayList;
+import java.util.Collections;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
@@ -109,19 +110,20 @@ public List> listProfile(String prefix) {
return profiles;
}
- public Map setDefault(String name) {
+ public Map setDefault(String name) {
String defaultPath = joinPath(this.path(), name, "default");
- RestResult result = this.client.get(defaultPath);
+ RestResult result = this.client.post(defaultPath, Collections.emptyMap());
return result.readObject(Map.class);
}
- public Map unSetDefault(String name) {
- String unDefaultPath = joinPath(this.path(), name, "undefault");
- RestResult result = this.client.get(unDefaultPath);
+ public Map unSetDefault(String name) {
+ String unDefaultPath = joinPath(this.path(), name, "default");
+ RestResult result = this.client.delete(unDefaultPath,
+ Collections.emptyMap());
return result.readObject(Map.class);
}
- public Map getDefault() {
+ public Map getDefault() {
String defaultPath = joinPath(this.path(), "default");
RestResult result = this.client.get(defaultPath);
return result.readObject(Map.class);
@@ -170,6 +172,11 @@ public void drop(String graph, String message) {
ImmutableMap.of(CONFIRM_MESSAGE, message));
}
+ /**
+ * @deprecated Current Server per-graph management accepts only update.
+ * Use {@link #reload()} for a whole-server graph reload.
+ */
+ @Deprecated
public Map reload(String name) {
RestResult result = this.client.put(this.path(), name,
ImmutableMap.of("action", "reload"));
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/api/space/GraphSpaceAPI.java b/hugegraph-client/src/main/java/org/apache/hugegraph/api/space/GraphSpaceAPI.java
index b04408fda..ab611a3f2 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/api/space/GraphSpaceAPI.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/api/space/GraphSpaceAPI.java
@@ -131,8 +131,16 @@ public Map deleteDefaultRole(String name, String user,
if (StringUtils.isNotEmpty(graph)) {
params.put("graph", graph);
}
- RestResult result = this.client.delete(path, params);
- return result.readObject(Map.class);
+ this.client.delete(path, params);
+
+ Map result = new HashMap<>();
+ result.put("user", user);
+ result.put("role", role);
+ result.put("graphSpace", name);
+ if (StringUtils.isNotEmpty(graph)) {
+ result.put("graph", graph);
+ }
+ return result;
}
public void delete(String name) {
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/client/RestClient.java b/hugegraph-client/src/main/java/org/apache/hugegraph/client/RestClient.java
index f8c57ec18..ca1dcfad3 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/client/RestClient.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/client/RestClient.java
@@ -183,7 +183,12 @@ public RestResult get(String path, Map params) {
@Override
protected void checkStatus(okhttp3.Response response, int... statuses) {
- boolean match = false;
+ // HugeGraph Server returns 200 with the updated resource for some
+ // successful DELETE operations, while hugegraph-common only passes
+ // 202/204 as the expected DELETE statuses.
+ boolean deleteOk = response.code() == 200 &&
+ "DELETE".equals(response.request().method());
+ boolean match = deleteOk;
for (int status : statuses) {
if (status == response.code()) {
match = true;
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/AuthManager.java b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/AuthManager.java
index 9f85ec4a4..6d84fdb44 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/AuthManager.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/AuthManager.java
@@ -132,6 +132,10 @@ public User getUser(Object id) {
return this.userAPI.get(id);
}
+ public User getUserByName(String name) {
+ return this.userAPI.getByName(name);
+ }
+
public User.UserRole getUserRole(Object id) {
return this.userAPI.getUserRole(id);
}
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/GraphsManager.java b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/GraphsManager.java
index aacf261f8..920dfb684 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/GraphsManager.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/GraphsManager.java
@@ -77,15 +77,15 @@ public List> listProfile(String prefix) {
return this.graphsAPI.listProfile(prefix);
}
- public Map setDefault(String name) {
+ public Map setDefault(String name) {
return this.graphsAPI.setDefault(name);
}
- public Map unSetDefault(String name) {
+ public Map unSetDefault(String name) {
return this.graphsAPI.unSetDefault(name);
}
- public Map getDefault() {
+ public Map getDefault() {
return this.graphsAPI.getDefault();
}
@@ -103,6 +103,11 @@ public void dropGraph(String graph, String message) {
this.graphsAPI.drop(graph, message);
}
+ /**
+ * @deprecated Current Server per-graph management accepts only update.
+ * Use {@link #reload()} for a whole-server graph reload.
+ */
+ @Deprecated
public void reload(String graph) {
this.graphsAPI.reload(graph);
}
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClient.java b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClient.java
index c681a76a9..6327b0023 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClient.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClient.java
@@ -108,7 +108,10 @@ public HugeClient(HugeClientBuilder builder) {
public HugeClient(HugeClient client, String graphSpace, String graph) {
this.borrowedClient = true;
this.client = client.client;
- this.initManagers(this.client, graphSpace, graph);
+ this.graphSpaceName = (graphSpace == null || graphSpace.isEmpty()) ?
+ HugeClientBuilder.DEFAULT_GRAPHSPACE : graphSpace;
+ this.graphName = graph;
+ this.initManagers(this.client, this.graphSpaceName, this.graphName);
}
public static HugeClientBuilder builder(String url, String graphSpace, String graph) {
@@ -119,8 +122,14 @@ public static HugeClientBuilder builder(String url, String graph) {
return new HugeClientBuilder(url, HugeClientBuilder.DEFAULT_GRAPHSPACE, graph);
}
+ public static HugeClientBuilder builder(String url, String graphSpace, String graph,
+ boolean skipRequiredChecks) {
+ return new HugeClientBuilder(url, graphSpace, graph).graphRequired(!skipRequiredChecks);
+ }
+
public HugeClient assignGraph(String graphSpace, String graph) {
- this.graphSpaceName = graphSpace;
+ this.graphSpaceName = (graphSpace == null || graphSpace.isEmpty()) ?
+ HugeClientBuilder.DEFAULT_GRAPHSPACE : graphSpace;
this.graphName = graph;
this.initManagers(this.client, this.graphSpaceName, this.graphName);
return this;
diff --git a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClientBuilder.java b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClientBuilder.java
index 2b5d547b3..545566243 100644
--- a/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClientBuilder.java
+++ b/hugegraph-client/src/main/java/org/apache/hugegraph/driver/HugeClientBuilder.java
@@ -54,7 +54,8 @@ public class HugeClientBuilder {
public HugeClientBuilder(String url, String graphSpace, String graph) {
this.url = url;
- this.graphSpace = graphSpace;
+ this.graphSpace = (graphSpace == null || graphSpace.isEmpty()) ?
+ DEFAULT_GRAPHSPACE : graphSpace;
this.graph = graph;
this.username = "";
this.password = "";
@@ -77,8 +78,8 @@ public HugeClient build() {
"Expect a string value as the url parameter argument, but got: %s",
this.url);
E.checkArgument(this.graph != null && !this.graph.isEmpty(),
- "Expect a string value as the graph name parameter argument, but got: %s",
- this.graph);
+ "Expect a string value as the graph name " +
+ "parameter argument, but got: %s", this.graph);
}
return new HugeClient(this);
}
@@ -89,7 +90,8 @@ public HugeClientBuilder graphRequired(boolean graphRequired) {
}
public HugeClientBuilder configGraphSpace(String graphSpace) {
- this.graphSpace = graphSpace;
+ this.graphSpace = (graphSpace == null || graphSpace.isEmpty()) ?
+ DEFAULT_GRAPHSPACE : graphSpace;
return this;
}
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/BaseClientTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/BaseClientTest.java
index 2fda81d66..50cedf646 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/BaseClientTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/BaseClientTest.java
@@ -55,6 +55,7 @@ public class BaseClientTest {
protected static final String GRAPH = "hugegraph";
protected static final String USERNAME = "admin";
protected static final String PASSWORD = "pa";
+ //protected static final String PASSWORD = "admin";
protected static final int TIMEOUT = 10;
private static HugeClient client;
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/api/TaskApiTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/api/TaskApiTest.java
index 27da38211..9e7b07201 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/api/TaskApiTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/api/TaskApiTest.java
@@ -263,20 +263,14 @@ public void testCancel() {
long taskId = gremlin().executeAsTask(request);
// Wait for task to start
- try {
- Thread.sleep(300);
- } catch (InterruptedException ignored) {
- }
-
+ sleep(300L);
+
// Cancel async task
Task task = taskAPI.cancel(taskId);
Assert.assertTrue(task.cancelling());
// Wait for cancellation to complete
- try {
- Thread.sleep(500);
- } catch (InterruptedException ignored) {
- }
+ sleep(500L);
task = taskAPI.get(taskId);
Assert.assertTrue(task.cancelled());
@@ -304,4 +298,13 @@ public void testTaskAsMap() {
Assert.assertEquals("rebuild_index", taskMap.get(Task.P.TYPE));
Assert.assertEquals("success", taskMap.get(Task.P.STATUS));
}
+
+ private static void sleep(long millis) {
+ try {
+ Thread.sleep(millis);
+ } catch (InterruptedException e) {
+ Thread.currentThread().interrupt();
+ Assert.fail(e.getMessage());
+ }
+ }
}
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LoginApiTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LoginApiTest.java
index e1dc90d7d..ae1f17e03 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LoginApiTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LoginApiTest.java
@@ -26,6 +26,7 @@
import org.apache.hugegraph.testutil.Assert;
import org.junit.AfterClass;
import org.junit.BeforeClass;
+import org.junit.Ignore;
import org.junit.Test;
public class LoginApiTest extends AuthApiTest {
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LogoutApiTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LogoutApiTest.java
index 24c777807..de4549d04 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LogoutApiTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/LogoutApiTest.java
@@ -28,6 +28,7 @@
import org.apache.hugegraph.testutil.Whitebox;
import org.junit.AfterClass;
import org.junit.BeforeClass;
+import org.junit.Ignore;
import org.junit.Test;
public class LogoutApiTest extends AuthApiTest {
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/TokenApiTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/TokenApiTest.java
index 9dcec5a30..b0d8407cb 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/TokenApiTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/api/auth/TokenApiTest.java
@@ -29,6 +29,7 @@
import org.apache.hugegraph.testutil.Whitebox;
import org.junit.AfterClass;
import org.junit.BeforeClass;
+import org.junit.Ignore;
import org.junit.Test;
public class TokenApiTest extends AuthApiTest {
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/functional/AuthManagerTest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/functional/AuthManagerTest.java
index 243cb1f17..6b4f82860 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/functional/AuthManagerTest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/functional/AuthManagerTest.java
@@ -41,6 +41,7 @@
import org.apache.hugegraph.testutil.Assert;
import org.junit.After;
import org.junit.Before;
+import org.junit.Ignore;
import org.junit.Test;
import com.google.common.collect.ImmutableSet;
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphSpaceAPITest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphSpaceAPITest.java
new file mode 100644
index 000000000..1ffc87a0e
--- /dev/null
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphSpaceAPITest.java
@@ -0,0 +1,68 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with this
+ * work for additional information regarding copyright ownership. The ASF
+ * licenses this file to You under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.hugegraph.unit;
+
+import java.util.Map;
+
+import org.apache.hugegraph.api.space.GraphSpaceAPI;
+import org.apache.hugegraph.client.RestClient;
+import org.apache.hugegraph.rest.RestResult;
+import org.apache.hugegraph.testutil.Assert;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.ArgumentCaptor;
+import org.mockito.Mockito;
+
+public class GraphSpaceAPITest extends BaseUnitTest {
+
+ private RestClient mockClient;
+ private GraphSpaceAPI graphSpaceAPI;
+
+ @Before
+ public void setup() {
+ this.mockClient = Mockito.mock(RestClient.class);
+ this.graphSpaceAPI = new GraphSpaceAPI(this.mockClient);
+ }
+
+ @Test
+ public void testDeleteDefaultRoleDoesNotReadEmptyResponseBody() {
+ RestResult mockResult = Mockito.mock(RestResult.class);
+ Mockito.when(mockResult.readObject(Map.class))
+ .thenThrow(new AssertionError("204 response has no body"));
+
+ ArgumentCaptor pathCaptor =
+ ArgumentCaptor.forClass(String.class);
+ @SuppressWarnings("unchecked")
+ ArgumentCaptor> paramsCaptor =
+ ArgumentCaptor.forClass(Map.class);
+
+ Mockito.when(this.mockClient.delete(pathCaptor.capture(),
+ paramsCaptor.capture()))
+ .thenReturn(mockResult);
+
+ Map response = this.graphSpaceAPI.deleteDefaultRole(
+ "DEFAULT", "admin", "SPACE", "");
+
+ Assert.assertEquals("graphspaces/DEFAULT/role", pathCaptor.getValue());
+ Assert.assertEquals("admin", paramsCaptor.getValue().get("user"));
+ Assert.assertEquals("SPACE", paramsCaptor.getValue().get("role"));
+ Assert.assertEquals("admin", response.get("user"));
+ Assert.assertEquals("SPACE", response.get("role"));
+ Assert.assertEquals("DEFAULT", response.get("graphSpace"));
+ }
+}
diff --git a/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphsAPITest.java b/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphsAPITest.java
index d10f84f45..ac99cd9fb 100644
--- a/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphsAPITest.java
+++ b/hugegraph-client/src/test/java/org/apache/hugegraph/unit/GraphsAPITest.java
@@ -21,6 +21,7 @@
import org.apache.hugegraph.api.graphs.GraphsAPI;
import org.apache.hugegraph.client.RestClient;
+import org.apache.hugegraph.driver.GraphsManager;
import org.apache.hugegraph.rest.RestHeaders;
import org.apache.hugegraph.rest.RestResult;
import org.apache.hugegraph.testutil.Assert;
@@ -107,4 +108,63 @@ public void testCloneGraphUsesJsonContentTypeAndParams() {
Assert.assertEquals("source-graph",
capturedParams.get("clone_graph_name"));
}
+
+ @Test
+ public void testSetDefaultGraphUsesCanonicalPost() {
+ RestResult mockResult = Mockito.mock(RestResult.class);
+ Mockito.when(mockResult.readObject(Map.class))
+ .thenReturn(null);
+
+ ArgumentCaptor pathCaptor =
+ ArgumentCaptor.forClass(String.class);
+ ArgumentCaptor