feat: stabilize graph zone containers

railiance_fabric/zone_view.py

@@ -401,6 +401,8 @@ def resolve_zones(
     internal_edge_ids_by_zone_id: dict[str, list[str]] = defaultdict(list)
     boundary_edge_ids_by_zone_id: dict[str, list[str]] = defaultdict(list)
     for edge in edge_records:
+        if _is_context_only_edge(edge):
+            continue
         source_zone_id = assignments.get(edge.source).zone_id if edge.source in assignments else None
         target_zone_id = assignments.get(edge.target).zone_id if edge.target in assignments else None
         if source_zone_id and source_zone_id == target_zone_id:
@@ -484,6 +486,8 @@ def _attraction_candidates(
     nodes_by_id = {node.id: node for node in node_records}
     adjacency: dict[str, list[_EdgeRecord]] = defaultdict(list)
     for edge in edge_records:
+        if _is_context_only_edge(edge):
+            continue
         adjacency[edge.source].append(edge)
         adjacency[edge.target].append(edge)
 
@@ -619,6 +623,14 @@ def _edge_matches_attraction_rule(edge: _EdgeRecord, rule: ZoneAttractionRule) -
     return _rule_matches(edge.data, rule.edge_filter, empty_matches=True)
 
 
+def _is_context_only_edge(edge: _EdgeRecord) -> bool:
+    return _trueish(edge.data.get("displayOnly", edge.data.get("display_only"))) or edge.edge_type == "declares"
+
+
+def _trueish(value: Any) -> bool:
+    return value is True or str(value).lower() == "true"
+
+
 def _neighbor_for_direction(node_id: str, edge: _EdgeRecord, direction: str) -> str:
     if direction in {"out", "both"} and edge.source == node_id:
         return edge.target