data: протокол 26.2 (776) и спеки поверх

facts/AI_CONTEXT.md

@@ -88,6 +88,7 @@ ids <packet-id> [--format json|toon]
 ids --pv <N> [--ns namespace] [--direction toClient|toServer] [--format json|toon]
 chunks [--kind all|packet|type] [--filter text] [--max-chars N] [--format json|toon]
 stats [--format json|toon]
+versions [--format json|toon]
 order [--format json|toon]
 graph [--ns play] [--direction toClient] [--include-types false] [--format json|toon]
 ```
@@ -117,6 +118,7 @@ get_protocol_usage
 get_protocol_users
 get_protocol_dependencies
 get_protocol_stats
+get_protocol_versions
 get_protocol_graph
 ```
 
@@ -129,6 +131,7 @@ endpoints are useful when another process is already running the server:
 GET /api/packets
 GET /api/packets/{ns}/{dir}
 GET /api/stats
+GET /api/versions
 GET /api/types
 GET /api/native-types
 GET /api/types-by-kind

facts/README.md

@@ -93,6 +93,7 @@ ids <packet-id> [--format json|toon]
 ids --pv <N> [--ns play] [--direction toClient|toServer] [--format json|toon]
 chunks [--kind all|packet|type] [--filter text] [--max-chars N] [--format json|toon]
 stats [--format json|toon]
+versions [--format json|toon]              (protocol number -> Minecraft releases)
 order [--format json|toon]                 (type build order, simple -> complex)
 graph [--ns play] [--direction toClient] [--include-types false] [--format json|toon]
 ```
@@ -124,6 +125,7 @@ get_protocol_usage
 get_protocol_users
 get_protocol_dependencies
 get_protocol_stats
+get_protocol_versions
 get_protocol_graph
 ```
 
@@ -135,6 +137,7 @@ get_protocol_graph
 GET  /api/packets
 GET  /api/packets/{ns}/{dir}
 GET  /api/stats
+GET  /api/versions
 GET  /api/types
 GET  /api/native-types
 GET  /api/types-by-kind

facts/src/McProtoFacts.Cli/Program.cs

@@ -110,6 +110,10 @@ static async Task<int> RunAsync(string[] args)
                 Write(query.GetStats(), format);
                 return Ok;
 
+            case "versions":
+                Write(query.GetVersions(), format);
+                return Ok;
+
             case "order":
             case "build-order":
                 Write(query.GetBuildOrder(), format);
@@ -265,6 +269,7 @@ usage [--top N] [--kind packet|type|shape|native] [--format json|toon]
   ids --pv <N> [--ns play] [--direction toClient|toServer] [--format json|toon]
   chunks [--kind all|packet|type] [--filter text] [--max-chars N] [--format json|toon]
   stats [--format json|toon]
+  versions [--format json|toon]              (protocol number -> Minecraft releases)
   order [--format json|toon]                 (type build order, simple -> complex)
   graph [--ns play] [--direction toClient] [--include-types false] [--format json|toon]
 

facts/src/McProtoFacts.McpStdio/Program.cs

