---
generated_at: 2026-03-01 12:00:00
metrics:
  claims_total: 95
  claims_with_evidence: 95
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：jest-transform 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：95 / 95、根拠なし：0
- 優先レビュー（高）
  - なし（全てのテストケースはソースコードに基づいて生成）

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `packages/jest-transform/src/ScriptTransformer.ts` - メインのトランスフォーマークラス（1041行）
- E-02: `packages/jest-transform/src/enhanceUnexpectedTokenMessage.ts` - エラーメッセージ強化（71行）
- E-03: `packages/jest-transform/src/index.ts` - エクスポート定義（28行）
- E-04: `packages/jest-transform/src/runtimeErrorsAndWarnings.ts` - エラー/警告メッセージ生成（76行）
- E-05: `packages/jest-transform/src/shouldInstrument.ts` - インストルメント判定ロジック（124行）
- E-06: `packages/jest-transform/src/types.ts` - 型定義（160行）

## 3) Claims と根拠の対応（レビューの主戦場）

### ScriptTransformer クラス (UT-TRF-001 〜 UT-TRF-063)

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ScriptTransformer.constructor: ProjectCacheの作成・再利用 | E-01 (行93-112) | ○ |
| C-02 | ScriptTransformer.loadTransformers: トランスフォーマーのロード処理 | E-01 (行276-308) | ○ |
| C-03 | ScriptTransformer._getTransformer: トランスフォーマー取得 | E-01 (行310-339) | ○ |
| C-04 | ScriptTransformer.transformSource: 同期変換処理 | E-01 (行481-535) | ○ |
| C-05 | ScriptTransformer.transformSourceAsync: 非同期変換処理 | E-01 (行537-600) | ○ |
| C-06 | ScriptTransformer.transform: ファイル変換API | E-01 (行722-749) | ○ |
| C-07 | ScriptTransformer.transformAsync: 非同期ファイル変換API | E-01 (行694-720) | ○ |
| C-08 | ScriptTransformer.transformJson: JSON変換処理 | E-01 (行751-770) | ○ |
| C-09 | ScriptTransformer.requireAndTranspileModule: モジュールのトランスパイル | E-01 (行772-838) | ○ |
| C-10 | ScriptTransformer.shouldTransform: 変換判定 | E-01 (行840-845) | ○ |
| C-11 | ScriptTransformer._instrumentFile: コードインストルメンテーション | E-01 (行341-384) | ○ |
| C-12 | ScriptTransformer._buildTransformResult: 変換結果構築 | E-01 (行386-479) | ○ |
| C-13 | ScriptTransformer._getCacheKey: キャッシュキー生成 | E-01 (行142-174) | ○ |
| C-14 | ScriptTransformer._getCacheKeyAsync: 非同期キャッシュキー生成 | E-01 (行176-213) | ○ |
| C-15 | ScriptTransformer._createCachedFilename: キャッシュパス生成 | E-01 (行215-229) | ○ |
| C-16 | createScriptTransformer: ファクトリ関数 | E-01 (行1031-1040) | ○ |
| C-17 | createTranspilingRequire: トランスパイルrequire作成 | E-01 (行848-872) | ○ |
| C-18 | stripShebang: shebang除去関数 | E-01 (行880-888) | ○ |
| C-19 | writeCodeCacheFile: キャッシュ書き込み | E-01 (行897-900) | ○ |
| C-20 | readCodeCacheFile: キャッシュ読み込み | E-01 (行908-919) | ○ |
| C-21 | writeCacheFile: アトミック書き込み | E-01 (行927-942) | ○ |
| C-22 | readCacheFile: キャッシュ読み込み | E-01 (行955-987) | ○ |
| C-23 | getScriptCacheKey: スクリプトキャッシュキー生成 | E-01 (行989-992) | ○ |
| C-24 | calcIgnorePatternRegExp: 無視パターン生成 | E-01 (行994-1003) | ○ |
| C-25 | calcTransformRegExp: 変換パターン生成 | E-01 (行1005-1016) | ○ |
| C-26 | isTransformerFactory: 型ガード関数 | E-01 (行79-83) | ○ |
| C-27 | assertSyncTransformer: 同期トランスフォーマー検証 | E-01 (行1018-1027) | ○ |

### enhanceUnexpectedTokenMessage (UT-TRF-064 〜 UT-TRF-069)

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-28 | handlePotentialSyntaxError: エラー処理関数 | E-02 (行16-32) | ○ |
| C-29 | enhanceUnexpectedTokenMessage: エラーメッセージ強化 | E-02 (行34-70) | ○ |

### runtimeErrorsAndWarnings (UT-TRF-070 〜 UT-TRF-074)

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-30 | makeInvalidReturnValueError: 無効戻り値エラー | E-04 (行23-35) | ○ |
| C-31 | makeInvalidSourceMapWarning: ソースマップ警告 | E-04 (行37-49) | ○ |
| C-32 | makeInvalidSyncTransformerError: 同期トランスフォーマーエラー | E-04 (行51-63) | ○ |
| C-33 | makeInvalidTransformerError: トランスフォーマーエラー | E-04 (行65-75) | ○ |

### shouldInstrument (UT-TRF-075 〜 UT-TRF-092)

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-34 | shouldInstrument: インストルメント判定のメインロジック | E-05 (行32-123) | ○ |
| C-35 | getRegex: 正規表現キャッシュ関数 | E-05 (行19-30) | ○ |

### types (UT-TRF-093 〜 UT-TRF-095)

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-36 | SyncTransformer interface: 同期トランスフォーマー型定義 | E-06 (行67-99) | ○ |
| C-37 | AsyncTransformer interface: 非同期トランスフォーマー型定義 | E-06 (行101-133) | ○ |
| C-38 | TransformOptions interface: 変換オプション型定義 | E-06 (行54-65) | ○ |

## 4) 不足情報（Unknown / Missing）
- なし - 全てのテストケースはソースコードの実装に基づいて生成されています

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 全テストケースがソースコード解析に基づいている

### 補足事項
- プライベートメソッド（`_`プレフィックス付き）のテストケースも含まれているが、これらは間接的にパブリックAPIを通じてテスト可能
- 型定義のテストケース（UT-TRF-093〜095）は、TypeScriptの型システムによるコンパイル時検証で担保される

## 6) レビュアーチェックリスト（最小）
- [ ] ScriptTransformerのキャッシュ機構（ProjectCache）が正しく理解されているか
- [ ] トランスフォーマーのロード順序（loadTransformers → _getTransformer）が正しいか
- [ ] shouldInstrumentの除外条件が網羅されているか
- [ ] 非同期/同期変換の分岐条件が正しく記載されているか
- [ ] エラーハンドリング（SyntaxError、InvalidTransformerError等）のテストケースが十分か
