RoslynXRay | The Meta-Cognitive Engine

Codebase,
Know Thyself.

A distributed static analysis engine that bridges the gap between "dumb" text and "intelligent" reasoning. It turns your C# solution into a Semantic Knowledge Graph.

Roslyn API SQL Server 2025 Neo4j Graph Vector Embeddings

public enum AnalysisPipeline

👁️

Phase 1: Discovery

Deep Recovery parsing of .sln files.
Surgical Razor/Blazor extraction.
AST Construction.

🧠

Phase 2: Global Analysis

Solution-wide DI Maps.
Call Graphing.
Aggregate Boundary Detection.

🧬

Phase 3: Evolution

Parametric Polymorphism.
Behavioral Fingerprinting.
Risk Synthesis.

💾

Phase 4: Synthesis

LLM Narrative Generation.
ONNX Vectorization (384-dim).
SQL Server 2025 Persistence.

IArchitectureIntelligence.cs

1namespace RoslynXRay.Core.Intelligence;
2
3public interface IArchitectureIntelligence
4{
5    /// <summary>
6    /// Detects God Classes, N+1 queries, and Race Conditions.
7    /// </summary>
8    RiskProfile CalculateSystemicRisk(Solution sln);
9
10    /// <summary>
11    /// Distills code into Natural Language for AI Agents.
12    /// </summary>
13    LLMClassContext GenerateNarrative(ClassInfo info);
14
15    /// <summary>
16    /// Finds duplicate logic even if methods are named differently.
17    /// </summary>
18    RefactoringPlan DetectBehavioralSiblings();
19}

The Engine Under the Hood

Role Inference

It doesn't just read syntax. It determines if a class is an Orchestrator, Repository, or ValueObject based on deep semantic clues and usage patterns across the entire graph.

Resilient Parsing

The NodesEdgesDiscoveryService employs "Deep Recovery" mechanisms. It handles encoding failures and Razor compilation errors to ensure no file is left behind.

Polyglot Persistence

Recognizes that different data serves different AI needs.

Neo4j for Dependency Graphs.
ElasticSearch for Text.
SQL 2025 for Vector Embeddings.

Phase 4 Output: The "Psychological Profile"

PsychologicalProfile.json

1{
"identity": {
  "archetype": "DOMAIN_ENTITY",
  "operationalMetaphor": "Glass Cannon (High Value, Low Stability)"
},
"riskProfile": {
  "score": 85,
  "flags": [
    "CRITICAL:RACE_CONDITION_DETECTED",
    "ANTI_PATTERN:GOD_CLASS"
  ]
},
"dependencyProtocols": [
  "CRITICAL: 'CommitAsync' must strictly follow 'BeginTransaction'"
],
"embedding": [0.042, -0.129, 0.884, /* ...384 dim */]
17}