fix(client,notebooks): validate properties type in create_text_index; document hybrid index prerequisite; guard health() return value in notebooks

Author: polaz

coordinode/coordinode/client.py

@@ -623,8 +623,10 @@ async def create_text_index(
         _validate_cypher_identifier(label, "label")
         if isinstance(properties, str):
             prop_list = [properties]
-        else:
+        elif isinstance(properties, list | tuple):
             prop_list = list(properties)
+        else:
+            raise ValueError("'properties' must be a property name (str) or a list of property names")
         if not prop_list:
             raise ValueError("'properties' must contain at least one property name")
         for prop in prop_list:
@@ -785,6 +787,12 @@ async def hybrid_text_vector_search(
 
         Returns:
             List of :class:`HybridResult` ordered by RRF score descending.
+
+        Note:
+            A full-text index covering *label* **must exist** before calling this
+            method — create one with :meth:`create_text_index` or a
+            ``CREATE TEXT INDEX`` Cypher statement.  Calling this method on a
+            label without a text index returns an empty list.
         """
         from coordinode._proto.coordinode.v1.query.text_pb2 import (  # type: ignore[import]
             HybridTextVectorSearchRequest,

demo/notebooks/00_seed_data.ipynb

@@ -151,7 +151,8 @@
     "    from coordinode import CoordinodeClient\n",
     "\n",
     "    client = CoordinodeClient(COORDINODE_ADDR)\n",
-    "    client.health()\n",
+    "    if not client.health():\n",
+    "        raise RuntimeError(f\"Health check failed for {COORDINODE_ADDR}\")\n",
     "    print(f\"Connected to {COORDINODE_ADDR}\")\n",
     "else:\n",
     "    try:\n",
@@ -164,7 +165,8 @@
     "        from coordinode import CoordinodeClient\n",
     "\n",
     "        client = CoordinodeClient(COORDINODE_ADDR)\n",
-    "        client.health()\n",
+    "        if not client.health():\n",
+    "            raise RuntimeError(f\"Health check failed for {COORDINODE_ADDR}\")\n",
     "        print(f\"Connected to {COORDINODE_ADDR}\")\n",
     "    else:\n",
     "        # No server available — use the embedded in-process engine.\n",

demo/notebooks/02_langchain_graph_chain.ipynb

@@ -170,7 +170,8 @@
     "    from coordinode import CoordinodeClient\n",
     "\n",
     "    client = CoordinodeClient(COORDINODE_ADDR)\n",
-    "    client.health()\n",
+    "    if not client.health():\n",
+    "        raise RuntimeError(f\"Health check failed for {COORDINODE_ADDR}\")\n",
     "    print(f\"Connected to {COORDINODE_ADDR}\")\n",
     "else:\n",
     "    try:\n",
@@ -183,7 +184,8 @@
     "        from coordinode import CoordinodeClient\n",
     "\n",
     "        client = CoordinodeClient(COORDINODE_ADDR)\n",
-    "        client.health()\n",
+    "        if not client.health():\n",
+    "            raise RuntimeError(f\"Health check failed for {COORDINODE_ADDR}\")\n",
     "        print(f\"Connected to {COORDINODE_ADDR}\")\n",
     "    else:\n",
     "        # No server available — use the embedded in-process engine.\n",