fix(tests,langchain,demo): use params keyword, assert schema_mode, pin demo image version

- langchain graph.py: pass params={} as keyword argument to cypher()
- test_sdk.py: assert schema_mode is int in (0, 3) in flexible-mode test;
  document RETURN n → Value::Int(node_id) in FTS tests
- demo/docker-compose.yml: pin coordinode:0.3.11 (was :latest)

Author: polaz

demo/docker-compose.yml

@@ -0,0 +1,42 @@
+services:
+  coordinode:
+    image: ghcr.io/structured-world/coordinode:0.3.11
+    container_name: demo-coordinode
+    ports:
+      - "37080:7080"   # gRPC (native API)
+      - "37084:7084"   # Prometheus /metrics, /health
+    volumes:
+      - coordinode-data:/data
+    environment:
+      - COORDINODE_LOG_FORMAT=text
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "/coordinode", "version"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+      start_period: 5s
+
+  jupyter:
+    build:
+      context: .
+      dockerfile: Dockerfile.jupyter
+    container_name: demo-jupyter
+    ports:
+      - "38888:8888"   # Jupyter Lab
+    volumes:
+      - ./notebooks:/home/jovyan/work
+      - ../:/sdk       # mount SDK source so notebooks can pip install -e
+    environment:
+      - COORDINODE_ADDR=coordinode:7080    # internal network address
+      - JUPYTER_ENABLE_LAB=yes
+      - JUPYTER_TOKEN=demo
+      - SETUPTOOLS_SCM_PRETEND_VERSION=0.0.0  # hatch-vcs: skip git, use fixed version
+    depends_on:
+      coordinode:
+        condition: service_healthy
+    restart: unless-stopped
+
+volumes:
+  coordinode-data:
+    driver: local

langchain-coordinode/langchain_coordinode/graph.py

@@ -154,7 +154,7 @@ def refresh_schema(self) -> None:
         # published Docker image (tracked in G010 / GAPS.md).
         rows = self._client.cypher(
             "MATCH (a)-[r]->(b) RETURN DISTINCT labels(a) AS src_labels, type(r) AS rel, labels(b) AS dst_labels",
-            {},
+            params={},
         )
         if rows:
             triples: set[tuple[str, str, str]] = set()

tests/integration/test_sdk.py

@@ -489,6 +489,8 @@ def test_create_label_schema_mode_flexible(client):
     info = client.create_label(name, schema_mode="flexible")
     assert isinstance(info, LabelInfo)
     assert info.name == name
+    assert isinstance(info.schema_mode, int)
+    assert info.schema_mode in (0, 3)  # 0 on older servers, 3 = FLEXIBLE
 
 
 def test_create_label_invalid_schema_mode_raises(client):
@@ -593,6 +595,8 @@ def test_text_search_returns_results(client):
     """text_search() finds nodes whose text property matches the query."""
     label = f"FtsTest_{uid()}"
     tag = uid()
+    # CoordiNode executor serialises a node variable as Value::Int(node_id) — runner.rs NodeScan
+    # path. No id() function needed; rows[0]["node_id"] is the integer internal node id.
     rows = client.cypher(
         f"CREATE (n:{label} {{tag: $tag, body: 'machine learning and neural networks'}}) RETURN n AS node_id",
         params={"tag": tag},
@@ -648,6 +652,7 @@ def test_hybrid_text_vector_search_returns_results(client):
     label = f"FtsHybridTest_{uid()}"
     tag = uid()
     vec = [float(i) / 16 for i in range(16)]
+    # Same node-as-int pattern: RETURN n → Value::Int(node_id) in CoordiNode executor.
     rows = client.cypher(
         f"CREATE (n:{label} {{tag: $tag, body: 'graph neural network embedding', embedding: $vec}}) RETURN n AS node_id",
         params={"tag": tag, "vec": vec},