document error codes, tier routing, and local fallback

readme gains the five-model table, a status code map with machine codes,
prefer_local and quota notes, and the live tier doctor description.