milan-news-briefing

The Milan News Briefing is a robust Python-based automation engine designed to aggregate, process, and render daily news reports focused on Milan, Italy. It serves as an autonomous assistant for gathering local transit strike updates via MIT portals, real-time weather data, and diverse news feeds spanning world affairs, AI research, and local cultural events. The system is built for reliability, utilizing SQLite for intelligent deduplication to ensure content freshness and prevent repeating stories in subsequent daily reports. It is optimized for integration with AI orchestration frameworks like OpenClaw, allowing agents to manage source pipelines, execute custom report layouts, and handle production monitoring via webhooks.

• Multi-source integration: Supports RSS, JSON API, and HTML parsing with configurable source-of-truth in YAML.

• Smart Automation: Includes built-in support for web searching, automated retry logic with exponential backoff, and health monitoring of upstream data providers.

• Flexible Output: Generates daily Markdown reports and structured JSON results for downstream post-processing.

• Agent-Centric Design: Provides dedicated CLI scripts for managing cron jobs, checking feed status, and modifying reporting sections dynamically.

• Robust Reliability: Features an auto-degrade mode to bypass intermittent source outages and comprehensive logging in the output/logs/ directory.

• Users should define sources in config/sources.yaml and maintain the local SQLite database for historical deduplication.

• Supports various layout styles including classic, editorial, and brief formats via command-line flags.

• Operational pipelines are fully modular; new parsers can be injected into src/news_briefing/parse.py without refactoring the core logic.

• Designed for Linux/macOS environments with standard crontab integration for hands-off daily execution.

• Ensure all dependencies are met via the provided requirements.txt and use the venv-based execution pattern for environment isolation.