---
generated_at: 2026-02-24 15:30:00
metrics:
  claims_total: 166
  claims_with_evidence: 166
  claims_without_evidence: 0
confidence_derived: 1.00
---

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

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：166 / 166、根拠なし：0
- 優先レビュー（高）
  1. **該当なし**：すべてのテストケースにソースコードの根拠あり

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

### ソースコードファイル
- E-01: `packages/rag/src/errors.ts` - エラークラス定義
- E-02: `packages/rag/src/errors.test.ts` - 既存エラーテスト
- E-03: `packages/rag/src/chunker/line-chunker.ts` - 行チャンカー実装
- E-04: `packages/rag/src/chunker/line-chunker.test.ts` - 既存チャンカーテスト
- E-05: `packages/rag/src/chunker/types.ts` - チャンカー型定義
- E-06: `packages/rag/src/embedder/ai-sdk-embedder.ts` - AI SDK埋め込み実装
- E-07: `packages/rag/src/embedder/ai-sdk-embedder.test.ts` - 既存埋め込みテスト
- E-08: `packages/rag/src/embedder/profiles.ts` - 埋め込みプロファイル
- E-09: `packages/rag/src/embedder/profiles.test.ts` - 既存プロファイルテスト
- E-10: `packages/rag/src/embedder/types.ts` - 埋め込み型定義
- E-11: `packages/rag/src/embedder/gateway.ts` - Gateway埋め込み
- E-12: `packages/rag/src/embedder/openai.ts` - OpenAI埋め込み
- E-13: `packages/rag/src/embedder/google.ts` - Google埋め込み
- E-14: `packages/rag/src/embedder/not-implemented.ts` - 未実装埋め込み
- E-15: `packages/rag/src/ingest/pipeline.ts` - インジェストパイプライン
- E-16: `packages/rag/src/ingest/pipeline.test.ts` - 既存パイプラインテスト
- E-17: `packages/rag/src/ingest/version-tracker.ts` - バージョントラッカー
- E-18: `packages/rag/src/ingest/embedder.ts` - コンテンツ埋め込み
- E-19: `packages/rag/src/ingest/utils.ts` - インジェストユーティリティ
- E-20: `packages/rag/src/ingest/types.ts` - インジェスト型定義
- E-21: `packages/rag/src/chunk-store/postgres/postgres-chunk-store.ts` - PostgreSQLチャンクストア
- E-22: `packages/rag/src/chunk-store/postgres/utils.ts` - チャンクストアユーティリティ
- E-23: `packages/rag/src/chunk-store/postgres/utils.test.ts` - 既存ユーティリティテスト
- E-24: `packages/rag/src/chunk-store/types.ts` - チャンクストア型定義
- E-25: `packages/rag/src/chunk-store/column-mapping.ts` - カラムマッピング
- E-26: `packages/rag/src/query-service/postgres/index.ts` - PostgreSQLクエリサービス
- E-27: `packages/rag/src/query-service/types.ts` - クエリサービス型定義
- E-28: `packages/rag/src/query-service/column-mapping.ts` - クエリカラムマッピング
- E-29: `packages/rag/src/database/postgres/pool-manager.ts` - プールマネージャー
- E-30: `packages/rag/src/database/postgres/pgvector-registry.ts` - pgvector登録
- E-31: `packages/rag/src/database/types.ts` - データベース型定義
- E-32: `packages/rag/src/database/constants.ts` - データベース定数
- E-33: `packages/rag/src/utils/text.ts` - テキストユーティリティ
- E-34: `packages/rag/src/utils/text.test.ts` - 既存テキストテスト
- E-35: `packages/rag/src/internal/create-column-mapping.ts` - 汎用カラムマッピング
- E-36: `packages/rag/src/internal/column-mapping-utils.ts` - カラムマッピングユーティリティ
- E-37: `packages/rag/src/document-loader/types.ts` - ドキュメントローダー型定義

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

