Knowledge Wiki Orchestrata Ultimate

orchestrata_kg.semantic_graph

Reference › components › knowledge_graph › orchestrata_kg › semantic_graph

The semantic (vector plus graph) retrieval layer of orchestrata_kg. The interfaces are semantic_graph, graph_store, vector_store and embedder, with data types entity, relationship, chunk and graph_r_a_g_context. Embedding backends are chosen by embedder_factory among open_router_embedder and sentence_transformer_embedder; open_router_reranker reranks results. Ingestion is code_chunker and semantic_graph_ingester, with _freshness tracking content hashes so unchanged files are not re-ingested, and spec_trace_parser and spec_trace_enricher bring in spec traces. High availability is handled by memgraph_h_a_controller (518 lines), ha_controller and main_discovery, the client-side discovery of the current Memgraph main bolt URI. architecture_twin models the architecture. The backends are in adapters. See the semantic_graph narrative.

37 modules, 5,317 lines of code.

Subpackages

Package Modules LOC
adapters 2 1,315

Modules

Module Summary LOC Lifted from
_freshness Content-hash based freshness tracking for semantic-graph re-ingestion. 138 lifted from orchestrata_ultimate.semantic_graph._freshness
architecture_twin 327 lifted from orchestrata_ultimate.semantic_graph.architecture_twin
chunk 22
cluster_status 17
code_chunker 284
connection_error 10
embedder 34
embedder_factory Which embedding backend — a choice, where it used to be a constant. 220 lifted from orchestrata_ultimate.semantic_graph.embedder_factory
enrichment_summary 31
entity 21
entity_not_found_error 10
graph_r_a_g_context 23
graph_store 32
ha_controller Residue-only lift of frozen semantic_graph.ha_controller (ADR-0103 P2-F). 34 lifted from orchestrata_ultimate.semantic_graph.ha_controller
main_discovery Client-side discovery of the current Memgraph MAIN data-instance bolt URI. 163 lifted from orchestrata_ultimate.semantic_graph.main_discovery
memgraph_h_a_controller 518
node_config 19
node_state 19
open_router_embedder 260
open_router_reranker 141
query_error 10
relationship 27
repository Repository factory for semantic graph backends. 56 lifted from orchestrata_ultimate.semantic_graph.repository
requirement_info 28
semantic_graph 42
semantic_graph_config 127
semantic_graph_error 9
semantic_graph_ingester 306
sentence_transformer_embedder 112
spec_info 40
spec_trace_enricher 430 lifted from orchestrata_ultimate.semantic_graph.spec_trace_enricher
spec_trace_parser Residue-only lift of frozen semantic_graph.spec_trace_parser (ADR-0103 P2-F). 427 lifted from orchestrata_ultimate.semantic_graph.spec_trace_parser
story_info 32
vector_search_error 10
vector_store 23

Dependency diagram

Package dependency diagram orchestrata_kg.semantic_graph