Pin httpx<0.28.0 to fix openai proxies incompatibility

Fix openai/httpx proxies incompatibility on HuggingFace

README rewrite + cleanup

Fix vectorstore: sentence-transformers 2.7.0, BM25 fallback

Step 1: project skeleton — all stubs, directory structure, and entry point