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)