98 lines
5.4 KiB
Plaintext
98 lines
5.4 KiB
Plaintext
# Ralph Progress Log
|
|
Started: Sun Feb 1 12:22:47 AM CET 2026
|
|
---
|
|
|
|
## Completed
|
|
|
|
### Task 1: Create language package with core types and helpers
|
|
- Created `internal/language/language.go` with Language struct, Auto constant
|
|
- Implemented FromCode, List, Codes, AllLanguageCodes, IsValidCode
|
|
- Full 57 language list from OpenAI Whisper
|
|
- All tests passing, typecheck passes
|
|
|
|
### Task 8: Migrate OpenAI provider to new Model structure
|
|
- Added gpt-4o-transcribe and gpt-4o-mini-transcribe transcription models
|
|
- Removed gpt-4-turbo and gpt-3.5-turbo LLM models (not in PRD)
|
|
- OpenAI now has 5 models: 3 transcription (whisper-1, gpt-4o-transcribe, gpt-4o-mini-transcribe) + 2 LLM (gpt-4o-mini, gpt-4o)
|
|
- All models have AdapterType='openai', Endpoint with BaseURL='https://api.openai.com'
|
|
- All models use language.AllLanguageCodes() for SupportedLanguages (57 languages)
|
|
- Updated provider_test.go to expect 3 transcription and 2 LLM models
|
|
- All tests passing, typecheck passes
|
|
|
|
|
|
### Task 3: Create Model type with full metadata
|
|
- Created `internal/provider/model.go`
|
|
- ModelType enum: Transcription, LLM
|
|
- Model struct: ID, Name, Description, Type, Streaming, Local, AdapterType, SupportedLanguages, Endpoint, LocalInfo
|
|
- EndpointConfig: BaseURL, Path
|
|
- LocalModelInfo: Filename, Size, DownloadURL
|
|
- Helper methods: NeedsDownload(), IsStreaming(), SupportsLanguage(code), SupportsAllLanguages()
|
|
- SupportsLanguage("") always returns true (auto always allowed)
|
|
- All tests passing, typecheck passes
|
|
|
|
### Task 4: Refactor Provider interface to return Models
|
|
- Updated `internal/provider/provider.go` Provider interface
|
|
- Replaced old methods with: Models() []Model, DefaultModel(t ModelType) string, IsLocal() bool
|
|
- Added package-level helpers:
|
|
- GetModel(providerName, modelID string) (*Model, error)
|
|
- ModelsOfType(p Provider, t ModelType) []Model
|
|
- FindModelByID(modelID string) (*Model, Provider, error)
|
|
- ModelsForLanguage(p Provider, t ModelType, langCode string) []Model
|
|
- ValidateModelLanguage(providerName, modelID, langCode string) error
|
|
- Updated all providers (openai, groq, mistral, elevenlabs) with full Model metadata
|
|
- Updated TUI files to use ModelsOfType instead of old SupportsTranscription/SupportsLLM
|
|
- Added comprehensive tests for all new helper functions
|
|
- All tests passing, typecheck passes
|
|
|
|
### Task 5: Define BatchAdapter and StreamingAdapter interfaces
|
|
- Renamed `TranscriptionAdapter` to `BatchAdapter` in transcriber.go
|
|
- Updated all adapters (openai, groq, mistral, elevenlabs) to reference BatchAdapter in comments
|
|
- Updated SimpleTranscriber to use BatchAdapter
|
|
- Updated test mocks (MockTranscriptionAdapter -> MockBatchAdapter)
|
|
- Created `internal/transcriber/streaming.go` with:
|
|
- `TranscriptionResult` struct: Text, IsFinal, Error fields
|
|
- `StreamingAdapter` interface: Start, SendChunk, Results, Close methods
|
|
- All tests passing, typecheck passes
|
|
|
|
### Task 6: Create StreamingTranscriber wrapper
|
|
- Created `internal/transcriber/streaming_transcriber.go`
|
|
- StreamingTranscriber struct with: adapter, language, finalText builder, mutex, ctx/cancel, WaitGroup
|
|
- Start() creates cancelable context, starts adapter, spawns 2 goroutines
|
|
- Goroutine 1: reads frames from channel, calls adapter.SendChunk()
|
|
- Goroutine 2: reads from adapter.Results(), accumulates final results with space separator
|
|
- Stop() cancels context, waits for goroutines, closes adapter
|
|
- GetFinalTranscription() returns accumulated text with mutex protection
|
|
- Added MockStreamingAdapter and comprehensive tests
|
|
- Tests verify: start/stop, result accumulation, partial result filtering, error handling, concurrent access
|
|
- All tests passing with -race flag, typecheck passes
|
|
|
|
### Task 7: Write tests for Model, Provider, and interfaces
|
|
- Created `internal/provider/model_test.go`
|
|
- TestModel_NeedsDownload: local with LocalInfo = true, cloud = false, nil = false
|
|
- TestModel_IsStreaming: returns Streaming field value
|
|
- TestModel_SupportsLanguage: multilingual supports all, english-only supports en, auto always true
|
|
- TestModel_SupportsAllLanguages: true when 57 languages, false otherwise
|
|
- TestModelType_Constants: Transcription=0, LLM=1
|
|
- TestEndpointConfig_Fields, TestLocalModelInfo_Fields: struct fields accessible
|
|
- TestModel_AllFields: comprehensive struct field test
|
|
- provider_test.go already had GetModel, ModelsOfType, FindModelByID, ModelsForLanguage, ValidateModelLanguage tests
|
|
- All tests passing, typecheck passes
|
|
|
|
### Task 9: Migrate Groq provider to new Model structure
|
|
- Implementation was already complete from previous work
|
|
- Verified 6 models: 3 transcription (whisper-large-v3, whisper-large-v3-turbo, distil-whisper-large-v3-en) + 3 LLM
|
|
- All models use AdapterType='openai' (Groq is OpenAI-compatible)
|
|
- Endpoint.BaseURL='https://api.groq.com/openai' for all
|
|
- distil-whisper-large-v3-en correctly has SupportedLanguages=['en'] (English only)
|
|
- Multilingual models have all 57 language codes
|
|
- All verification items confirmed working
|
|
|
|
### Task 10: Migrate Mistral provider to new Model structure
|
|
- Implementation was already complete from previous work
|
|
- Verified 2 models: voxtral-mini-latest, voxtral-mini-2507
|
|
- All models use AdapterType='openai' (Mistral transcription is OpenAI-compatible)
|
|
- Endpoint.BaseURL='https://api.mistral.ai' with Path='/v1/audio/transcriptions'
|
|
- SupportedLanguages set to all 57 language codes (multilingual per Mistral docs)
|
|
- Researched Mistral API docs - language parameter is optional, no specific list of restrictions
|
|
- All tests passing, typecheck passes
|