Gan, Jimmy
83 lines
3.5 KiB
Markdown
83 lines
3.5 KiB
Markdown
# Sprint 003 — Agent Worker + Daily Telegram Digest
|
|
|
|
**Depends on:** Sprint 002 (FTS, duration, view count, pagination)
|
|
**Duration:** ~8h total
|
|
**Goal:** Make the agent queue functional (LLM processing), and deliver a daily Telegram digest of new YouTube summaries.
|
|
|
|
---
|
|
|
|
## T3.1 — Implement agent_worker LLM processing
|
|
|
|
- **Files:** `backend/agent_worker.py`, `backend/main.py`
|
|
- **Done means:** `agent_worker.py` processes items from `agent_queue` with status=`pending`:
|
|
- Calls local LLM (via `QWEN_BASE_URL` env) or DeepSeek API to process the queued note/prompt.
|
|
- Stores result in `agent_queue.result` column.
|
|
- Updates status: `pending` → `processing` → `done` (or `error`).
|
|
- Runs as background loop every 30s.
|
|
- **Verify by:**
|
|
1. Add item to agent queue via frontend "Save to Agent".
|
|
2. Watch status change to `processing` then `done` in queue tab.
|
|
3. `result` field populated with LLM response.
|
|
- **Risk:** LLM endpoint may be unreachable from NAS. Use `AGENT_BASE_URL` env var with fallback to DeepSeek API.
|
|
|
|
- [ ] T3.1 — Agent worker LLM processing
|
|
|
|
## T3.2 — Daily Telegram digest via cron
|
|
|
|
- **Files:** New cron job in Hermes (not in repo — Hermes-managed)
|
|
- **Done means:** Every morning at 8:00 AM CST (00:00 UTC), Hermes:
|
|
1. Calls `GET /api/videos?status=pending&limit=20` on t-youtube backend.
|
|
2. Groups by channel.
|
|
3. Formats and sends a Telegram digest message: channel name, video title, summary snippet.
|
|
4. Marks videos as `read` after sending (optional, or just inform).
|
|
- **Verify by:**
|
|
1. Trigger cron manually → Telegram message received.
|
|
2. Message shows channel groupings, titles, and summaries.
|
|
- **Risk:** t-youtube API behind Authelia — cron needs API token, not SSO. Use `API_TOKEN` env var.
|
|
|
|
- [ ] T3.2 — Daily Telegram digest cron
|
|
|
|
## T3.3 — Duration + view count display in frontend
|
|
|
|
- **Files:** `frontend/src/routes/YoutubeDashboard.svelte`
|
|
- **Done means:** Video list items show duration (formatted as `MM:SS` or `H:MM:SS`) and view count (formatted as `1.2M`, `45K`) in the sidebar list item.
|
|
- **Verify by:**
|
|
1. Open dashboard → sidebar shows duration + view count for videos where populated.
|
|
2. Videos with `duration=null` show nothing (no broken display).
|
|
- **Risk:** Most existing videos don't have duration yet (only newly synced ones do). Display only if non-null.
|
|
|
|
- [ ] T3.3 — Duration + views display in video list
|
|
|
|
## T3.4 — Search UX polish: debounce + loading state
|
|
|
|
- **Files:** `frontend/src/routes/YoutubeDashboard.svelte`
|
|
- **Done means:**
|
|
- Search input debounced 300ms (no API call on every keystroke).
|
|
- Loading spinner shows while fetching search results.
|
|
- "No results" state when FTS returns empty.
|
|
- **Verify by:**
|
|
1. Type quickly → only one API call fires (after 300ms pause).
|
|
2. Loading state visible while waiting.
|
|
3. Type nonsense → "No results" shows cleanly.
|
|
|
|
- [ ] T3.4 — Search debounce + loading state
|
|
|
|
## T3.5 — Update active.md symlink to Sprint 003
|
|
|
|
- **File:** `docs/specs/active.md`
|
|
- **Done means:** Symlink points to `sprint-003-agent-digest.md`.
|
|
- **Verify by:** `ls -la docs/specs/active.md` → points to sprint-003.
|
|
|
|
- [ ] T3.5 — Update active.md symlink
|
|
|
|
---
|
|
|
|
## Exit criteria
|
|
|
|
- [ ] Agent queue processes items via LLM — status changes pending → done, result populated
|
|
- [ ] Daily Telegram digest cron fires at 8 AM CST with grouped summaries
|
|
- [ ] Duration + view count shown in video list (non-null only)
|
|
- [ ] Search debounced, has loading state and empty state
|
|
- [ ] All 23+ backend tests pass
|
|
- [ ] Frontend builds cleanly
|