This is an automated email from the ASF dual-hosted git repository. imbajin pushed a commit to branch goal-test in repository https://gitbox.apache.org/repos/asf/hugegraph-ai.git
commit c27b504c775f69deddf6e8b8eb6d72959d1658ac Author: imbajin <[email protected]> AuthorDate: Sun May 31 01:32:17 2026 +0800 docs(quality): record client contract service blocker - capture unavailable local Docker and HugeGraph service checks - pause G2 before unverifiable Layer B contract edits - document resume condition for HugeGraph 1.7.0 --- .../checkpoints/03-client-contract.md | 49 ++++++++++++++++++++++ .workflow/quality-program/quality-state.json | 12 ++++-- .../quality-program/reports/flaky-risk-ledger.md | 1 + 3 files changed, 58 insertions(+), 4 deletions(-) diff --git a/.workflow/quality-program/checkpoints/03-client-contract.md b/.workflow/quality-program/checkpoints/03-client-contract.md new file mode 100644 index 00000000..594a24c7 --- /dev/null +++ b/.workflow/quality-program/checkpoints/03-client-contract.md @@ -0,0 +1,49 @@ +# G2 Client Contract Checkpoint + +## Status + +Blocked before client contract edits. + +## Blocker + +Required HugeGraph service is unavailable locally: + +- `docker ps --format '{{.Names}} {{.Image}} {{.Ports}}'` failed because the Docker daemon is not reachable at `/Users/imbajin/.orbstack/run/docker.sock`. +- Direct `GET http://127.0.0.1:8080/versions` failed with `ConnectionRefusedError`. + +The plan requires Layer B client contract tests to run against a real HugeGraph service and forbids silently skipping selected HugeGraph integration tests. Continuing into G2 test additions without a service would leave the core contract proof unverifiable. + +## Commands Run + +```bash +docker ps --format '{{.Names}} {{.Image}} {{.Ports}}' +uv run python -c "import requests; print(requests.get('http://127.0.0.1:8080/versions', timeout=5).text[:200])" +``` + +## Files Touched + +- `.workflow/quality-program/checkpoints/03-client-contract.md` +- `.workflow/quality-program/quality-state.json` +- `.workflow/quality-program/reports/flaky-risk-ledger.md` + +## Production Changes + +None. + +## Tests Added or Changed + +None. + +## Failure Classification + +Service setup failure: HugeGraph Server `1.7.0` is not reachable, and Docker cannot start or inspect containers because the local daemon is unavailable. + +## Resume Condition + +Start a HugeGraph `1.7.0` service reachable at `http://127.0.0.1:8080`, or start the local Docker/OrbStack daemon so the service can be launched with: + +```bash +docker run -d --name hugegraph-quality -p 8080:8080 -e PASSWORD=admin hugegraph/hugegraph:1.7.0 +``` + +Then resume G2 from Step G2.1. diff --git a/.workflow/quality-program/quality-state.json b/.workflow/quality-program/quality-state.json index 385a3954..3f68f08c 100644 --- a/.workflow/quality-program/quality-state.json +++ b/.workflow/quality-program/quality-state.json @@ -57,7 +57,8 @@ ".github/workflows/hugegraph-python-client.yml", ".github/workflows/hugegraph-llm.yml", "docs/quality/hugegraph-integration.md", - ".workflow/quality-program/checkpoints/02-service-fixture.md" + ".workflow/quality-program/checkpoints/02-service-fixture.md", + ".workflow/quality-program/checkpoints/03-client-contract.md" ], "production_changes": [], "tests_added_or_changed": [ @@ -97,12 +98,15 @@ "uv run ruff format --check hugegraph-python-client/src/tests hugegraph-llm/src/tests", "uv run ruff check hugegraph-python-client/src/tests hugegraph-llm/src/tests", "git diff --check", - "uv run python -c \"import yaml, pathlib; [yaml.safe_load(pathlib.Path(p).read_text()) for p in ['.github/workflows/hugegraph-llm.yml','.github/workflows/hugegraph-python-client.yml']]\"" + "uv run python -c \"import yaml, pathlib; [yaml.safe_load(pathlib.Path(p).read_text()) for p in ['.github/workflows/hugegraph-llm.yml','.github/workflows/hugegraph-python-client.yml']]\"", + "docker ps --format '{{.Names}} {{.Image}} {{.Ports}}'", + "uv run python -c \"import requests; print(requests.get('http://127.0.0.1:8080/versions', timeout=5).text[:200])\"" ], "known_failures": [ "Root-level LLM collection command fails before collection because existing prompt config requires cwd hugegraph-llm.", "Initial coverage command failed before uv sync because pytest-cov was missing from the active environment.", - "LLM integration and hugegraph collection is empty before G3 adds real-boundary tests; pytest returns exit code 5." + "LLM integration and hugegraph collection is empty before G3 adds real-boundary tests; pytest returns exit code 5.", + "G2 blocked: Docker daemon is unavailable and no HugeGraph service is reachable at http://127.0.0.1:8080/versions."; ], "deferred_items": [ "Avoid #350/#277 YAML config migration files unless tests require a narrow compatibility assertion.", @@ -111,5 +115,5 @@ "Avoid #240 vector/property embedding abstraction surface.", "Quarantine client/test fixes overlapping #323/#329/#342 until exact changed files are inspected." ], - "next_recommended_action": "Harden pyhugegraph contract coverage" + "next_recommended_action": "Start Docker/OrbStack and HugeGraph 1.7.0, then resume G2 from Step G2.1" } diff --git a/.workflow/quality-program/reports/flaky-risk-ledger.md b/.workflow/quality-program/reports/flaky-risk-ledger.md index 80a138fe..8bf1e03a 100644 --- a/.workflow/quality-program/reports/flaky-risk-ledger.md +++ b/.workflow/quality-program/reports/flaky-risk-ledger.md @@ -6,3 +6,4 @@ | LLM external skip control | Global `SKIP_EXTERNAL_SERVICES=true` prevents selected real HugeGraph boundary tests from opting in | P0 records current issue only | G0/G1 should switch to default-only skip semantics and explicit Layer B fixture behavior | | Client integration selection | Full client suite currently mixes service-bound and local tests | P0 records current issue only | G0/G1 should add markers and fixture-driven selection | | Open PR collisions | Parallel PRs touch config, vertex IDs, Gremlin examples, flow tests, vector/property embedding, and async API | Quarantine list in `00-preflight.md` | Inspect exact files before goals touching those surfaces | +| Local HugeGraph service for G2 | Docker daemon unavailable and no service reachable at `127.0.0.1:8080` | G2 paused before adding unverifiable service-bound tests | Start Docker/OrbStack and HugeGraph `1.7.0`, then resume G2 |
