perf: IMemoryOwner 소유권 관리 안전성 개선

- ChatSegment의 WithAudioMemory 메서드 상태 정리 로직 추가
- AttachAudioMemory 메서드로 불변 인스턴스 생성 지원
- TextToSpeechResponse에 TryTakeAudioOwner 메서드 추가
- 메모리 누수 및 이중 해제 방지 메커니즘 강화
- 코드 가독성을 위한 주석 간소화

Author: ImGdevel

ProjectVG.Application/Models/Chat/ChatSegment.cs

@@ -85,7 +85,7 @@ public ChatSegment WithAudioData(byte[] audioData, string audioContentType, floa
             };
         }
 
-        // 소유권 이전: 호출자는 audioMemoryOwner를 해제하지 말 것
+        // 주의: 원본 인스턴스의 AudioMemoryOwner 해제됨
         public ChatSegment WithAudioMemory(IMemoryOwner<byte> audioMemoryOwner, int audioDataSize, string audioContentType, float audioLength)
         {
             if (audioMemoryOwner is null)
@@ -97,8 +97,38 @@ public ChatSegment WithAudioMemory(IMemoryOwner<byte> audioMemoryOwner, int audi
                     audioDataSize,
                     $"audioDataSize는 0 이상 {audioMemoryOwner.Memory.Length} 이하여야 합니다.");
 
-            // 기존 소유자 해제
+            // 기존 소유자 해제 및 상태 정리
             this.AudioMemoryOwner?.Dispose();
+            this.AudioMemoryOwner = null;
+            this.AudioDataSize = 0;
+
+            return new ChatSegment
+            {
+                Content = this.Content,
+                Order = this.Order,
+                Emotion = this.Emotion,
+                Actions = this.Actions,
+                AudioMemoryOwner = audioMemoryOwner,
+                AudioDataSize = audioDataSize,
+                AudioContentType = audioContentType,
+                AudioLength = audioLength,
+                AudioData = null
+            };
+        }
+
+        /// <summary>
+        /// 오디오 메모리를 부착한 새 인스턴스 생성 (원본 불변)
+        /// </summary>
+        public ChatSegment AttachAudioMemory(IMemoryOwner<byte> audioMemoryOwner, int audioDataSize, string audioContentType, float audioLength)
+        {
+            if (audioMemoryOwner is null)
+                throw new ArgumentNullException(nameof(audioMemoryOwner));
+
+            if (audioDataSize < 0 || audioDataSize > audioMemoryOwner.Memory.Length)
+                throw new ArgumentOutOfRangeException(
+                    nameof(audioDataSize),
+                    audioDataSize,
+                    $"audioDataSize는 0 이상 {audioMemoryOwner.Memory.Length} 이하여야 합니다.");
 
             return new ChatSegment
             {

ProjectVG.Infrastructure/Integrations/TextToSpeechClient/Models/TextToSpeechResponse.cs

@@ -3,6 +3,9 @@
 
 namespace ProjectVG.Infrastructure.Integrations.TextToSpeechClient.Models
 {
+    /// <summary>
+    /// TTS API 응답 모델 - IMemoryOwner 기반 메모리 관리
+    /// </summary>
     public class TextToSpeechResponse
     {
         /// <summary>
@@ -25,6 +28,7 @@ public class TextToSpeechResponse
 
         /// <summary>
         /// ArrayPool 기반 오디오 메모리 소유자 (LOH 방지)
+        /// 주의: ChatSegment로 이전하지 않을 경우 직접 Dispose() 필요
         /// </summary>
         [JsonIgnore]
         public IMemoryOwner<byte>? AudioMemoryOwner { get; set; }
@@ -52,5 +56,20 @@ public class TextToSpeechResponse
         /// </summary>
         [JsonIgnore]
         public int StatusCode { get; set; } = 200;
+
+        /// <summary>
+        /// 오디오 메모리 소유권을 안전하게 가져갑니다
+        /// </summary>
+        public bool TryTakeAudioOwner(out IMemoryOwner<byte>? owner, out int size)
+        {
+            owner = AudioMemoryOwner;
+            size = AudioDataSize;
+
+            // 소유권 이전 후 현재 객체에서 제거하여 중복 해제 방지
+            AudioMemoryOwner = null;
+            AudioDataSize = 0;
+
+            return owner != null;
+        }
     }
 }