fix(notebooks,tests): clarify embedded isolation, narrow FTS xfail scope

- nb00: update intro and final message to explain that LocalClient(":memory:")
  is process-local — notebooks 01-03 cannot see seeded data in embedded mode;
  add note that cross-notebook sharing requires a shared CoordiNode server
- tests: remove raises=AssertionError from _fts xfail marker; instead call
  pytest.xfail() inline in the two hit-bearing tests when results are empty,
  so all other AssertionErrors (wrong types, malformed scores) surface as
  real failures on FTS-capable servers

Author: polaz

demo/notebooks/00_seed_data.ipynb

@@ -9,8 +9,12 @@
     "\n",
     "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/structured-world/coordinode-python/blob/main/demo/notebooks/00_seed_data.ipynb)\n",
     "\n",
-    "Populates CoordiNode with a **tech industry knowledge graph** you can explore\n",
-    "in notebooks 01–03.\n",
+    "Populates CoordiNode with a **tech industry knowledge graph**.\n",
+    "\n",
+    "> **Note:** When using `coordinode-embedded` (`LocalClient(\":memory:\")`), the seeded data\n",
+    "> lives only inside this notebook process — notebooks 01–03 will start with an empty graph.\n",
+    "> To share the graph across notebooks, point all of them at the same running CoordiNode\n",
+    "> server via `COORDINODE_ADDR`.\n",
     "\n",
     "**Graph contents:**\n",
     "- 10 people (engineers, researchers, founders)\n",
@@ -293,35 +297,7 @@
    "id": "a1b2c3d4-0000-0000-0000-000000000014",
    "metadata": {},
    "outputs": [],
-   "source": [
-    "print(\"=== Who works at Synthex? ===\")\n",
-    "rows = client.cypher(\n",
-    "    \"MATCH (p:Person {demo_tag: $tag})-[:WORKS_AT]->(c:Company {name: $co, demo_tag: $tag}) \"\n",
-    "    \"RETURN p.name AS name, p.role AS role\",\n",
-    "    params={\"co\": \"Synthex\", \"tag\": DEMO_TAG},\n",
-    ")\n",
-    "for r in rows:\n",
-    "    print(f\"  {r['name']} — {r['role']}\")\n",
-    "\n",
-    "print(\"\\n=== What does Synthex use? ===\")\n",
-    "rows = client.cypher(\n",
-    "    \"MATCH (c:Company {name: $co, demo_tag: $tag})-[:USES]->(t:Technology {demo_tag: $tag}) RETURN t.name AS name\",\n",
-    "    params={\"co\": \"Synthex\", \"tag\": DEMO_TAG}\n",
-    ")\n",
-    "for r in rows:\n",
-    "    print(f\"  {r['name']}\")\n",
-    "\n",
-    "print(\"\\n=== GraphRAG dependency chain ===\")\n",
-    "rows = client.cypher(\n",
-    "    \"MATCH (t:Technology {name: $tech, demo_tag: $tag})-[:BUILDS_ON*1..3]->(dep:Technology {demo_tag: $tag}) RETURN dep.name AS dependency\",\n",
-    "    params={\"tech\": \"GraphRAG\", \"tag\": DEMO_TAG},\n",
-    ")\n",
-    "for r in rows:\n",
-    "    print(f\"  → {r['dependency']}\")\n",
-    "\n",
-    "print(\"\\n✓ Demo data ready — open notebooks 01, 02, 03 to explore!\")\n",
-    "client.close()"
-   ]
+   "source": "print(\"=== Who works at Synthex? ===\")\nrows = client.cypher(\n    \"MATCH (p:Person {demo_tag: $tag})-[:WORKS_AT]->(c:Company {name: $co, demo_tag: $tag}) \"\n    \"RETURN p.name AS name, p.role AS role\",\n    params={\"co\": \"Synthex\", \"tag\": DEMO_TAG},\n)\nfor r in rows:\n    print(f\"  {r['name']} — {r['role']}\")\n\nprint(\"\\n=== What does Synthex use? ===\")\nrows = client.cypher(\n    \"MATCH (c:Company {name: $co, demo_tag: $tag})-[:USES]->(t:Technology {demo_tag: $tag}) RETURN t.name AS name\",\n    params={\"co\": \"Synthex\", \"tag\": DEMO_TAG}\n)\nfor r in rows:\n    print(f\"  {r['name']}\")\n\nprint(\"\\n=== GraphRAG dependency chain ===\")\nrows = client.cypher(\n    \"MATCH (t:Technology {name: $tech, demo_tag: $tag})-[:BUILDS_ON*1..3]->(dep:Technology {demo_tag: $tag}) RETURN dep.name AS dependency\",\n    params={\"tech\": \"GraphRAG\", \"tag\": DEMO_TAG},\n)\nfor r in rows:\n    print(f\"  → {r['dependency']}\")\n\nprint(\"\\n✓ Demo data seeded.\")\nprint(\"To query it from notebooks 01–03, connect them to the same CoordiNode server (COORDINODE_ADDR).\")\nclient.close()"
   }
  ],
  "metadata": {

tests/integration/test_sdk.py

@@ -566,19 +566,21 @@ def test_vector_search_returns_results(client):
 def _fts(fn):
     """Mark an FTS test as expected-failure on servers without TextService.
 
-    Two expected failure modes:
-    - ``AssertionError``: server returns an empty result set (no FTS index), caught
-      by the marker directly so pytest reports it as xfail.
-    - ``grpc.StatusCode.UNIMPLEMENTED``: TextService RPC does not exist yet; we call
-      ``pytest.xfail()`` explicitly so only that specific status code is silenced.
-      Any other ``grpc.RpcError`` (e.g. INVALID_ARGUMENT from a malformed request)
-      propagates as a real test failure, preventing regressions from being masked.
+    Expected failure modes handled explicitly — NOT via ``raises=`` on the marker:
+    - ``grpc.StatusCode.UNIMPLEMENTED``: TextService RPC does not exist; caught in
+      the wrapper and converted to ``pytest.xfail()`` so only this status is silenced.
+    - Empty result set: tests that require at least one hit call ``pytest.xfail()``
+      inline (``if not results: pytest.xfail(...)``), keeping the xfail scoped to
+      that specific condition.
+
+    Any ``AssertionError`` that is NOT the "no results" case (e.g. wrong return type,
+    malformed score) propagates as a real test failure so regressions on FTS-capable
+    servers are visible in CI.
     """
 
     @pytest.mark.xfail(
         reason="TextService requires CoordiNode >=0.3.8 with FTS support",
         strict=False,
-        raises=AssertionError,
     )
     @functools.wraps(fn)
     def wrapper(*args, **kwargs):
@@ -603,7 +605,8 @@ def test_text_search_returns_results(client):
     try:
         results = client.text_search("FtsTest", "machine learning", limit=5)
         assert isinstance(results, list)
-        assert len(results) >= 1, "text_search returned no results"
+        if not results:
+            pytest.xfail("text_search returned no results — FTS index not available on this server")
         r = results[0]
         assert isinstance(r, TextResult)
         assert isinstance(r.node_id, int)
@@ -656,7 +659,8 @@ def test_hybrid_text_vector_search_returns_results(client):
             limit=5,
         )
         assert isinstance(results, list)
-        assert len(results) >= 1, "hybrid_text_vector_search returned no results"
+        if not results:
+            pytest.xfail("hybrid_text_vector_search returned no results — FTS index not available on this server")
         r = results[0]
         assert isinstance(r, HybridResult)
         assert isinstance(r.node_id, int)