Skip to content

CTF-908: Event Capacity Declaration

Statement

The CTF layer shall declare event-level capacity attributes to the platform's provisioning engine at event provisioning-plan time, before range spinup begins. Attributes shall include: expected concurrent-range count, participant cohort size, and expected shared-resource demand (including agentic/LLM usage hints such as model/provider class and per-participant rate expectations). These declarations inform the engine's capacity-aware provisioning (see PLAT-201) and shall not be inferred from observation of spinup traffic alone.

Rationale

Event pacing alone cannot establish whether shared capacity can support an event. Advance declarations let the platform assess model throughput, network capacity, image supply and provisioning concurrency, and report insufficient headroom before launch.

Traceability

  • DOCUMENTS → GITHUB_ISSUE Brad-Edwards/bigrae#668 (CTF-908: Event Capacity Declaration)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/models/event.py (CTFEvent.capacity_hints and model_demand declaration fields)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/range/capacity.py (declare_event_capacity derives the counts and declares them before spin-up)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/engine/models/_capacity.py (CapacityDeclaration engine record)
  • TESTS → TEST shifter/shifter_platform/tests/ctf/test_capacity_signaling.py (Declared counts and hints, idempotent redeclaration and failure handling)
  • TESTS → TEST shifter/shifter_platform/tests/ctf/test_capacity_spare_declaration.py (Spare-pool capacity declaration)