---

name: bitzero-test description: Generate tests for BitZero server handlers, extensions, and controllers. Use when testing doLogin, handleClientRequest, ISession, or any BitZero game server code.

BitZero Test Generation

Generate tests for BitZero game server code using built-in test doubles.

MCP Tools (zest-intellij server)

Use these MCP tools - they work via IntelliJ's indexing and don't require JDK in terminal.

Code Validation

Always validate before saving:

Copy1. Generate test code
2. validateCode(projectPath, code, "MyClassTest")
3. Fix errors if any, re-validate
4. Save file

Code Exploration (works with JARs)

Example Workflow

Copy1. getProjectDependencies(projectPath)   → Check JUnit, available libs
2. lookupClass("ISession")               → See interface methods
3. getTypeHierarchy("ISession")          → Find TestSession
4. [Write test code]
5. validateCode(projectPath, code, "MyTest")  → Verify it compiles
6. [Save file]

BitZero is in a JAR

BitZero framework classes are in JARs. Standard grep/ripgrep won't find them. Use the MCP tools above - they read JARs through IntelliJ's indexing.

Test Type Selection

Choose the right test type based on code coupling:

Don't force unit tests. If code uses BitZeroServer.getInstance() or other singletons, use integration/e2e tests instead.

Test Doubles (No Mockito)

Test doubles location: bitzero/test/

Test Patterns by Code Type

Handler with Injectable Dependencies → Unit Test

Copypublic class MyHandlerTest {
    static class TestableHandler extends MyHandler {
        final List<BaseMsg> sent = new ArrayList<>();

        @Override
        protected void send(BaseMsg msg, User recipient) {
            sent.add(msg);
        }
    }

    @Test
    void handleRequest_ValidInput_SendsResponse() {
        TestableHandler handler = new TestableHandler();
        TestUser user = TestUser.createLoggedIn("player1");
        DataCmd cmd = createTestCmd();

        handler.handleClientRequest(user, cmd);

        assertEquals(1, handler.sent.size());
    }
}

doLogin or Singleton Usage → Integration Test

Copypublic class LoginExtensionTest extends IntegrationTestBase {

    @BeforeClass
    public static void setup() throws Exception {
        startServer();  // Embedded BitZeroServer
    }

    @Test
    void doLogin_ValidCredentials_CreatesUser() {
        TestLoginResult result = doLogin((short) 1, "user1", "pass123");

        result.assertSuccess()
              .assertSessionLoggedIn()
              .assertUserCreated();
    }
}

Full Game Flow → E2E Test

Copypublic class GameFlowE2ETest extends IntegrationTestBase {

    @Test
    void playerCanLoginAndJoinRoom() {
        // Login
        TestLoginResult login = doLogin((short) 1, "player1", "pass");
        login.assertSuccess();

        // Join room
        DataCmd joinCmd = createJoinRoomCmd("room1");
        TestSession session = login.getSession();

        // ... full flow testing
    }
}

Workflow

Step 1: Understand the Target

CopylookupClass(className)           → Get method signatures
getTypeHierarchy(className)      → See inheritance chain
findImplementations(interfaceName) → See concrete implementations

Step 2: Analyze Dependencies

Ask: Does this code...

• Use BitZeroServer.getInstance()? → Integration test
• Have constructor injection? → Unit test possible
• Need real session manager? → Integration test
• Just transform data? → Unit test

Step 3: Choose Test Approach

Step 4: Generate and Validate

CopyvalidateCode(projectPath, code, className) → Check test compiles

Test Scenarios to Cover

1. Happy Path - Valid input, expected response
2. Auth State - Logged in vs not logged in
3. Invalid Input - Null, empty, malformed DataCmd
4. Error Paths - BZException scenarios
5. State Changes - Session properties, user state

Escoba-Server Examples

Testing Pure Game Logic (BaseGame)

Copypublic class CardValueTest {
    // Pure calculation - no dependencies
    @Test
    void getCardValue_CardId8_Returns3() {
        // Cards: 0-3=1, 4-7=2, 8-11=3...
        assertEquals(3, getCardValue(8));
    }

    @Test
    void checkBeginingEscoba_Sum15_Returns1() {
        // Test escoba detection logic
        List<Integer> cards = Arrays.asList(0, 4, 8, 12); // 1+2+3+4=10
        assertEquals(0, checkBeginingEscoba(cards));

        List<Integer> escoba = Arrays.asList(8, 12, 24); // 3+4+7=14... adjust
        // Test actual sum=15 case
    }

    private int getCardValue(int cardId) {
        return cardId / 4 + 1;
    }
}

Testing with StubTable (Constructor Injection)

Copypublic class BaseGameTest {
    // Stub provides controlled environment
    static class StubTable extends BaseTable {
        private List<BasePlayer> players = new ArrayList<>();

        public StubTable() {
            super(1, 1, TABLE_MODE.NORMAL, false, BetLevel.LEVEL_1, "test");
        }

        public void addPlayer(BasePlayer p) { players.add(p); }

        @Override
        public List<BasePlayer> getListPlayerPlaying() { return players; }

        @Override
        public void broadcast(TableMsgWrapper msg) { /* no-op */ }
    }

    static class StubPlayer extends BasePlayer {
        private List<Integer> cards = new ArrayList<>();

        public StubPlayer(int id, String name) {
            super(id, name, 0);
        }

        @Override
        public List<Integer> getListCardOnHand() { return cards; }

        public void setCards(List<Integer> c) { this.cards = c; }
    }

    @Test
    void game_DealCards_EachPlayerGetsThree() {
        StubTable table = new StubTable();
        table.addPlayer(new StubPlayer(1, "p1"));
        table.addPlayer(new StubPlayer(2, "p2"));

        BaseGame game = new BaseGame(1, table);
        game.start();

        // Verify card distribution
    }
}

Testing Handlers (Override send() Seam)

Copypublic class AccountRequestHandlerTest {
    // Override protected send() to capture messages
    static class TestableHandler extends AccountRequestHandler {
        public final List<BaseMsg> sent = new ArrayList<>();
        public final List<User> recipients = new ArrayList<>();

        @Override
        protected void send(BaseMsg msg, User recipient) {
            sent.add(msg);
            recipients.add(recipient);
        }
    }

    @Test
    void handleClientRequest_UnknownCmd_NoResponse() {
        TestableHandler handler = new TestableHandler();
        User user = createTestUser();
        DataCmd cmd = createCmd((short) 9999); // Unknown

        handler.handleClientRequest(user, cmd);

        assertTrue(handler.sent.isEmpty());
    }
}

Integration Test (Singleton-Heavy Code)

When code uses UserDAOImpl.getInstance() directly:

Copypublic class AccountIntegrationTest extends IntegrationTestBase {
    @Test
    void getUserData_ValidUser_ReturnsProfile() {
        // Start embedded server first
        TestLoginResult login = doLogin("user1", "pass123");
        login.assertSuccess();

        // Now UserDAOImpl singleton is initialized
        DataCmd getProfileCmd = createCmd(CMD.GET_USER_DATA);
        TestResponse response = sendRequest(login.getSession(), getProfileCmd);

        response.assertSuccess();
        // verify profile data
    }
}

Seam Reference (Escoba-Server)

Output

Generate complete test class with:

• Package matching test source root
• All required imports (NO Mockito!)
• Test doubles as inner classes if needed
• Given-When-Then structure
• Descriptive method names: methodName_scenario_expectedResult