clio/TODO.md

Clio TODO

Requirements / Expected Behaviors

These are expected behaviors that should be preserved. If something breaks, check this list.

Audio Player

• Audio should auto-play when opening a recording
• Clicking a highlight should seek to that position and auto-play
• Clicking a search result should seek to that position
• Skip buttons (-30s, -5s, +5s, +30s) should work
• Speed controls should persist during playback
• Native audio controls (play/pause, seek, volume) should work

Navigation

• URL should show #/recording/{id} when viewing a recording
• URL should show #/calendar/{date} when viewing a specific day
• Browser back/forward should work correctly
• Refreshing page should preserve current view

Dates/Times

• All dates should display in local timezone (not UTC)
• Calendar should highlight today's date

Highlights

• Creating a highlight should save to API
• Deleting a highlight should remove from API
• Highlights should appear in the highlights panel
• Clicking a highlight in HighlightsView should open recording at that time

Known Issues

Audio Player

• Short audio files may show wrong duration initially
• DayView density bars may show duplicate lines

Data Import

• Need to import large historical dataset before removing duplicate calendar

Completed

Security

• API key authentication on all endpoints
• UI prompts for API key and stores in localStorage
• Audio fetched via authenticated blob URL

Deployment

• Forgejo workflow for UI deployment
• Forgejo workflow for API deployment
• Add sudoers rule for gitea-runner to restart phone-recorder

Cleanup

• Removed dead quality code (was hardcoded to 'good')
• Simplified audio player to native HTML5 controls
• Added favicon

Future Ideas

• Prev/next recording buttons
• Keyboard shortcuts (space to play/pause, arrow keys to seek)
• Playwright tests
• Waveform visualization (when transcripts available, show speaking density)