---

sparc_phase: C project: pediatric-news created: 2026-05-11 author: claude-vps status: pending spec_link: ./01-specification.md pseudocode_link: ./02-pseudocode.md architecture_link: ./03-architecture.md refinement_link: ./04-refinement.md

Completion — Pediatric News (Telegram + Threads + Infographic)

Definition of Done

• [ ] 3 публікації/день у Telegram з PNG-infographic, success-rate ≥ 95% за 14 днів
• [ ] 1 Threads-thread/день з depth=3 (або depth=1 поки Meta не дасть reply-permission)
• [ ] Daily-metrics summary → Telegram DM Сергію (success-rate + threads-depth)
• [ ] Token-expiry alert 7 днів до закінчення Threads token
• [ ] Tests green + coverage ≥ 75%
• [ ] AGENTS.md оновлено (Python stack замість Node.js)
• [ ] index.md оновлено: новий scope, links на SPARC-артефакти

Pre-deploy checklist

• [ ] Усі тести з Refinement green
• [ ] pipeline/ модулі лежать на VPS у /srv/projects/pediatric-news/pipeline/
• [ ] infographic_render_v2.py мігровано з /tmp у pipeline/infographic.py
• [ ] Threads token валідний (curl https://graph.threads.net/v1.0/me?access_token=... → 200)
• [ ] Cron оновлений (вже існує 0 5,11,17 * * *, нова pipeline сама за себе)
• [ ] Backup поточного bot.py.bak-2026-05-11
• [ ] Перший dry-run: python3 bot.py --dry-run → бачимо що Telegram-пост + thread + PNG згенерувалися без post-API
• [ ] Перший live tick перевірений вручну (один cron-cycle 17:00 UTC)

Runbook

Як запустити (звичайно)

Cron tick'ає сам: 0 5,11,17 * * * cd /srv/projects/pediatric-news && python3 bot.py >> /var/log/pediatric-news.log 2>&1

Як запустити вручну

cd /srv/projects/pediatric-news
python3 bot.py                  # повний tick
python3 bot.py --dry-run        # без публікації, лише generation + log
python3 bot.py --channel telegram   # лише Telegram (skip Threads)

Як зупинити

# Тимчасово (на один tick):
crontab -e   # закоментувати рядок pediatric-news
# Постійно (на обслуговування):
mv /etc/cron.d/pediatric-news /etc/cron.d/pediatric-news.disabled

Як debugging

tail -f /var/log/pediatric-news.log           # текстові логи
tail -f /var/log/pediatric-news.jsonl | jq .  # metrics per-tick
cat /srv/projects/pediatric-news/seen_ids.json | jq '. | length'  # скільки seen
journalctl -u cron --since "1 hour ago" | grep pediatric          # cron-екзекуція

Monitoring

• Logs: /var/log/pediatric-news.log (rotate weekly через logrotate)
• Metrics JSONL: /var/log/pediatric-news.jsonl (per-tick)
• Daily summary (cron 23:00 UTC): success-rate + threads-depth-avg + fail-reasons → Telegram DM Сергію
• BQ table (Phase 2 TBD): pediatric_news.events для довгострокової аналітики
• Threads Insights: tail-script тягне щодня views/replies на 7 останніх постів

Maintenance

• Threads token refresh: long-lived = 60 днів. Alert за 7 днів до expiry → Сергій робить refresh-flow:

  cd /srv/passepartout/meta/threads
  python3 refresh_long_lived_token.py   # TODO Phase 2
  

• Gemini key rotation: див. memory feedback_gemini_key_routing.md — прод використовує gemini-med-detective.key
• RSS feeds health: weekly script check_feeds.py (Phase 2) — alert якщо feed >7 днів без оновлень
• PIL шрифт: DejaVuSans-Bold з пакета fonts-dejavu, на VPS встановлено; апдейт системи може зачепити, тест test_render_png_outputs_1080x1080 ловить
• seen_ids.json gc: раз на квартал обрізати до останніх 1000 (зараз ~85 за 4 тижні, не critical)

Final sign-off

• [ ] Сергій підтвердив що все працює
• [ ] Дата: TBD
• [ ] readiness_pct: 100%
• [ ] Status: ✅ COMPLETE

🤖 PM Changelog

• 2026-05-11: повне переписання з bootstrap-template на основі реальної pipeline та нового scope (Threads + infographic)