Merge pull request #2 from managedcode/codex/set-up-.net-build-and-tests

Migrate to .NET 10, adopt TUnit, add integration tests and MCAF guidance

Author: KSemenenko

AGENTS.md

@@ -0,0 +1,16 @@
+# Repository Agent Instructions (MCAF)
+
+This repository follows the Managed Code Coding AI Framework (MCAF).
+
+## Environment
+- Use .NET SDK **10.x** only (see `global.json`).
+- Solution format is **.slnx** (`ragsharp.slnx`). Do not reintroduce `.sln` files.
+- Tests use **TUnit**. Avoid xUnit/NUnit/MSTest packages.
+
+## Verification
+- Prefer integration tests that exercise real filesystem/indexing behavior.
+- Run `dotnet test ragsharp.slnx` after changes when feasible.
+
+## Repository Layout
+- Source projects live under `src/`.
+- Tests live under `tests/`.

README.md

@@ -9,7 +9,7 @@ See the Codex skill specification at https://agentskills.io/specification.
 
 ## Requirements
 
-- .NET SDK 10 (primary) with multi-targeting to net8.0 for fallback.
+- .NET SDK 10 (only target).
 - Cross-platform (Windows/macOS/Linux).
 
 ## Install .NET 10

docs/Wiki/ProjectOverview.md

@@ -0,0 +1,29 @@
+# RagSharp Project Overview
+
+RagSharp provides code graph indexing, storage, and tooling for analyzing .NET codebases.
+The core library builds a graph of symbols and relationships (types, members, inheritance,
+and references). A lightweight SQLite-backed store allows querying that graph, while the
+CLI and packaging utilities wrap the core capabilities for local workflows and publishing.
+
+## Key Components
+
+- **Code graph indexing**: `src/RagSharp.CodeGraph.Core` uses Roslyn + MSBuild workspace
+  to parse solutions/projects and emit nodes/edges.
+- **Graph storage**: `src/RagSharp.CodeGraph.Store.LiteGraph` stores the graph in SQLite
+  and supports symbol/document queries.
+- **CLI**: `src/RagSharp.CodeGraph.Cli` provides command-line access for indexing.
+- **Skill installer**: `src/RagSharp.SkillInstaller` installs bundled skill templates.
+- **Packaging**: `src/RagSharp.Packaging` handles packaging and publishing needs.
+
+## Build & Test
+
+```bash
+dotnet build ragsharp.slnx
+dotnet test ragsharp.slnx
+```
+
+## Repository Conventions
+
+- Target .NET SDK **10.x** only (`global.json`).
+- Use the `.slnx` solution format.
+- Tests are written with **TUnit** and favor integration coverage.

global.json

@@ -2,6 +2,7 @@
   "sdk": {
     "version": "10.0.100",
     "rollForward": "latestFeature",
-    "allowPrerelease": true
+    "allowPrerelease": true,
+    "testRunner": "Microsoft.Testing.Platform"
   }
 }

ragsharp.sln

@@ -0,0 +1,13 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/RagSharp.CodeGraph.Cli/RagSharp.CodeGraph.Cli.csproj" />
+    <Project Path="src/RagSharp.CodeGraph.Core/RagSharp.CodeGraph.Core.csproj" />
+    <Project Path="src/RagSharp.CodeGraph.Store.LiteGraph/RagSharp.CodeGraph.Store.LiteGraph.csproj" />
+    <Project Path="src/RagSharp.Packaging/RagSharp.Packaging.csproj" />
+    <Project Path="src/RagSharp.SkillInstaller/RagSharp.SkillInstaller.csproj" />
+  </Folder>
+  <Folder Name="/tests/">
+    <Project Path="tests/RagSharp.CodeGraph.Tests/RagSharp.CodeGraph.Tests.csproj" />
+    <Project Path="tests/RagSharp.SkillInstaller.Tests/RagSharp.SkillInstaller.Tests.csproj" />
+  </Folder>
+</Solution>

ragsharp.slnx

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <AssemblyName>ragsharp-codegraph</AssemblyName>

src/RagSharp.CodeGraph.Cli/RagSharp.CodeGraph.Cli.csproj

@@ -19,13 +19,16 @@ public CodeGraphIndexer(bool includeDataflow)
 
     public async Task<IndexResult> IndexAsync(string rootPath, CancellationToken cancellationToken)
     {
-        MSBuildLocator.RegisterDefaults();
+        if (!MSBuildLocator.IsRegistered && MSBuildLocator.CanRegister)
+        {
+            MSBuildLocator.RegisterDefaults();
+        }
         using var workspace = MSBuildWorkspace.Create();
 
         var solutionPath = FindSolution(rootPath);
         if (solutionPath is not null)
         {
-            var solution = await workspace.OpenSolutionAsync(solutionPath, cancellationToken).ConfigureAwait(false);
+            var solution = await workspace.OpenSolutionAsync(solutionPath, progress: null, cancellationToken).ConfigureAwait(false);
             return await BuildIndexAsync(rootPath, solution.Projects, cancellationToken).ConfigureAwait(false);
         }
 
@@ -35,7 +38,7 @@ public async Task<IndexResult> IndexAsync(string rootPath, CancellationToken can
             throw new InvalidOperationException("No .sln or .csproj found under the provided root.");
         }
 
-        var project = await workspace.OpenProjectAsync(projectPath, cancellationToken).ConfigureAwait(false);
+        var project = await workspace.OpenProjectAsync(projectPath, progress: null, cancellationToken).ConfigureAwait(false);
         return await BuildIndexAsync(rootPath, new[] { project }, cancellationToken).ConfigureAwait(false);
     }
 
@@ -159,7 +162,11 @@ public IndexState(IReadOnlyDictionary<string, string> files)
     public string ToJson()
     {
         var payload = new IndexStatePayload { Files = new Dictionary<string, string>(Files) };
-        return System.Text.Json.JsonSerializer.Serialize(payload, new() { WriteIndented = true, PropertyNamingPolicy = System.Text.Json.JsonNamingPolicy.CamelCase });
+        return System.Text.Json.JsonSerializer.Serialize(payload, new System.Text.Json.JsonSerializerOptions
+        {
+            WriteIndented = true,
+            PropertyNamingPolicy = System.Text.Json.JsonNamingPolicy.CamelCase
+        });
     }
 
     public static IndexState FromJson(string json)
@@ -218,6 +225,11 @@ public void AddDocument(Project project, Document document, SyntaxTree tree, Sem
         var root = tree.GetRoot();
         foreach (var usingDirective in root.DescendantNodes().OfType<UsingDirectiveSyntax>())
         {
+            if (usingDirective.Name is null)
+            {
+                continue;
+            }
+
             var name = usingDirective.Name.ToString();
             var nodeId = AddNode(NodeKind.UsingDirective, name, document.FilePath, GetLocation(_rootPath, usingDirective));
             AddEdge(EdgeKind.UsingDirective, documentNodeId, nodeId, GetLocation(_rootPath, usingDirective));

src/RagSharp.CodeGraph.Core/CodeGraphIndexer.cs

@@ -1,12 +1,14 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
   <ItemGroup>
+    <PackageReference Include="Microsoft.Build.Locator" Version="1.7.8" />
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.10.0" />
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.10.0" />
     <PackageReference Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" Version="4.10.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.0" />
   </ItemGroup>
 </Project>

src/RagSharp.CodeGraph.Core/RagSharp.CodeGraph.Core.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>