add: Docker deployment for HF Spaces demo

feat(agent): implement comprehensive logging and fix recursion loop

feat(api): implement FastAPI read-side layer with 4 endpoints and OpenAPI contract