headway-news-bot

Telegram approval bot and news monitor for the EV charging channel@headway74.

The project searches EV charging news, creates Russian Telegram drafts, attaches relevant media when possible, sends drafts to the owner for review, and publishes only after an explicit approval command.

- Human-gated publishing: draft first, channel publish only afterпубликуй.
- Channel voice is provider-independent and defined invps/channel_agent_rules.md.
- The bot writes for EV drivers, charger buyers, site owners, operators, installers, and EV infrastructure readers.
- The bot must not publish template filler or misleading media.
- Original article media is preferred. If no original media exists, exact entity search is preferred. AI image generation is allowed only after an explicit owner command.

- vps/monitor.py- scheduled news monitor, source parsing, LLM drafting, China reporting.
- vps/bot.py- Telegram approval bot, publish/rewrite/media commands.
- vps/channel_agent_rules.md- mandatory editorial rules for every model/provider.
- vps/database/history.py- SQLite history, quality statistics, owner feedback memory.
- vps/media/precise_image_search.py- precise image search for draft media corrections.
- vps/media/media_status.py- media status messages and owner guidance.
- vps/keyboards.py- inline keyboards with draft-bound callback data.
- vps/media/image_dedup.py- ImageHash-based media duplicate detection.
- vps/backup.py- SQLite gzip backups.
- vps/security/rate_limit.py- simple in-memory command rate limiter.
- vps/datasette-metadata.json- local-only Datasette metadata.
- vps/smoke_check.py- fast deployment sanity check.
- vps/tests/test_static_guards.py- static guard tests for critical behavior.

./.venv/bin/python vps/smoke_check.py ./.venv/bin/python -m unittest discover -s tests -p "test_.py" ./.venv/bin/python -m pytest tests systemctl status headway-news-bot.service --no-pager systemctl list-timers --all | grep headway

ADMIN_TELEGRAM_ID=117574226 ERROR_NOTIFICATIONS_ENABLED=1

DAILY_REPORT_ENABLED=1 DAILY_REPORT_TIME=09:00 SCHEDULER_ENABLED=1 SCHEDULER_TIMEZONE=Asia/Yekaterinburg

IMAGE_HASH_ENABLED=1 IMAGE_HASH_THRESHOLD=10

pip install datasette datasette vps/database/history.db \ --host=127.0.0.1 \ --port=8001 \ --metadata=vps/datasette-metadata.json

vps/backup.pyделает gzip-бэкап всех SQLite-баз изvps/database/.dbи хранит последние архивы.

- history.db
- image_hashes.db, если база уже создана ImageHash-дедупликацией

BACKUP_ENABLED=1 BACKUP_KEEP_DAYS=14 BACKUP_DIR=backups

Команда доступна только владельцу. Если базы еще нет, бот не падает и отвечает, что бэкап не создан.

- публикация;
- отклонение;
- генерация изображения;
- поиск изображения;
- бэкап.

OWNER_CHAT_ID=117574226 ADMIN_TELEGRAM_ID=117574226

Если команду вызывает не владелец, бот отвечает:Команда доступна только владельцу.

RATE_LIMIT_ENABLED=1 RATE_LIMIT_REQUESTS=30 RATE_LIMIT_WINDOW_SECONDS=60 RATE_LIMIT_OWNER_BYPASS=1

По умолчанию владелец не ограничивается rate limit.

При превышении лимита бот отвечает:Слишком много команд. Попробуйте позже.

python -m compileall vps python -m pytest tests -v ./.venv/bin/python vps/smoke_check.py systemctl restart headway-news-bot.service systemctl status headway-news-bot.service --no-pager

This temporary mode is used when the channel is being tuned again with owner feedback. It does not publish automatically. It only sends drafts to the owner for review.

- collect enough candidates every day;
- keep at least 2 strong publishable drafts per day in the review flow;
- save owner comments, rejects, media notes, and publish decisions intohistory.db;
- let future prompts use recent rejection feedback so provider swaps do not change the channel voice.

- vps/headway-news-monitor-training7d.timer
- vps/headway-news-monitor-training7d.service
- vps/run_training_monitor.sh

TRAINING_DURATION_HOURS=168 TRAINING_LOOKBACK_HOURS=24 TRAINING_TARGET_DRAFTS_PER_DAY=2

sudo cp vps/headway-news-monitor-training7d.service /etc/systemd/system/ sudo cp vps/headway-news-monitor-training7d.timer /etc/systemd/system/ sudo chmod +x vps/run_training_monitor.sh sudo systemctl daemon-reload sudo systemctl enable --now headway-news-monitor-training7d.timer sudo systemctl start headway-news-monitor-training7d.service

/opt/headway-news-bot/.venv/bin/python /opt/headway-news-bot/vps/monitor.py --hours "$TRAINING_LOOKBACK_HOURS" --send-review

It does not call channel publishing code. Publishing still requires owner approval in Telegram.

Useful Telegram commands during training:

- /training_status- shows whether training mode is active, when it started, hours left, candidates, drafts, owner publishes/rejects, rewrites, and media errors.
- /source_quality- shows source quality for 7 days by default.
- /source_quality 30or/source_quality 90- shows a longer source-quality window.
- /bad_sources- shows sources with low approval, many rejects, weak facts, poor media, or off-topic drafts. The bot only recommends, it does not disable sources automatically.
- /good_topics- shows topics that more often reach publication, including charging infrastructure, fast charging, China, subsidies, hubs, battery swap, and standards.
- /daily_report- includes the "Обучение канала за 7 дней" block while the training state exists.
- /memoryor/update_memory- refresheseditorial_memory.mdfrom history.

editorial_memory.mdkeeps manual notes outside this generated block:

<!-- AUTO_HISTORY_START --> ... <!-- AUTO_HISTORY_END -->

The automatic block stores best sources, bad sources, good topics, frequent rejection reasons, media rules, and phrases to avoid.

sudo systemctl disable --now headway-news-monitor-training7d.timer

The timer disables itself after the configured duration.

Do not commit.env, API keys, Telegram tokens, SSH keys, runtime drafts, media storage, logs, or SQLite databases.

Use.env.exampleas the only committed environment template.

Fetch and interact with Hacker News content, including top stories, comments, and search functionality.

Access Hacker News stories, comments, and user profiles using the Hacker News API.

Integrate real-time Hacker News data and discussions into your applications and workflows.

Interact with Hacker News through the Model Context Protocol (MCP), designed for Claude Desktop.

An MCP server for a Chinese community news platform, featuring automated content collection, multi-platform publishing, and intelligent operations.

An MCP server for interacting with the Reddit API, enabling searches for posts, comments, and subreddits.

A news feed server for aggregating news from various sources.

Access Reddit's public API to browse frontpage posts, subreddit information, and read post comments.

A server for fetching and creating content on Reddit using its API.

Interact with the Reddit API to fetch saved posts, search, get comments, and reply.