feat: align SDK version with Claude Code CLI

Author: KSemenenko

.github/workflows/release.yml

@@ -135,7 +135,7 @@ jobs:
     - name: Validate semantic version
       run: |
         VERSION="${{ steps.version.outputs.version }}"
-        if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$ ]]; then
+        if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$ ]]; then
           echo "Version '$VERSION' is not a valid semantic version."
           exit 1
         fi

ClaudeCodeSharpSDK.Tests/Unit/ClaudeClientTests.cs

@@ -1,6 +1,7 @@
 using ManagedCode.ClaudeCodeSharpSDK.Client;
 using ManagedCode.ClaudeCodeSharpSDK.Configuration;
 using ManagedCode.ClaudeCodeSharpSDK.Execution;
+using ManagedCode.ClaudeCodeSharpSDK.Models;
 using ManagedCode.ClaudeCodeSharpSDK.Tests.Shared;
 
 namespace ManagedCode.ClaudeCodeSharpSDK.Tests.Unit;
@@ -10,6 +11,15 @@ public class ClaudeClientTests
     private const string CallStartAsyncFirstMessageFragment = "Call StartAsync first";
     private const string ExistingSessionId = "session-42";
 
+    [Test]
+    public async Task CliCompatibilityTarget_MatchesPackageVersionPrefix()
+    {
+        var packageVersion = typeof(ClaudeClient).Assembly.GetName().Version;
+        await Assert.That(packageVersion).IsNotNull();
+        await Assert.That($"{packageVersion!.Major}.{packageVersion.Minor}.{packageVersion.Build}")
+            .IsEqualTo(ClaudeCliCompatibility.TargetVersion);
+    }
+
     [Test]
     public async Task StartThread_WithAutoStartDisabled_Throws()
     {

ClaudeCodeSharpSDK/Models/ClaudeCliCompatibility.cs

@@ -0,0 +1,8 @@
+namespace ManagedCode.ClaudeCodeSharpSDK.Models;
+
+/// <summary>Identifies the upstream Claude Code CLI version targeted by this SDK release.</summary>
+public static class ClaudeCliCompatibility
+{
+    /// <summary>The exact upstream CLI version compatible with this SDK package.</summary>
+    public const string TargetVersion = "2.1.292";
+}

Directory.Build.props

@@ -13,7 +13,7 @@
     <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
     <AnalysisLevel>latest-recommended</AnalysisLevel>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-    <Version>1.1.10</Version>
+    <Version>2.1.292.1</Version>
     <PackageVersion>$(Version)</PackageVersion>
 
   </PropertyGroup>

docs/Features/cli-metadata.md

@@ -9,6 +9,8 @@ Source of truth: local `claude` CLI behavior + upstream `anthropics/claude-code`
 
 ## Purpose
 
+The SDK package version mirrors the targeted Claude Code CLI version in its first three numeric components and uses the fourth component for an SDK hotfix. `ClaudeCliCompatibility.TargetVersion` exposes the exact compatible CLI target without starting a process. `GetCliUpdateStatus()` separately reports the latest version discovered from upstream.
+
 Expose runtime Claude Code CLI metadata to SDK consumers:
 
 - installed `claude` version