docs/OMNIROUTE_ALLOCATION_HANDOFF.md

Rama release/v3.8.54 · réplica de lectura del repositorio original.

# OmniRoute Allocation Handoff

Allocation is not provider quota.

Quota pools define which API keys may consume a provider pool and how hard, soft, or burst policies apply. Provider quota is external capacity reported by a provider or an explicitly configured source. Ghostlight internal budgets are governance limits defined by the administrator.

The `ensurePool` operation is idempotent: an identical pool is unchanged, a changed allocation is updated, and a missing pool is created. This is intended for automation and bounded API callers.

The read-only status endpoint is `GET /api/omniroute/status`. The verification command is `npm run omniroute:verify`; it makes no live model request.