hierarchy

No hooks declared

• NodeArchived v1
  When a node is archived (including cascade)
  payload: {node_id, archived_at, archived_by_cascade}
• NodeUnarchived v1
  When a node is unarchived
  payload: {node_id, unarchived_at}
• NodeMoved v1
  When a node is moved to a new parent
  payload: {node_id, old_parent_id, new_parent_id}
• SiblingsReordered v1
  When sibling order is changed
  payload: {parent_id, ordered_ids, reordered_at}

from psp.platform.hierarchy import InMemoryHierarchyTree, HierarchyReaderPort

class ContainerRepository:
    def __init__(self, hierarchy: HierarchyReaderPort):
        self._hierarchy = hierarchy

    def get_breadcrumb(self, container_id: UUID) -> list[str]:
        ancestors = self._hierarchy.get_ancestors(
            container_id, include_self=True
        )
        return [self._get_name(a.id) for a in reversed(ancestors)]

Use hierarchy for task container organization.

tree = InMemoryHierarchyTree(max_depth=10)

# Create folder structure
root = uuid4()
tree.register_node(root)

documents = uuid4()
tree.register_node(documents, parent_id=root)

# Get depth
depth = tree.get_depth(documents)
print(f"Depth: {depth}")  # 1

Organize documents in nested folders.

from psp.platform.hierarchy import InMemoryHierarchyTree

tree = InMemoryHierarchyTree()

# Archive subtree
archived_ids = tree.archive_subtree(container_id)

# Get and publish events
for event in tree.pop_events():
    print(f"Event: {type(event).__name__} for {event.node_id}")

Publish events after archiving a subtree.