Merge pull request #592 from Chris0Jeky/feature/218-transcript-capture-source

Add transcript paste/file capture source for Inbox pipeline

Author: Chris0Jeky

backend/src/Taskdeck.Application/DTOs/CaptureContracts.cs

@@ -35,6 +35,7 @@ public static class CaptureRequestContract
     public const string RequestTypeV1 = "inbox.capture.v1";
     public const int CurrentSchemaVersion = 1;
     public const int MaxRawTextLength = 20_000;
+    public const int MaxTranscriptTextLength = 51_200;
     public const int MaxTitleHintLength = 240;
     public const int MaxExternalRefLength = 2_048;
     public const int MaxPromptVersionLength = 64;
@@ -170,11 +171,12 @@ public static Result<CapturePayloadV1> ValidatePayload(CapturePayloadV1 payload)
             return Result.Failure<CapturePayloadV1>(ErrorCodes.ValidationError, "Capture text cannot be empty");
         }
 
-        if (payload.Text.Length > MaxRawTextLength)
+        var effectiveMaxLength = IsTranscriptSource(payload.Source) ? MaxTranscriptTextLength : MaxRawTextLength;
+        if (payload.Text.Length > effectiveMaxLength)
         {
             return Result.Failure<CapturePayloadV1>(
                 ErrorCodes.ValidationError,
-                $"Capture text cannot exceed {MaxRawTextLength} characters");
+                $"Capture text cannot exceed {effectiveMaxLength} characters");
         }
 
         if (payload.TitleHint?.Length > MaxTitleHintLength)
@@ -419,6 +421,11 @@ private static Result ValidateForbiddenIdentityFields(JsonElement root, bool all
         return Result.Success();
     }
 
+    public static bool IsTranscriptSource(CaptureSource source)
+    {
+        return source is CaptureSource.TranscriptPaste or CaptureSource.TranscriptFile;
+    }
+
     private static bool IsSupportedSourceSurface(string sourceSurface)
     {
         return sourceSurface.Equals("chat", StringComparison.OrdinalIgnoreCase) ||

backend/src/Taskdeck.Domain/Enums/CaptureSource.cs

@@ -10,5 +10,6 @@ public enum CaptureSource
     TranscriptPaste = 2,
     Import = 3,
     Voice = 4,
-    MeetingIntegration = 5
+    MeetingIntegration = 5,
+    TranscriptFile = 6
 }

backend/tests/Taskdeck.Application.Tests/Services/CaptureRequestContractTests.cs

@@ -422,4 +422,136 @@ public void SanitizeProvenanceMetadata_ShouldReturnFallback_WhenValueIsMissing()
 
         sanitized.Should().Be("unknown");
     }
