umputun / newscope / 15959063350

81%

push

github

feat: add summary validation, theme toggle, and UI improvements (#9)

* feat(llm): add summary validation with retry mechanism

- add retry logic to detect and fix summaries with forbidden prefixes
- add configurable forbidden_summary_prefixes in config
- add summary_retry_attempts configuration option
- implement hasForbiddenPrefix() and cleanSummary() helpers
- add comprehensive tests for validation functionality
- default forbidden prefixes cover common meta-language patterns

This prevents LLM from generating summaries that describe articles
instead of presenting the information directly.

* feat(ui): add manual theme toggle with Safari compatibility

- add theme toggle button with sun/moon icons in navbar
- implement theme persistence with localStorage
- fix Safari dark theme by removing conflicting media query
- use .dark-theme class as single source of truth
- initialize theme from localStorage or system preference

This allows users to manually switch between light and dark themes
regardless of their system preferences.

* fix(ui): ensure page scrolls to top when toggling liked filter

- change hx-swap from "show:top" to "show:body:top" in controls.html
- ensures consistent behavior with other filter controls

This fixes the issue where the page position was incorrect after
toggling the liked articles filter.

* docs: update architecture guide and add comprehensive screenshots

- rewrite ARCHITECTURE.md as onboarding guide for new contributors
- restructure to explain current system architecture clearly
- add 13 new screenshots covering all major features
- showcase both light and dark themes
- update README screenshots section with better organization
- add mobile responsive view screenshots

This improves project documentation and helps new contributors
understand the codebase structure and features.

113 of 127 new or added lines in 1 file covered. (88.98%)

3565 of 4390 relevant lines covered (81.21%)

83.44 hits per line