@@ -85,6 +85,11 @@ public static string GetProtocolDependencies(ProtocolUsageQueries usage, string
     public static string GetProtocolStats(ProtocolQueryService query, string format = "json") =>
         Serialize(query.GetStats(), format);
 
+    [McpServerTool(Name = "get_protocol_versions")]
+    [Description("Returns loaded protocol numbers with the Minecraft releases that speak them.")]
+    public static string GetProtocolVersions(ProtocolQueryService query, string format = "toon") =>
+        Serialize(query.GetVersions(), format);
+
     [McpServerTool(Name = "get_protocol_graph")]
     [Description("Returns protocol graph nodes/edges for packets, named types, native types, and protodef shapes.")]
     public static string GetProtocolGraph(

facts/src/McProtoFacts.Protocol/Loading/ProtocolDataLoader.cs

@@ -5,7 +5,7 @@
 
 namespace McProtoFacts.Protocol.Loading;
 
-public sealed record ProtocolDataOptions(int FromProtocol = 735, int ToProtocol = 772);
+public sealed record ProtocolDataOptions(int FromProtocol = 735, int ToProtocol = 776);
 
 public static class ProtocolDataLoader
 {

facts/src/McProtoFacts.Protocol/Queries/ProtocolQueryService.cs

@@ -154,6 +154,21 @@ public PacketIdsResult GetPacketIds(string id)
                 .ToArray());
     }
 
+    /// <summary>Loaded protocol numbers with the Minecraft releases that speak them.</summary>
+    public ProtocolVersionsResult GetVersions()
+    {
+        var entries = _repository.GetVersions()
+            .OrderBy(entry => entry.Protocol)
+            .Select(entry => new ProtocolVersionEntryResult(
+                entry.Protocol,
+                entry.Versions.ToArray(),
+                string.Join(", ", entry.Versions)))
+            .ToArray();
+
+        var supported = _repository.GetSupportedProtocols();
+        return new ProtocolVersionsResult(entries.Length, supported.From, supported.To, entries);
+    }
+
     public PacketIdMapResult GetPacketIdMap(int protocolVersion, string? ns = null, string? direction = null)
     {
         var supported = _repository.GetSupportedProtocols();
@@ -428,6 +443,17 @@ public sealed record PacketIdsResult(
     string Name,
     IReadOnlyList<PacketIdRangeEntry> Ranges);
 
+public sealed record ProtocolVersionEntryResult(
+    int Protocol,
+    IReadOnlyList<string> Versions,
+    string Display);
+
+public sealed record ProtocolVersionsResult(
+    int Count,
+    int From,
+    int To,
+    IReadOnlyList<ProtocolVersionEntryResult> Protocols);
+
 public sealed record PacketIdMapEntry(string Id, string Hex, int Dec);
 
 public sealed record PacketIdMapResult(

facts/src/McProtoFacts.Protocol/Repository/IProtocolRepository.cs

@@ -2,10 +2,16 @@
 
 namespace McProtoFacts.Protocol.Repository;
 
+/// <summary>One protocol number with the Minecraft releases that speak it.</summary>
+public sealed record ProtocolVersionEntry(int Protocol, IReadOnlyList<string> Versions);
+
 public interface IProtocolRepository
 {
     ProtocolRange GetSupportedProtocols();
 
+    /// <summary>Loaded protocol numbers with their Minecraft release names, ascending.</summary>
+    IReadOnlyList<ProtocolVersionEntry> GetVersions();
+
     IEnumerable<string> GetTypes();
     IEnumerable<string> GetNativeTypes();
     Dictionary<string, Dictionary<string, PacketDefinition>> GetPackets();

facts/src/McProtoFacts.Protocol/Repository/ProtocolRepository.cs

@@ -87,6 +87,13 @@ public ProtocolRange GetSupportedProtocols()
         return _range;
     }
 
+    public IReadOnlyList<ProtocolVersionEntry> GetVersions()
+    {
+        return _map.Protocols
+            .Select(kv => new ProtocolVersionEntry(kv.Key, kv.Value.MinecraftVersions.ToArray()))
+            .ToArray();
+    }
+
     public IEnumerable<string> GetTypes()
     {
         return

facts/src/McpServer/Endpoints/PacketEndpoints.cs

@@ -66,6 +66,24 @@ public static void MapPacketApi(this WebApplication app)
             });
         });
 
+        app.MapGet("/api/versions", (ProtocolQueryService query) =>
+        {
+            var versions = query.GetVersions();
+
+            return Results.Ok(new
+            {
+                count = versions.Count,
+                from = versions.From,
+                to = versions.To,
+                protocols = versions.Protocols.Select(entry => new
+                {
+                    protocol = entry.Protocol,
+                    versions = entry.Versions,
+                    display = entry.Display
+                }).ToArray()
+            });
+        });
+
         app.MapGet("/api/types", (ProtocolQueryService query) =>
         {
             return Results.Ok(query.GetTypes());

facts/src/McpServer/Program.cs

@@ -11,7 +11,7 @@
 using McProtoFacts.Protocol.Loading;
 
 var start = 735;
-var end = 772;
+var end = 776;
 
 Console.WriteLine($"[McpServer] Loading protocols {start}-{end}...");
 var repository = await ProtocolDataLoader.LoadRepositoryAsync(new ProtocolDataOptions(start, end));