CommonStudio-Tests-VideoTemplate-main

EGM bet level selection using direct CustomBet buttons. Use when selecting bet levels, iterating bet/denom combinations, verifying bet changes, pressing bet buttons, or fixing code that uses BetIncrement/BetDecrement. Covers: GetBetButtonName(index), AvailableStakeCombinationIndices, SelectedStakeCombinationIndex, press-poll-repress retry pattern, index mapping rule, TotalBet diagnostic logging. CRITICAL: bet levels use direct selection buttons NOT increment/decrement. stages: test-implementation, test-validation

Build commands, CI workflows, NuGet restore, and troubleshooting. Use when building the project, restoring NuGet packages, running tests, publishing, debugging CI/CD pipelines, or troubleshooting build errors like NU1301. Covers: dotnet restore, dotnet build Tests --no-restore, dotnet publish, self-hosted runners, internal NuGet sources, NU1301 resolution, test connection failures. stages: test-implementation, test-validation

EGM credit insertion and cashout flows. Use when inserting credits, handling zero-balance denom popup trigger, cashing out, confirming cashout, checking credit balance, or managing credit top-up between game cycles. Covers: CashInController, CashoutController, forced denom popup on zero balance, cashout confirmation, credit balance checks. stages: test-implementation, test-validation

EGM denomination selection and verification. Use when selecting denominations, handling forced denom popup, switching denominations during play, verifying denom changes via PaytableProvider AVV readback, iterating denom/bet combinations, or detecting DenomForcedSelectionPopUp. Covers: GetDenomButtonName(index), ChangeDenomInProgress, press-poll-repress retry pattern, AVV verification, OpenPopUps detection. stages: test-implementation, test-validation

EGM feature detection and handling during game cycles. Use when handling free games, re-spins, wheel bonuses, gamble features, win counting, intermediate acknowledgement screens, or feature chooser menus. Covers: GameFlowStatusProvider, RunningFeatures, FeatureTypes constants, GameFeatureController, GambleController, ReSpinController, WheelBonusController, WinCountingStatusProvider, StartGame button to dismiss screens. stages: test-implementation, test-validation

EGM game cycle initiation, detection, and completion. Use when starting a game, detecting game cycle state, choosing between SelfPlay and StartGame button, understanding game state flow, or waiting for game idle. Covers: GameCycleActive, InActivePlayMode, SelfPlayFacade vs ButtonsFacade StartGame, game state flow diagram, bet placement, reel spin, outcome evaluation. stages: test-implementation, test-validation

Creating new components: Controllers, Providers, Services, Facades, Orchestrators, Validators. Use when creating a new UTP Facade, StatusDatabase provider, controller, service, orchestrator, or choosing which architectural pattern to use. Covers: ModuleFacadeBase boilerplate, GetBooleanResult not GetResult, StatusDatabaseProviderBase, provider SRP, pattern selection decision tree, primary constructors, XML documentation. stages: test-implementation, test-validation

Bounded polling and waiting patterns for EGM state changes. Use when writing async poll loops, waiting for EGM conditions, handling stuck/blocked EGM states, dismissing intermediate screens, or implementing timeout logic with CancellationToken. Covers: bounded poll pattern, linked CancellationTokenSource, unblock pattern with StartGame button, diagnostic screenshots. stages: test-implementation, test-validation

EGM reel state detection and visible symbol retrieval via MPT UTP module. Use when waiting for reels to stop spinning, reading visible symbols on screen, parsing MPT response format, using ReelWaitService, MptFacade, MptResponseParser, or validating reel stop positions. CRITICAL: reel data comes from MPT module NOT StatusDatabase. Do not fabricate ReelStatus paths. stages: test-implementation, test-validation

SAE UTP module snippet operations: listing available snippets, parsing the GetAllAvailableSnippets response, activating and starting snippets by path, and uploading snippet XML files. Use when working with SAE snippets, calling GetAllAvailableSnippetsAsync, parsing snippet lists, activating snippets by path, or verifying a snippet was uploaded. CRITICAL: the response is a JsonArray of JsonObject group entries, each with a "Snippets" property containing a JsonArray of plain string paths — NOT a flat list of strings or objects with a "Name" property. stages: test-implementation, test-validation

StatusDatabase path rules, return types, and provider patterns. Use when referencing StatusDatabasePaths, creating or modifying StatusDatabase providers, querying game state via StatusDatabase, fixing CS0117 errors, choosing GetStatusValueAsync type parameters, detecting popups via OpenPopUps, or applying provider SRP. Covers: mandatory pre-flight grep_search, nested class qualification, return type conventions, popup detection pattern, provider naming, hardcoded string prohibition. stages: test-implementation, test-validation

Mandatory pre-flight checks for NUnit EGM test files. Use when writing, creating, or editing test files inheriting EgmTestBase. Covers: code-first rule (read files before asking), component verification via file_search, constructor signatures, mandatory using BugSweeper.Tests directive, test file placement under Tests/Features/, compilation error fix workflow, self-check checklist. Required for every test file. stages: test-implementation, test-validation