Initial commit: ULPgrammer

- Core Telegram monitoring pipeline (scraper, processor, notifier, downloaders)
- Textual TUI frontend with thread-safe event bus
- SQLite persistence, severity scoring, dedup cache
- Fixed ULP parser: handles https:// truncation, port+path URLs, semicolon separator
- Test suite: 88 tests across scorer, cache, database, processor

.env.example

@@ -0,0 +1,22 @@
+# ─── Telegram API credentials ──────────────────────────────────────────────
+# Get these from https://my.telegram.org → API development tools
+API_ID=12345678
+API_HASH=your_api_hash_here
+
+# ─── Bot credentials ────────────────────────────────────────────────────────
+# Create a bot via @BotFather and paste the token here
+BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
+
+# ─── Alert destination ──────────────────────────────────────────────────────
+# Chat ID to send hit notifications to (your personal ID or a group)
+# Tip: message @userinfobot on Telegram to get your ID
+NOTIFY_CHAT_ID=987654321
+
+# ─── Session name (just a filename, no extension needed) ────────────────────
+SESSION_NAME=monitor_session
+
+# ─── tdl (fast Go downloader) — optional but strongly recommended ───────────
+# Install: https://github.com/iyear/tdl
+# After installing, run once: tdl login -n <SESSION_NAME>
+# SESSION_NAME above is shared between Telethon and tdl — no double login needed.
+# If tdl is not on PATH the bot falls back to Telethon automatically.