Skip to main content
The new solution file is AI•Pkg.slnx (SLNX format). Do not convert the existing NuGetGallery.sln. The SLNX is created from scratch.

​
Solution Layout

AI•Pkg.slnx
├── src/
│   ├── AI•Pkg.Core/                  # Shared library (see SDK Interface spec)
│   ├── AI•Pkg.Server/                # ASP.NET Core 10 web app (API + Blazor)
│   ├── AI•Pkg.Server.Db/             # SQL Server Database Project (.sqlproj)
│   ├── AI•Pkg.Server.Data/           # EasyAF-generated EF Core entities + repositories
│   ├── AI•Pkg.Server.Search/         # Azure AI Search integration
│   ├── AI•Pkg.CLI/                   # aipkg CLI (Native AOT) — see SDK Interface spec
│   └── AI•Pkg.Jobs/                  # Background jobs (stats, vulnerability, catalog)
├── tests/
│   ├── AI•Pkg.Core.Tests/
│   ├── AI•Pkg.Server.Tests/
│   └── AI•Pkg.Server.Integration.Tests/
└── src/AI•Pkg.Docs/
    └── (this directory)

​
Project Descriptions

​
AI•Pkg.Core

Cross-platform .NET 10 class library. Contains manifest parsing, archive reading/writing, APM fallback resolution, validation, and versioning. AOT-compatible: no reflection emit, no dynamic code. Published to NuGet as AI•Pkg.Core. Referenced by both AI•Pkg.Server and AI•Pkg.CLI.

​
AI•Pkg.Server

ASP.NET Core 10 web application. Hosts:
  • Minimal API endpoints for the Registry API (under /v3/)
  • Blazor SSR components for the web UI
  • GitHub OAuth + API key authentication middleware

​
AI•Pkg.Server.Db

SQL Server Database Project (.sqlproj). Contains all table definitions as .sql files. This is the authoritative schema source. Changes to the database always start here.

​
AI•Pkg.Server.Data

EasyAF-generated EF Core 10 entities, repositories, and AIpkgDbContext. Generated from AI•Pkg.Server.Db. Committed to source control. Regenerated via EasyAF CLI whenever the DB project changes. Azure AI Search document models, indexing pipelines, and query translation. Contains AipkgSearchDocument and the pipeline that keeps the search index in sync with the database.

​
AI•Pkg.CLI

Native AOT aipkg command-line tool. References AI•Pkg.Core. Published as a single self-contained binary per platform (see SDK Implementation).

​
AI•Pkg.Jobs

Background jobs: CDN stats parsing, GitHub vulnerability ingestion, search index sync, and registration blob builder. Adapted from src/Stats.*, src/GitHubVulnerabilities2Db/, and related NuGetGallery projects.

​
Project Rename Reference

NuGetGallery OriginalAI•Pkg Project
NuGetGallery (MVC app)AI•Pkg.Server
NuGetGallery.CoreAI•Pkg.Core + AI•Pkg.Server.*
NuGet.Services.EntitiesAI•Pkg.Server.Data (EasyAF-generated)
NuGet.Services.AzureSearchAI•Pkg.Server.Search
NuGetGallery.Core.FactsAI•Pkg.Core.Tests
NuGetGallery.FactsAI•Pkg.Server.Tests
Stats.*AI•Pkg.Jobs (combined)
GitHubVulnerabilities2DbPart of AI•Pkg.Jobs
NuGet.Packaging (client)AI•Pkg.Core (own reader/writer)
NuGetGallery.slnAI•Pkg.slnx

​
SLNX Format

SLNX (.slnx) is the XML-based Visual Studio solution format introduced in Visual Studio 2022. It is:
  • Human-readable and diff-friendly (unlike .sln)
  • Supported by dotnet build, dotnet test, and Rider/VS 2022+
  • Created via dotnet new sln --format slnx
Do not attempt to convert the existing NuGetGallery.sln. It contains 139 projects, most of which are being deleted. The new AI•Pkg.slnx adds projects incrementally during Phase 0.