Vitis-Arena (VTS) Design Spec

Project Code: 008 | Master: Optimus | Lead: Zero

🛡️ SURGICAL UPDATE PROTOCOL

When updating VTS, Agent Zero must strictly target only the specified component name below. No changes to the global file structure, landing page logic, or other components are permitted unless explicitly requested.

1. Global Application Stages

VTS_RESTORE

The "Resume Session?" persistence modal. Triggered if local tokens are detected.

VTS_LOBBY

Initial landing screen. Includes "Join Arena" inputs and the "Scholar Access" link.

2. Host Dashboard components

HOST_SETUP

Host-only flight configuration. Template selection (Casual/Expert) and question weighting.

HOST_BANNER

Unified top section containing Room Code, Player Count, Share Invite, and integrated Round Selection tabs.

HOST_ZONE

The "Scholar Control Center". Input for ground truth and the "Lock & Reveal" triggers.

HOST_RANKINGS

The real-time sidebar listing guests, their guess status, and current scores.

3. Player UI components

PLAYER_BANNER

Unified top section for players containing Room Code, Player Name, and integrated Round Selection tabs.

PLAYER_STATUS

Header card showing current Bottle Number and the player's cumulative score.

PLAYER_INPUT

The main interaction block: Grape, Region, and Vintage selectors + Lock buttons.

PLAYER_REVEALS

The "Bottle Profiles" archive. Shows all previously revealed attributes for the session.

4. Intelligence Layer

VTS_GD

The "God Mode" dashboard. Standalone (/scholar/) and Host-integrated archive retrieval. Provides performance analytics, ground truth reconstruction, and Luxury Dossier PDF exports.