Single-store text_key / index_doc_id

Completion

In this exercise, you will implement the deterministic node ID and collection naming pattern used by the LlamaIndex + Qdrant integration to ensure idempotent re‑runs — the same corpus always creates or upserts the same Qdrant points, never appending duplicates.

You are given a partial scaffold with two functions and a comment placeholder. Your tasks:

Implement _stable_node_ids – assign each TextNode a deterministic UUID5 (based on uuid.NAMESPACE_DNS and a string combining namespace and the node’s original node_id). Overwrite the node’s node_id with the string form of that UUID.
Implement _collection_name – return a string "kg-<sanitized_namespace>-<12_hex_fp>" where the fingerprint is the first 12 hex characters of the SHA‑256 hash of the sorted stable node IDs (use '\x1f' as separator between IDs). Sanitize the namespace by replacing any non‑alphanumeric (except _ and -) character with _, defaulting to "content" if empty.
Explain – provide a short comment (or print) that explains why the in‑memory docstore is left empty by design on this Qdrant path (refer to the real source’s use of text_key and index_doc_id).

Fill in the three # TODO: blanks in the starter code below.

Your code

import hashlib
import re
import uuid
from typing import List

from llama_index.core.schema import TextNode

def _stable_node_ids(nodes: List[TextNode], *, namespace: str = "") -> None:
    """Assign each node a deterministic UUID5 based on its original node_id and namespace.
    This ensures the same input yields the same node IDs across runs."""
    # TODO: For each node, generate a UUID5 using uuid.NAMESPACE_DNS and a string
    # combining namespace and node.node_id. Overwrite node.node_id.
    pass

def _collection_name(nodes: List[TextNode], *, namespace: str = "") -> str:
    """Return a collection name of the form 'kg-<namespace>-<fp12>' where fp is the first 12 hex chars
    of the SHA256 hash of the sorted stable node IDs (joined by '\x1f')."""
    # TODO: Sanitize namespace (replace non-alphanumeric except '-', '_' with '_'), default "content".
    # Compute fingerprint from sorted node_ids, using '\x1f' as separator.
    # Return formatted string.
    return ""

# --- Explanation: why is the docstore empty by design? ---
# TODO: Write a comment (or assign to a variable) that explains that the Qdrant payload
# (text and metadata stored via text_key="text" and index_doc_id=True) is the single source
# of truth; the in-process docstore is intentionally not populated to avoid duplication.

Sources

roadmap-kg/kg/memory_common.py:920-928
roadmap-kg/kg/memory_common.py:931-972
roadmap-kg/kg/ground_content.py:519-546