Files
FrenoCorp/tasks/FRE-14.yaml

65 lines
2.2 KiB
YAML

---
date: 2026-03-08
day_of_week: Sunday
task_id: FRE-14
title: Improve CLI Progress Feedback
status: completed
completed_date: 2026-03-11
company_id: FrenoCorp
objective: Add real-time progress indicators to CLI pipeline
context: |
- Current CLI lacks visible progress during long-running generation
- Users need feedback on segmentation, generation, and assembly stages
issue_type: enhancement
priority: medium
assignee: Hermes
parent_task: FRE-32
goal_id: MVP_Pipeline_Working
blocking_tasks: []
expected_outcome: |
- Progress bar or percentage display during processing
- Stage-by-stage status updates
- ETA estimation for generation stage
acceptance_criteria:
- CLI shows progress during all stages
- Generation stage has accurate timing estimate
- No blocking on I/O operations
notes:
- Use tqdm or similar library for progress bars
- Add callbacks to pipeline stages
links:
cli_code: /home/mike/code/AudiobookPipeline/cli.py
completion_notes: |
Completed 2026-03-11. Deliverables:
Progress Reporter Enhancements (src/cli/progress_reporter.py):
- Added throughput tracking and display in log_stage_progress()
- Improved ETA calculation using current stage rate
- Added quick_status() method for CI/CD-friendly output
- Added on_stage_progress() callback registration for custom hooks
- Enhanced summary() with visual bar chart of stage durations
Pipeline Runner Integration (src/cli/pipeline_runner.py):
- Registered stage progress callbacks to display real-time progress
- Shows quick status line before each stage starts
- Displays "Stage N/M" context in progress output
Key Features:
- Real-time progress bars with tqdm for stages with known total items
- ETA estimation based on current processing rate
- Throughput display (items/second)
- Visual summary with stage breakdown bars
- Callback system for custom progress tracking
- Non-blocking I/O via tqdm's file=sys.stderr
Acceptance Criteria Met:
[x] CLI shows progress during all stages - tqdm bars + log_stage_progress()
[x] Generation stage has accurate timing estimate - ETA calculated from current rate
[x] No blocking on I/O operations - tqdm handles async updates
Git Commit: AudiobookPipeline@c8808e2 (96 insertions, 8 deletions)
---