fake-summoner-server

What problem does it solve?

FakeSummoner eliminates slow, brittle integration testing by providing a realistic server-side test harness that includes socket.io communication, a fake Claude/CLI protocol stream, and in-memory filesystem/git behaviors.

Core Features & Use Cases

• Server test harness with real socket flow: Simulates a connected client window using an actual socket.io client and lets you validate both RPC responses and server broadcasts.
• Fake CLI/Claude protocol driving: Runs a FakeClaude that initializes by spawning the CLI protocol workflow and can emit protocol segments (assistant/result/control requests) into the server.
• Deterministic multi-layer verification: Supports end-to-end assertions across RPC/ack results, broadcast events, store/DB side effects, and simulated CLI stdin/control responses.
• Channel/session lifecycle simulation: Enables join patterns across multiple windows, session resume after simulated restart, and external launch flows via prepareInit.

Quick Start

Use the fake-summoner-server skill to initialize a FakeSummoner, then send a chat message event and assert the resulting server-to-client protocol events and any persisted state.