Graph-Native Infrastructure for Context and Accountable AI Systems
Python agent-memoryaiai-governanceai-infrastructureartificial-intelligencecontext-engineeringcontext-graphsdata-engineeringdecision-intelligencedeveloper-toolsexplainable-aigenerative-aigraph-ragknowledge-graphllmontologyprovenancepythonreasoningsemantic-search
fix(context): treat Node2Vec as optional when gensim is missing (#1728)
Chaoqi5bf81ae45018
diff --git a/semantica/context/context_graph.py b/semantica/context/context_graph.pyindex 00528f49..96445253 100644--- a/semantica/context/context_graph.py+++ b/semantica/context/context_graph.py@@ -654,7 +654,10 @@ class ContextGraph:if self.config.get("community_detection", True):self.kg_components["community_detector"] = CommunityDetector()if self.config.get("node_embeddings", True):- self.kg_components["node_embedder"] = NodeEmbedder()+ try:+ self.kg_components["node_embedder"] = NodeEmbedder()+ except ImportError as e:+ self.logger.warning(f"Node2Vec embeddings disabled: {e}")self.kg_components["path_finder"] = PathFinder()self.kg_components["similarity_calculator"] = SimilarityCalculator()self.kg_components["connectivity_analyzer"] = ConnectivityAnalyzer()diff --git a/semantica/context/decision_query.py b/semantica/context/decision_query.pyindex 4fb0dc39..612d035e 100644--- a/semantica/context/decision_query.py+++ b/semantica/context/decision_query.py@@ -148,7 +148,10 @@ class DecisionQuery:if community_detection:self.kg_components["community_detector"] = CommunityDetector()if node_embeddings:- self.kg_components["node_embedder"] = NodeEmbedder()+ try:+ self.kg_components["node_embedder"] = NodeEmbedder()+ except ImportError as e:+ self.logger.warning(f"Node2Vec embeddings disabled: {e}")self.kg_components["path_finder"] = PathFinder()self.kg_components["similarity_calculator"] = SimilarityCalculator()if link_prediction:diff --git a/semantica/vector_store/decision_embedding_pipeline.py b/semantica/vector_store/decision_embedding_pipeline.pyindex 882f7b40..f8b32014 100644--- a/semantica/vector_store/decision_embedding_pipeline.py+++ b/semantica/vector_store/decision_embedding_pipeline.py@@ -138,14 +138,19 @@ class DecisionEmbeddingPipeline:# Initialize node embedder if graph store providedif graph_store:- self.node_embedder = node_embedder or NodeEmbedder(- method="node2vec",- embedding_dimension=node_embedding_dimension,- walk_length=80,- num_walks=10,- p=1.0,- q=1.0- )+ if node_embedder is None:+ try:+ node_embedder = NodeEmbedder(+ method="node2vec",+ embedding_dimension=node_embedding_dimension,+ walk_length=80,+ num_walks=10,+ p=1.0,+ q=1.0+ )+ except ImportError as e:+ self.logger.warning(f"Structural embeddings disabled: {e}")+ self.node_embedder = node_embedder# Initialize advanced KG algorithms if enabledif self.use_graph_features:@@ -198,7 +203,9 @@ class DecisionEmbeddingPipeline:)# Enrich metadata- enriched_metadata = self._enrich_metadata(decision_data)+ enriched_metadata = self._enrich_metadata(+ decision_data, structural_embedding is not None+ )# Store embeddings if requestedvector_id = None@@ -709,7 +716,9 @@ class DecisionEmbeddingPipeline:return combined- def _enrich_metadata(self, decision_data: Dict[str, Any]) -> Dict[str, Any]:+ def _enrich_metadata(+ self, decision_data: Dict[str, Any], has_structural_embedding: bool+ ) -> Dict[str, Any]:"""Enrich decision metadata with additional information."""metadata = decision_data.copy()@@ -719,7 +728,7 @@ class DecisionEmbeddingPipeline:"embedding_generated_at": datetime.now(timezone.utc).isoformat(),"semantic_weight": self.semantic_weight,"structural_weight": self.structural_weight,- "has_structural_embedding": self.graph_store is not None+ "has_structural_embedding": has_structural_embedding})return metadatadiff --git a/tests/test_issue_1513_slim_core.py b/tests/test_issue_1513_slim_core.pyindex 5d186907..2c4d3edd 100644--- a/tests/test_issue_1513_slim_core.py+++ b/tests/test_issue_1513_slim_core.py@@ -251,6 +251,51 @@ def test_node_embedder_gensim_missing_hint():NodeEmbedder()+def test_agent_context_with_graph_builds_without_gensim():+ with patch("semantica.kg.node_embeddings.GENSIM_AVAILABLE", False):+ from semantica.context import AgentContext, ContextGraph+ from semantica.vector_store import VectorStore++ ctx = AgentContext(+ vector_store=VectorStore(backend="inmemory", dimension=64),+ knowledge_graph=ContextGraph(),+ decision_tracking=True,+ )+ decision_id = ctx.record_decision(+ category="loan",+ scenario="small business loan",+ reasoning="strong cash flow",+ outcome="approved",+ confidence=0.9,+ )++ assert decision_id+ assert ctx.retriever.decision_pipeline.node_embedder is None++ processed = ctx.retriever.decision_pipeline.process_decision(+ {"scenario": "small business loan"}, store_embeddings=False+ )+ assert processed["structural_embedding"] is None+ assert processed["metadata"]["has_structural_embedding"] is False+++def test_graph_components_without_gensim_keep_everything_but_node2vec():+ with patch("semantica.kg.node_embeddings.GENSIM_AVAILABLE", False):+ from semantica.context import ContextGraph, DecisionQuery++ graph_components = ContextGraph(advanced_analytics=True).kg_components+ query_components = DecisionQuery(graph_store=ContextGraph()).kg_components++ for components in (graph_components, query_components):+ assert "node_embedder" not in components+ assert {+ "centrality_calculator",+ "community_detector",+ "path_finder",+ "similarity_calculator",+ } <= set(components)++def test_faiss_store_missing_hint():with patch("semantica.vector_store.faiss_store.FAISS_AVAILABLE", False):from semantica.vector_store.faiss_store import FAISSIndexBuilder, FAISSStorediff --git a/tests/vector_store/test_decision_embedding_pipeline.py b/tests/vector_store/test_decision_embedding_pipeline.pyindex 9293f726..4b93d594 100644--- a/tests/vector_store/test_decision_embedding_pipeline.py+++ b/tests/vector_store/test_decision_embedding_pipeline.py@@ -226,7 +226,7 @@ class TestDecisionEmbeddingPipeline:def test_enrich_metadata(self):"""Test metadata enrichment."""- enriched = self.pipeline._enrich_metadata(self.sample_decision)+ enriched = self.pipeline._enrich_metadata(self.sample_decision, False)assert "pipeline_version" in enrichedassert "embedding_generated_at" in enriched@@ -236,7 +236,7 @@ class TestDecisionEmbeddingPipeline:assert enriched["semantic_weight"] == 0.7assert enriched["structural_weight"] == 0.3- assert enriched["has_structural_embedding"] == True+ assert enriched["has_structural_embedding"] is Falsedef test_find_similar_decisions(self):"""Test finding similar decisions."""