code-quest: Skill for Claude Code

FakeSummoner — Client Tests

核心概念

Client 端 FakeSummoner 繼承 server 基礎版 + 加上 TypedSocket 型別。搭配兩個 render helper：

• renderWithWorkspace — 完整 workspace，適合 多 tab / workspace-level 測試
• renderWithChannel — 單一 channel 包好，適合 component / context / hook 測試

React 互動必須在 act() 裡 flush。

Import 來源

東西	從哪 import
renderWithChannel / renderWithWorkspace	@/test/render-with-channel / @/test/render-with-workspace
createFakeSummoner / FakeSummoner	@/test/fake-summoner（含 TypedSocket 強型別）
createFakeServer	@code-quest/server/test
segments as s / controlRequest*	@code-quest/summoner/test
sendUserMessage / emitAssistantTurn	@/test/helpers

renderWithChannel — 最常用

自動包 SocketProvider → SessionProvider → ... → TabProvider → ChannelProvider，並跑 claude.initialize()。

import { renderWithChannel } from '@/test/render-with-channel';
import { segments as s } from '@code-quest/summoner/test';

const { claude, channelId, user } = await renderWithChannel(<ChatPanel />);

await user.type(screen.getByPlaceholderText(/Esc to focus/i), 'hello{Enter}');
await act(async () => {
  await claude.emitSegment(s.assistant('Hi back'));
  await claude.emitSegment(s.result());
});

expect(screen.getByText('Hi back')).toBeInTheDocument();

選項

await renderWithChannel(<MyComponent />, {
  channelId: 'ch-test',
  skipInit: false,                    // false = 自動 initialize
  extraSegments: [                    // 額外 init-time segments
    s.controlResponse('init', { models: [{ value: 'opus-4-6' }] }),
  ],
  initialState: {                     // ChannelProvider 的 initial state 注入
    pendingControls: [{ requestId: 'r1', subtype: 'can_use_tool', toolName: 'Bash' }],
  },
  launchOnMount: false,               // true = React 驅動 session:launch
  cwd: '/test/cwd',
});

skipInit: true 用於外部控制啟動流程（搭配 cwd prop）。

renderWithWorkspace — 多 session 測試

整個 WorkspaceLayout 入口（含 project list / tab bar）。