fake-summoner-server

FakeSummoner — Server Tests

核心概念

FakeSummoner = 一個 測試用的 window/連線，同時擁有：

• 真的 socket.io client（連到測試用 FakeServer）
• 一個 FakeClaude（模擬 CLI 過程）
• FilesystemService / GitService 的記憶體 fake 實作

每個 FakeSummoner 代表「一個 UI window」。多 window 測試建立多個 summoner 共用同一 server。

Import 來源

東西	從哪 import
createFakeSummoner / createFakeServer / createTestContainer	../test/index（server 專用版，會 wire DI container）
segments as s	@code-quest/summoner/test

Server tests 一律從 ../test/index.ts import — 那是包過 DI container 的版本。@code-quest/summoner/test 的同名 export 是 summoner base 版，給 summoner package 本身測試用。

最小 Setup

import { segments as s } from '@code-quest/summoner/test';
import { createFakeSummoner } from '../test/index.ts';

const claude = createFakeSummoner().claude();
const channelId = await claude.initialize();

initialize() 跑完整 CLI 啟動流程：spawn → ready → init segment。

含 DI container（存取 services）

import { createFakeServer, createFakeSummoner, createTestContainer } from '../test/index.ts';

async function setup(sessionId = 'cli-sess') {
  const container = createTestContainer();
  const server = createFakeServer(container);
  const summoner = createFakeSummoner(server);
  const claude = summoner.claude();
  const channelId = await claude.initialize(s.init(sessionId));
  return { container, claude, channelId };
}

FakeSummoner API

const summoner = createFakeSummoner(server);

summoner.claude()                  // lazy-init FakeClaude
summoner.socket                    // FakeSocket（注入到 SocketProvider）
summoner.filesystem()              // FakeFilesystemService
summoner.git()                     // FakeGitService（可 undefined）
summoner.openspec()                // FakeOpenspecService（可 undefined）
summoner.pluginCli()               // FakePluginCliService（可 undefined）
summoner.connected                 // boolean
summoner.disconnect()

await summoner.send<T>(event, payload)     // 透過 socket 送（等 ack）
summoner.receivedEvents()                  // 收到的所有 server → client events
summoner.receivedEvents('session:init')    // 過濾特定 event
summoner.sentEvents()                      // 所有 client → server emits
summoner.sentEvents('session:launch')      // 過濾特定 sent event
summoner.on(event, fn)                     // subscribe
summoner.holdEmit(event)                   // 攔截下一次 emit 的 ACK（見下節）