# Project

## Goal
Provide Hermes with a small, explainable, read-only regime feed for market sentiment and macro risk dynamics.

## v1 shape
- read-only regime snapshot tool
- read-only snapshot history tool
- FastAPI + FastMCP on one port
- SQLite persistence for snapshots
- provider adapters for Finnhub and Twelve Data
- domain scoring for risk appetite, stress, liquidity, and real-asset pressure

## Scope guardrails
- no trading decisions
- no action dispatch
- no dashboard in v1
- keep the regime schema small and stable