test-bridge

name: test-bridge description: Bridge Server (TypeScript) のテスト実行・型チェック・テスト記述ガイド disable-model-invocation: true allowed-tools: Bash(npx:), Bash(npm:), Read, Glob, Grep

Bridge Server テスト

実行手順

以下を順番に実行し、全てパスすることを確認する。

1. ユニットテスト

npm run test:bridge

特定ファイルのみ:

cd packages/bridge && npx vitest run src/<filename>.test.ts

ウォッチモード (開発中):

cd packages/bridge && npx vitest src/<filename>.test.ts

2. TypeScript 型チェック

npx tsc --noEmit -p packages/bridge/tsconfig.json

テストファイル (*.test.ts) と vitest.config.ts は tsconfig.json の exclude に入っているため、型チェック対象外。

3. カバレッジ (任意)

npm run test:bridge:coverage

テスト記述規約

ファイル配置・命名

• テストファイルはソースと同じディレクトリに <module>.test.ts として配置
  • 例: src/parser.ts → src/parser.test.ts
• vitest.config.ts の include パターン: src/**/*.test.ts

import

import { describe, it, expect } from "vitest";

• vitest からのみ import する (jest の互換 API は使わない)
• テスト対象モジュールは .js 拡張子で import する (NodeNext moduleResolution)
  • 例: import { parseRule } from "./claude-process.js";

テスト構造

describe("関数名 or クラス名", () => {
  it("動作の説明 (英語)", () => {
    expect(actual).toBe(expected);
  });
});

• describe でテスト対象の関数/クラス単位にグルーピング
• it の説明は英語で、三人称現在形 ("returns null for empty string")
• 1つの it で1つの振る舞いを検証する

テスト対象の方針

• 純粋関数・ロジック中心にテストする (高ROI)
• プロセスspawn, ファイルシステム, WebSocket等の外部依存は対象外
• 現在テスト対象のモジュール:
  • parser.ts — parseClaudeEvent, claudeEventToServerMessage, parseClientMessage, normalizeToolResultContent
  • claude-process.ts — parseRule, matchesSessionRule, buildSessionRule, toolNeedsApproval, ACCEPT_EDITS_AUTO_APPROVE
  • image-store.ts — ImageStore.extractImagePaths

新しいテスト追加時

1. export されている純粋関数があればテスト追加を検討
2. internal関数をテストしたい場合は export に変更する (テスト可能性のための export は OK)
3. テスト追加後は型チェックが通ること (npx tsc --noEmit) も確認