Define adapter interfaces and fake implementations

internal/adapters/whisperx/client.go

@@ -3,18 +3,20 @@ package whisperx
 
 import "context"
 
-// Client is a placeholder adapter interface for WhisperX interactions.
+// Client is the adapter boundary for WhisperX transcription jobs.
 type Client interface {
-	Transcribe(ctx context.Context, req TranscriptionRequest) (TranscriptionResult, error)
+	Transcribe(ctx context.Context, req TranscribeRequest) (TranscribeResult, error)
 }
 
-// TranscriptionRequest is a placeholder transcription input.
-type TranscriptionRequest struct {
-	Speaker   string
-	AudioPath string
+// TranscribeRequest describes one speaker audio transcription request.
+type TranscribeRequest struct {
+	SpeakerID               string
+	AudioPath               string
+	OutputRawTranscriptPath string
 }
 
-// TranscriptionResult is a placeholder transcription output.
-type TranscriptionResult struct {
-	TranscriptPath string
+// TranscribeResult describes the transcript output and adapter metadata.
+type TranscribeResult struct {
+	OutputRawTranscriptPath string
+	Metadata                map[string]any
 }