### エラー処理（errors.ts）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | RagError.toJSONでエラー情報がJSON形式で返却される | E-01 L28-38, E-02 | ○ |
| C-02 | ValidationError.fromZodErrorでZodErrorから変換される | E-01 L79-87, E-02 | ○ |
| C-03 | ValidationError.validationDetailsで詳細取得 | E-01 L59-75, E-02 | ○ |
| C-04 | zodErrorがundefinedで空配列 | E-01 L66-67 | ○ |
| C-05 | DatabaseError.connectionFailed | E-01 L108-115, E-02 | ○ |
| C-06 | DatabaseError.queryFailed | E-01 L117-128, E-02 | ○ |
| C-07 | DatabaseError.transactionFailed | E-01 L130-141, E-02 | ○ |
| C-08 | EmbeddingError.apiError | E-01 L167-172, E-02 | ○ |
| C-09 | EmbeddingError.apiError causeなし | E-01 L168-170 | ○ |
| C-10 | ConfigurationError.missingField | E-01 L195-200, E-02 | ○ |
| C-11 | ConfigurationError.invalidValue | E-01 L203-214, E-02 | ○ |
| C-12 | OperationError.invalidOperation | E-01 L235-247, E-02 | ○ |
| C-13-C-20 | DocumentLoaderError各種 | E-01 L255-359, E-02 | ○ |
| C-21-C-27 | isErrorCategory, isErrorCode, handleError | E-01 L375-414, E-02 | ○ |

### チャンカー（chunker/line-chunker.ts）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-28 | createLineChunker正常系 | E-03 L28-30 | ○ |
| C-29-C-32 | パラメータバリデーション | E-03 L33-44, E-04 | ○ |
| C-33-C-38 | chunk関数の動作 | E-03 L49-104, E-04 | ○ |

### 埋め込み（embedder/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-39-C-50 | createAiSdkEmbedder | E-06, E-07 | ○ |
| C-51-C-55 | createEmbedderFromProfile | E-08, E-09 | ○ |
| C-56-C-58 | Gateway関連 | E-11, E-09 | ○ |
| C-59-C-63 | OpenAI/Google/NotImplemented | E-12, E-13, E-14 | ○ |

### インジェスト（ingest/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-64-C-75 | createPipeline | E-15, E-16 | ○ |
| C-76-C-84 | createVersionTracker | E-17, E-16 | ○ |
| C-85-C-88 | embedContent | E-18 | ○ |
| C-89-C-96 | retryOperation, createBatches | E-19 | ○ |

### チャンクストア（chunk-store/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-97-C-111 | createPostgresChunkStore | E-21, E-23 | ○ |
| C-112-C-129 | utils関数群 | E-22, E-23 | ○ |
| C-130-C-133 | column-mapping | E-25 | ○ |

### クエリサービス（query-service/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-134-C-146 | createPostgresQueryService | E-26 | ○ |
| C-147 | QueryService column-mapping | E-28 | ○ |

### データベース（database/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-148-C-152 | PoolManager | E-29 | ○ |
| C-153-C-155 | pgvector-registry | E-30 | ○ |

### ユーティリティ（utils/, internal/）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-156-C-158 | replaceNullCharacters | E-33, E-34 | ○ |
| C-159-C-166 | column-mapping-utils | E-35, E-36 | ○ |

## 4) 不足情報（Unknown / Missing）
- **該当なし**
  - すべてのテストケースはソースコードの関数・メソッド・クラス定義に基づいて生成
  - 既存テストファイル（*.test.ts）を参照し、テスト観点を補強

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - すべてのテストケースにソースコード根拠あり
- 既存テストファイルが存在するモジュールは特に信頼度が高い:
  - `errors.test.ts`（エラー処理）
  - `line-chunker.test.ts`（チャンカー）
  - `ai-sdk-embedder.test.ts`（埋め込み）
  - `profiles.test.ts`（プロファイル）
  - `pipeline.test.ts`（パイプライン）
  - `utils.test.ts`（チャンクストアユーティリティ）
  - `text.test.ts`（テキストユーティリティ）

## 6) レビュアーチェックリスト（最小）
- [ ] エラークラス（errors.ts）のテストケースが各エラーコード・カテゴリを網羅しているか
- [ ] チャンカー（line-chunker.ts）の境界値テストが適切か
- [ ] 埋め込み関数のAPIエラーハンドリングが十分か
- [ ] インジェストパイプラインの差分処理（バージョントラッカー）が正しく検証されているか
- [ ] PostgreSQLチャンクストアのトランザクション処理テストが適切か
- [ ] クエリサービスの類似度閾値フィルタリングが検証されているか
- [ ] NULバイト置換（replaceNullCharacters）の既存テストと整合しているか
