---

sparc_phase: R project: pediatric-news created: 2026-05-11 author: claude-vps status: draft spec_link: ./01-specification.md pseudocode_link: ./02-pseudocode.md architecture_link: ./03-architecture.md

Refinement — Pediatric News (Telegram + Threads + Infographic)

Test-First план

#	Test	Status	File
1	test_fetch_rss_filters_by_age	🔴	tests/test_rss.py
2	test_fetch_rss_handles_feed_error	🔴	tests/test_rss.py
3	test_gemini_retry_on_timeout	🔴	tests/test_gemini_select.py
4	test_sanitize_post_strips_preamble	🔴	tests/test_gemini_select.py
5	test_sanitize_post_converts_md_to_html	🔴	tests/test_gemini_select.py
6	test_build_spec_required_fields	🔴	tests/test_infographic.py
7	test_render_png_outputs_1080x1080	🔴	tests/test_infographic.py
8	test_build_thread_root_under_300	🔴	tests/test_threads_publisher.py
9	test_build_thread_replies_under_500	🔴	tests/test_threads_publisher.py
10	test_publish_thread_partial_success	🔴	tests/test_threads_publisher.py
11	test_telegram_caption_trims_to_1024	🔴	tests/test_telegram_publisher.py
12	test_seen_ids_atomic_write	🔴	tests/test_state.py

TDD log

2026-05-11

• Створено spec + pseudocode + architecture, TDD ще не стартував
• Готує до старту R після Sergіy sign-off A

Що A/B-тестуємо (Phase 2, після MVP)

Експеримент	Варіант A	Варіант B	Тривалість	Метрика
Hook-формула ROOT Threads	Cliffhanger факт	Запитання-зачин	14 днів	reply-rate, impressions/day
Infographic у Telegram	sendPhoto + caption	sendMessage text-only	7 днів	views, forwards
Time-of-day shift	5/11/17 UTC (зараз)	7/13/19 UTC	14 днів	views у перші 60 хв
Threads хештеги	0 хештегів	3-4 weave-style	7 днів	impressions, profile-visits
Telegram link у Threads	У фінальному reply	Не додаємо	7 днів	click-through на Telegram

Як міряємо

• Telegram views/forwards: Bot API getChatMessage (не дає), через TGStat або @ChatStatBot manual export 1×/тиждень
• Threads metrics: Threads Insights API (GET /me/threads_insights) — views, replies, reposts, quotes per-post
• Click-through Telegram link з Threads: UTM на лінку ?utm_source=threads
• Success rate: JSONL log → daily summary parse → BigQuery pediatric_news.events (Phase 2)

Performance / нагрузові тести

Цільові з NFR specification:

• End-to-end tick latency: ≤ 180 сек (Gemini ≤60 + 3× Threads publish ≤90 + render ≤10)
• Gemini retry impact: ≤ +45 сек на retry (batch 8 замість 15)
• PIL render: ≤ 10 сек (поточний v2 ~3 сек)

Виявлені під час реалізації проблеми

• Threads reply падає з permission error (відомо 2026-05-11) — тікет до Meta, тимчасово depth=1
• AGENTS.md описує Node.js stack — застаріле, реальність Python; оновити у Completion

Coverage

Target: ≥ 75% (pure pipeline modules); orchestrator bot.py — smoke-тест tick'у з моками RSS+Gemini

Відкриті відомі баги

• [ ] Threads reply 403 (permission) — чекає Meta
• [ ] Gemini sometimes ignores «no preamble» rule (1-2% постів) → sanitize_post catches, але треба моніторити

Sign-off для переходу до C (Completion)

• [ ] Усі 12 заплановані тести green
• [ ] Coverage ≥ 75%
• [ ] Performance відповідає NFR specification (≤180 сек tick)
• [ ] Минулі 3 cron-tick'и в продакшні без помилок (smoke у проді)
• [ ] Дата: TBD
• [ ] Перехід на наступну фазу: C (Completion)

🤖 PM Changelog

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