LogicLens: Leveraging Semantic Code Graph to explore Multi Repository large systems

Niko Usai, Dario Montagnini, Kristian Ilianov Iliev, Raffaele Camanzo · 2026

Read LogicLens: Leveraging Semantic Code Graph to explore Multi Repository large systems by Niko Usai, Dario Montagnini, Kristian Ilianov Iliev, Raffaele Camanzo (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2601-10773.txt.

Introduction

Niko Usai, Dario Montagnini, Kristian Ilianov Iliev, and Raffaele Camanzo present LogicLens, a tool for grasping large software systems. Big systems sprawl across many repositories and microservices. To reason about them, developers need more than code structure. They need the domain logic and runtime behavior, which sit implicit and scattered across the codebase.

LogicLens builds a semantic code graph to explore such systems. A graph can join calls, data, and intent in one view. That helps new team members and auditors find how a feature truly works. The work speaks to engineers who inherit sprawling systems and must change them without breaking hidden links.

Catalog record

CREATORNiko Usai, Dario Montagnini, Kristian Ilianov Iliev, Raffaele Camanzo
YEAR2026
COLLECTIONPAPERS
FORMATTXT
FILE SIZE30 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2601-10773

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

LogicLens: Leveraging Semantic Code Graph to explore Multi Repository large systems Niko Usai, Dario Montagnini, Kristian Ilianov Iliev, Raffaele Camanzo Abstract Understanding large software systems is a challenging task, especially when code is distributed across multiple repositories and microservices. Developers often need to reason not only about the structure of the code, but also about its domain logic and runtime behaviors, which are typically implicit and scattered. We introduce LogicLens , a reactive conversational agent that assists developers in exploring complex software systems through a semantic multi-repository graph. This graph is built in a preprocessing step by combining syntactic code analysis, via AST parsing and repository traversal, with semantic enrichment using Large Language Models (LLMs). The resulting graph captures both structural elements, such as files, classes, and functions, as well as functional abstractions like domain entities, operations, and workflows. Once the graph is constructed, LogicLens enables developers to interact with it via natural language, dynamically retrieving relevant subgraphs and answering technical or functional queries. We present the architecture of the system, discuss emergent behaviors, and evaluate its effectiveness on real-world multi-repository scenarios. We demonstrate emergent capabilities including impact analysis and symptom-based debugging that arise naturally from the semantic graph structure. 1 Introduction Modern software systems are increasingly complex and distributed, often composed of multiple repositories, services, and technologies. For example, developers working on large-scale systems often struggle to answer questions such as: “Which services are involved in the processing of a user payment?” , “Where is a given business rule implemented across repositories?” , or “What components must be updated to safely modify a data schema?” Answering these questions typically requires manual inspection of multiple codebases, documentation, and runtime configurations. Developers face significant challenges when trying to understand both the structural and functional aspects of such systems 16 ; 3 . Traditional tools for code navigation and static analysis focus on isolated repositories and lack the semantic abstraction needed to reason about cross-cutting concerns or system-wide workflows 12 . The rise of Software Knowledge Graphs has introduced promising techniques for representing codebases as graph structures, capturing relationships between code elements and supporting advanced queries 1 ; 13 . Similarly, Large Language Models (LLMs) 20 have shown impressive capabilities in code summarization, semantic search, and conversational interfaces 24 ; 4 . However, these models often lack explicit access to a system-level representation of the software, limiting their ability to answer high-level or cross-repository questions. To address these challenges, we introduce LogicLens , a conversational agent designed to assist developers in navigating and understanding complex software systems. At the core of LogicLens is a semantic graph, which combines structural and functional information from across repositories. This graph is constructed in a preprocessing phase that merges syntactic analysis through AST parsing and repository traversal with semantic enrichment using Large Language Models (LLMs). The resulting graph represents not only the technical structure of the system, such as files, classes, and functions, but also higher-level functional abstractions like domain entities, operations, and workflows. Once constructed, the graph serves as the foundation for interactive querying. LogicLens allows developers to interact with the system using natural language, dynamically retrieving relevant subgraphs and providing responses to both technical and domain-specific questions. By selecting tools reactively based on user input, the agent is able to provide answers that span multiple codebases and services. This paper explores the architecture of LogicLens, highlighting the emergent behaviors it enables, and evaluating its effectiveness in real-world multi-repository software scenarios. We show how this approach supports developers to reason more efficiently about complex systems and navigate the implicit domain knowledge embedded in large codebases. 2 Related Work Understanding and navigating codebases has been a longstanding challenge in software engineering 7 . Various tools have been developed to support semantic code search, summarization, and analysis, primarily targeting single repositories. Code Search and Analysis Tools. Sourcegraph 18 offers advanced code navigation and search capabilities across repositories, but its semantic reasoning is limited and it primarily supports syntactic queries within individual repositories. CodeQL 9 enables static analysis through a query language designed for security and quality checks, but it lacks semantic enrichment and cross-repository reasoning. LLM-based coding tools such as Claude Code 2 and systems built on OpenAI Codex 5 provide conversational interfaces for code understanding, generation, and refactoring, but they typically operate over limited context windows and remain focused on individual repositories or local code fragments. Similarly, AI-powered assistants such as GitHub Copilot 8 and Cursor 6 leverage large language models to assist developers, yet they lack an explicit system-level representation of software and do not support deep cross-repository reasoning. Semantic Search and Summarization. Approaches like CodeSearchNet 11 have advanced semantic code retrieval within individual projects by leveraging neural embeddings. Tools like Aroma 14 provide semantic code search focused on snippet retrieval. Windsurf 22 introduces conversational interaction with codebases, yet remains limited to individual repositories. Software Knowledge Graphs and LLM Agents. Recent approaches build software knowledge graphs to represent code elements and their relations for enhanced code comprehension 25 ; 10 . Large Language Models have also been used to build conversational agents that reason over code, yet they typically lack explicit integration with multi-repository semantic graphs. Our approach differs from existing tools and methods along two key dimensions. First, while prior code search and analysis systems operate primarily on syntactic representations or local semantic embeddings, LogicLens relies on an explicit semantic graph that captures both structural dependencies and domain-level abstractions. Second, unlike LLM-based assistants that reason over limited context windows, our approach provides the agent with a persistent, multi-repository system representation, enabling queries and reasoning that span repositories, services, and end-to-end workflows. This combination allows LogicLens to support system-level exploration and cross-cutting queries that are not addressed by existing single-repository or context-bounded approaches. 3 Method (a) Structural Graph (b) Semantic Graph Figure 1 : Comparison between the structural and semantic graphs. (a) Structural Graph: captures static relationships among code units across multiple repositories, including dependencies, method calls, and inheritance. (b) Semantic Graph: enriches the structural graph with domain entities and functional relationships, connecting code units through the operations they perform on shared entities. For example, a Code node representing OrderProcessor is linked to an Entity node Order , illustrating how multiple services collaborate on the same domain concept. Our objective is to develop a system that enables the exploration and troubleshooting of large-scale systems—whether microservices-based or monolithic—comprising multiple repositories, through a conversational interface. This interface should allow users, even those not deeply familiar with the system, to ask questions such as: • What is the creation flow of resource X? (explore) • Which projects are involved in the activation process of Y? (explore) • The deletion of Z is failing; which projects should I inspect to identify the root cause? (troubleshoot) • Endpoint Q returns a 500 error—what might be causing it? (troubleshoot) We leverage a ReAct Agent 23 architecture combined with GraphRAG techniques to retrieve comprehensive context from a Knowledge Graph built solely from source code, in order to answer user queries. Our approach consists of firstly constructing a Knowledge Graph from multiple repositories, and then employing a ReAct Agent to answer user queries exploiting this graph. To illustrate the approach, we introduce a

Read the complete text