- docs/PARKSMARTER_API.md: narrative guides (bootstrap/auth, finding parking,
estimates, initiating a transaction, sessions/receipts, account) + per-endpoint
reference + a behaviors/gotchas table (200-on-error, stale-token empty body,
multi-estimate fallback, free windows, flat-rate zones, no free check-in).
- client README: link the guide; promote PastSession/ParkingReceipt to CONFIRMED
(ActiveSession still pending — no active session at capture time).
- Main README: mark "Start a paid session" as working (confirmed live end-to-end).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>