Add durable portable graph publication

src/docforge/models.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from collections.abc import Mapping
 from dataclasses import asdict, dataclass
 from pathlib import Path
-from typing import Protocol, runtime_checkable
+from typing import Literal, Protocol, runtime_checkable
 
 
 @dataclass(frozen=True)
@@ -49,6 +49,33 @@ class RenderConfig:
     views: tuple[RenderView, ...]
 
 
+@dataclass(frozen=True)
+class GraphRenderView:
+    view_id: str
+    renderer: str
+    output_path: Path
+    title: str
+    root_node_id: str | None
+    query: str | None
+    initial_mode: Literal["nodes", "flow", "web", "logic"]
+    depth: int
+    max_nodes: int
+    max_edges: int
+    max_work: int
+    families: tuple[str, ...]
+    relations: tuple[str, ...]
+    authorities: tuple[str, ...]
+    statuses: tuple[str, ...]
+    tags: tuple[str, ...]
+    include_logic: bool
+
+
+@dataclass(frozen=True)
+class GraphRenderConfig:
+    output_root: Path
+    views: tuple[GraphRenderView, ...]
+
+
 @dataclass(frozen=True)
 class ContextProfile:
     profile_id: str
@@ -78,6 +105,7 @@ class ProjectDescriptor:
     allowed_relations: tuple[str, ...]
     profiles: tuple[ContextProfile, ...]
     limits: Limits
+    graph_render: GraphRenderConfig | None = None
 
 
 @dataclass(frozen=True)