Class TreeNode

quantmind/knowledge/_tree.py:22–44

A single node in a TreeKnowledge. `summary` is mandatory because agents navigate by reading it. `content` is the optional full-text body (typically populated only on leaves to keep the tree small in memory). `children_ids` is an adjacency list; the parent `TreeKnowledge` resolves th

class StructureTreeValidationError(ValueError):
    """A structure tree failed its code-owned integrity gate."""


class TreeNode(BaseModel):
    """A single node in a TreeKnowledge.

    `summary` is mandatory because agents navigate by reading it. `content`
    is the optional full-text body (typically populated only on leaves to
    keep the tree small in memory). `children_ids` is an adjacency list; the
    parent `TreeKnowledge` resolves them via its `nodes` map.
    """

    model_config = ConfigDict(extra="forbid", frozen=True)

    node_id: UUID = Field(default_factory=uuid4)
    parent_id: UUID | None = None
    position: int = 0
    title: str
    summary: str
    content: str | None = None
    citations: list[Citation] = Field(default_factory=list)
    children_ids: list[UUID] = Field(default_factory=list)


class StructureTree(BaseModel):