Add Telegram bot control interface for HuggingFace Spaces deployment

update current version doc

refactor: composition root, per-cycle regime, tests, docs

fix bugs

uv migrations

add core logic for marcoeconomical analysis

add core logic

initial commit