+
+    [Fact]
+    public void IsTranscriptSource_ShouldReturnTrue_ForTranscriptPaste()
+    {
+        CaptureRequestContract.IsTranscriptSource(CaptureSource.TranscriptPaste).Should().BeTrue();
+    }
+
+    [Fact]
+    public void IsTranscriptSource_ShouldReturnTrue_ForTranscriptFile()
+    {
+        CaptureRequestContract.IsTranscriptSource(CaptureSource.TranscriptFile).Should().BeTrue();
+    }
+
+    [Theory]
+    [InlineData(CaptureSource.Typed)]
+    [InlineData(CaptureSource.Paste)]
+    [InlineData(CaptureSource.Import)]
+    [InlineData(CaptureSource.Voice)]
+    [InlineData(CaptureSource.MeetingIntegration)]
+    public void IsTranscriptSource_ShouldReturnFalse_ForNonTranscriptSources(CaptureSource source)
+    {
+        CaptureRequestContract.IsTranscriptSource(source).Should().BeFalse();
+    }
+
+    [Fact]
+    public void ValidatePayload_ShouldAllowLargerText_ForTranscriptPasteSource()
+    {
+        var textLength = CaptureRequestContract.MaxRawTextLength + 1;
+        var payload = new CapturePayloadV1(
+            CaptureRequestContract.CurrentSchemaVersion,
+            CaptureSource.TranscriptPaste,
+            new string('t', textLength));
+
+        var result = CaptureRequestContract.ValidatePayload(payload);
+
+        result.IsSuccess.Should().BeTrue();
+        result.Value.Text.Should().HaveLength(textLength);
+    }
+
+    [Fact]
+    public void ValidatePayload_ShouldAllowLargerText_ForTranscriptFileSource()
+    {
+        var textLength = CaptureRequestContract.MaxRawTextLength + 1;
+        var payload = new CapturePayloadV1(
+            CaptureRequestContract.CurrentSchemaVersion,
+            CaptureSource.TranscriptFile,
+            new string('t', textLength));
+
+        var result = CaptureRequestContract.ValidatePayload(payload);
+
+        result.IsSuccess.Should().BeTrue();
+        result.Value.Text.Should().HaveLength(textLength);
+    }
+
+    [Fact]
+    public void ValidatePayload_ShouldFail_WhenTranscriptTextExceedsTranscriptMaxLength()
+    {
+        var payload = new CapturePayloadV1(
+            CaptureRequestContract.CurrentSchemaVersion,
+            CaptureSource.TranscriptPaste,
+            new string('t', CaptureRequestContract.MaxTranscriptTextLength + 1));
+
+        var result = CaptureRequestContract.ValidatePayload(payload);
+
+        result.IsSuccess.Should().BeFalse();
+        result.ErrorCode.Should().Be(ErrorCodes.ValidationError);
+        result.ErrorMessage.Should().Contain("cannot exceed");
+        result.ErrorMessage.Should().Contain(CaptureRequestContract.MaxTranscriptTextLength.ToString());
+    }
+
+    [Fact]
+    public void ValidatePayload_ShouldAcceptTranscriptTextAtExactMaxLength()
+    {
+        var payload = new CapturePayloadV1(
+            CaptureRequestContract.CurrentSchemaVersion,
+            CaptureSource.TranscriptFile,
+            new string('t', CaptureRequestContract.MaxTranscriptTextLength));
+
+        var result = CaptureRequestContract.ValidatePayload(payload);
+
+        result.IsSuccess.Should().BeTrue();
+    }
+
+    [Fact]
+    public void ParsePayload_ShouldParseTranscriptFileSource()
+    {
+        var payload = """
+                      {
+                        "version": 1,
+                        "source": "transcriptFile",
+                        "text": "meeting transcript content"
+                      }
+                      """;
+
+        var result = CaptureRequestContract.ParsePayload(payload);
+
+        result.IsSuccess.Should().BeTrue();
+        result.Value.Source.Should().Be(CaptureSource.TranscriptFile);
+        result.Value.Text.Should().Be("meeting transcript content");
+    }
+
+    [Fact]
+    public void ParsePayload_ShouldParseTranscriptFileSourceAsNumeric()
+    {
+        var payload = """
+                      {
+                        "version": 1,
+                        "source": 6,
+                        "text": "meeting transcript content"
+                      }
+                      """;
+
+        var result = CaptureRequestContract.ParsePayload(payload);
+
+        result.IsSuccess.Should().BeTrue();
+        result.Value.Source.Should().Be(CaptureSource.TranscriptFile);
+    }
+
+    [Fact]
+    public void ValidatePayload_ShouldEnforceStandardLimit_ForNonTranscriptSources()
+    {
+        var payload = new CapturePayloadV1(
+            CaptureRequestContract.CurrentSchemaVersion,
+            CaptureSource.Typed,
+            new string('x', CaptureRequestContract.MaxRawTextLength + 1));
+
+        var result = CaptureRequestContract.ValidatePayload(payload);
+
+        result.IsSuccess.Should().BeFalse();
+        result.ErrorCode.Should().Be(ErrorCodes.ValidationError);
+        result.ErrorMessage.Should().Contain(CaptureRequestContract.MaxRawTextLength.ToString());
+    }
 }