Harden initial framework skeleton

internal/adapters/analyzer/runner.go

@@ -3,6 +3,8 @@ package analyzer
 
 import "context"
 
+// TODO: implement analyzer integration once the analyzer contract is finalized.
+
 // Runner is the adapter boundary for analyzer invocations.
 type Runner interface {
 	Run(ctx context.Context, req AnalyzeRequest) (AnalyzeResult, error)

internal/adapters/audita/runner.go

@@ -3,6 +3,8 @@ package audita
 
 import "context"
 
+// TODO: implement a real Audita subprocess/service adapter.
+
 // Runner is the adapter boundary for audita polish invocations.
 type Runner interface {
 	Run(ctx context.Context, req PolishRequest) (PolishResult, error)

internal/adapters/notify/sender.go

@@ -3,6 +3,8 @@ package notify
 
 import "context"
 
+// TODO: implement a real notification backend (email/webhook/etc.).
+
 // Sender is the adapter boundary for notifications.
 type Sender interface {
 	Send(ctx context.Context, req SendRequest) (SendResult, error)

internal/adapters/seriatim/runner.go

@@ -3,6 +3,8 @@ package seriatim
 
 import "context"
 
+// TODO: implement a real Seriatim subprocess adapter.
+
 // Runner is the adapter boundary for seriatim merge invocations.
 type Runner interface {
 	Run(ctx context.Context, req MergeRequest) (MergeResult, error)

internal/adapters/storage/archive.go

@@ -3,6 +3,8 @@ package storage
 
 import "context"
 
+// TODO: implement remote storage/archive backends (S3/SFTP/etc.).
+
 // Backend is the adapter boundary for archive/storage operations.
 type Backend interface {
 	Archive(ctx context.Context, req ArchiveRequest) (ArchiveResult, error)

internal/adapters/whisperx/client.go

@@ -3,6 +3,8 @@ package whisperx
 
 import "context"
 
+// TODO: implement a real WhisperX HTTP client adapter.
+
 // Client is the adapter boundary for WhisperX transcription jobs.
 type Client interface {
 	Transcribe(ctx context.Context, req TranscribeRequest) (TranscribeResult, error)