t-youtube/docs/specs/sprint-002-ux-search-metadata.md

Sprint 002 — UX Overhaul, Full-Text Search & Metadata Enrichment

Goal: Overhaul the t-youtube reading experience by completing the search workflow, adding transcript visibility, fetching duration/views metadata, and implementing cursor-based/offset pagination (infinite scroll).

---

[x] T2.1 — Full-Text Search Frontend Integration

• Files: frontend/src/routes/YoutubeDashboard.svelte
• Done means: Search queries directly populate the main video list in the sidebar (rather than a temporary dropdown), and clearing the search resets the view.
• Verify by:
  1. Type search query -> video list dynamically updates with FTS results from backend.
  2. Click a search result -> detail view loads it.
  3. Clear query/blur search -> list reverts to standard tab view.

[x] T2.2 — Transcript Accordion in Details View

• Files: frontend/src/routes/YoutubeDashboard.svelte
• Done means: Add an expandable accordion below the "AI Digest" section to view the raw video transcript. If transcript is long, render in scrollable container.
• Verify by:
  1. Click video with transcript -> "Show Full Transcript" accordion appears.
  2. Click to expand -> raw transcript displays correctly.

[x] T2.3 — Ingest Duration and View Count Metadata

• Files: backend/fetcher.py, backend/tests/test_fetcher.py
• Done means: Update fetcher.py videos.list API call to request part="snippet,contentDetails,statistics". Parse ISO 8601 duration into integer seconds, and store duration + view count in SQLite db. Update unit tests to include mock response fields.
• Verify by:
  1. Run ./run_tests.sh to ensure fetcher tests pass.
  2. Sync subscriptions -> inspect database to confirm duration and view_count are populated for new videos.

[x] T2.4 — Cursor/Offset Pagination (Infinite Scroll)

• Files: backend/main.py, frontend/src/routes/YoutubeDashboard.svelte
• Done means: Add pagination queries to /api/videos backend endpoint (e.g. offset and limit). In Svelte frontend, implement scroll listener on the sidebar video list to trigger next page load when reaching bottom.
• Verify by:
  1. Load pending tab -> initially loads 50 videos.
  2. Scroll to bottom of sidebar -> next 50 videos append automatically.