Files
SubMiner/backlog/tasks/task-123 - Add-progress-logging-for-YouTube-subtitle-generation-phases.md

2.4 KiB

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority
id title status assignee created_date updated_date labels dependencies references priority
TASK-123 Add progress logging for YouTube subtitle generation phases Done
@codex
2026-03-08 07:07 2026-03-08 07:15
ux
logging
youtube
subtitles
/Users/sudacode/projects/japanese/SubMiner/launcher/youtube/orchestrator.ts
/Users/sudacode/projects/japanese/SubMiner/launcher/youtube/audio-extraction.ts
/Users/sudacode/projects/japanese/SubMiner/launcher/youtube/whisper.ts
/Users/sudacode/projects/japanese/SubMiner/launcher/youtube/subtitle-fix-ai.ts
medium

Description

Improve launcher YouTube subtitle generation observability so users can tell that work is happening and roughly how long each phase is taking. Cover manual subtitle probe, audio extraction, ffmpeg prep, whisper generation, and optional AI subtitle fix phases without flooding normal logs.

Acceptance Criteria

  • #1 Users see clear info-level phase logs for YouTube subtitle generation work including subtitle probe, fallback audio extraction, whisper, and optional AI fix phases.
  • #2 Long-running phases surface elapsed-time progress or explicit start/finish timing so it is obvious the process is still active.
  • #3 Automated tests cover the new logging/progress helper behavior where practical.

Implementation Notes

Implemented a shared timed YouTube phase logger in launcher/youtube/progress.ts with info-level start/finish messages and warn-level failure messages that include elapsed time.

Wired phase logging into YouTube metadata probe, manual subtitle probe, fallback audio extraction, ffmpeg whisper prep, whisper primary/secondary generation, and optional AI subtitle fix phases.

Verification: bun test launcher/youtube/progress.test.ts launcher/youtube/orchestrator.test.ts passed; bun run typecheck passed.

Final Summary

Added clear phase-level observability for YouTube subtitle generation without noisy tool output. Users now see start/finish logs with elapsed time for subtitle probe, fallback audio extraction, ffmpeg prep, whisper generation, and optional AI subtitle-fix phases, making it obvious when generation is active and roughly how long each step took.