---
generated_at: 2026-02-24 19:30:00
metrics:
  claims_total: 78
  claims_with_evidence: 78
  claims_without_evidence: 0
confidence_derived: 1.00
---

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

## 本レポートについて

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

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

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

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

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

---

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

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

- E-01: `packages/cli/oas/medusa-oas-cli/src/command-oas.ts` - OASコマンド定義ファイル
- E-02: `packages/cli/oas/medusa-oas-cli/src/command-docs.ts` - Docsコマンド定義ファイル
- E-03: `packages/cli/oas/medusa-oas-cli/src/index.ts` - メインエントリポイント
- E-04: `packages/cli/oas/medusa-oas-cli/src/types.ts` - 型定義ファイル
- E-05: `packages/cli/oas/medusa-oas-cli/src/utils/yaml-utils.ts` - YAMLユーティリティ
- E-06: `packages/cli/oas/medusa-oas-cli/src/utils/json-utils.ts` - JSONユーティリティ
- E-07: `packages/cli/oas/medusa-oas-cli/src/utils/fs-utils.ts` - ファイルシステムユーティリティ
- E-08: `packages/cli/oas/medusa-oas-cli/src/utils/merge-oas.ts` - OASマージユーティリティ
- E-09: `packages/cli/oas/medusa-oas-cli/src/utils/combine-oas.ts` - OAS結合ユーティリティ
- E-10: `packages/cli/oas/medusa-oas-cli/src/utils/circular-patch-utils.ts` - 循環参照パッチユーティリティ

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

### command-oas.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | getCommand関数がCommandオブジェクトを返却する | E-01 (L52-61) | ○ |
| C-02 | コマンド名が'oas'である | E-01 (L24, L53) | ○ |
| C-03 | 7つのオプションが設定されている | E-01 (L28-50) | ○ |
| C-04 | adminタイプでOASが生成される | E-01 (L75, L114-117) | ○ |
| C-05 | storeタイプでOASが生成される | E-01 (L75, L114-117) | ○ |
| C-06 | combinedタイプでOASが結合される | E-01 (L105-112) | ○ |
| C-07 | dryRunでファイル出力がスキップされる | E-01 (L70, L130-133) | ○ |
| C-08 | 追加パスでカスタムOASがマージされる | E-01 (L79-86, L119-127) | ○ |
| C-09 | ベースファイルが適用される | E-01 (L88-93, L121-123) | ○ |
| C-10 | localオプションでローカルファイル使用 | E-01 (L73, L106-117) | ○ |
| C-11 | --pathsにディレクトリ以外でエラー | E-01 (L82-85) | ○ |
| C-12 | --baseにファイル以外でエラー | E-01 (L89-92) | ○ |
| C-13 | 無効OASでforceなしの場合終了 | E-01 (L199-212) | ○ |
| C-14 | forceで無効OASでも出力 | E-01 (L202, L209-211) | ○ |

### command-docs.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-15 | getCommand関数がCommandオブジェクトを返却する | E-02 (L79-88) | ○ |
| C-16 | コマンド名が'docs'である | E-02 (L42, L80) | ○ |
| C-17 | 9つのオプションが設定されている | E-02 (L46-77) | ○ |
| C-18 | OASファイルからドキュメント生成 | E-02 (L93-175) | ○ |
| C-19 | splitオプションでマルチファイル出力 | E-02 (L98, L162-164) | ○ |
| C-20 | cleanオプションで事前削除 | E-02 (L97, L138-141) | ○ |
| C-21 | htmlオプションでHTML生成 | E-02 (L100, L170-173) | ○ |
| C-22 | previewオプションでプレビュー起動 | E-02 (L99, L158-161) | ○ |
| C-23 | カスタム設定ファイルのマージ | E-02 (L105-117, L130-135) | ○ |
| C-24 | dryRunでファイル出力スキップ | E-02 (L101, L149-157) | ○ |
| C-25 | --configにファイル以外でエラー | E-02 (L108-111) | ○ |
| C-26 | --configに不正拡張子でエラー | E-02 (L112-116) | ○ |
| C-27 | mergeConfig関数で設定マージ | E-02 (L193-209) | ○ |
| C-28 | 配列値の連結処理 | E-02 (L204-206) | ○ |
| C-29 | createTmpConfig関数で一時設定作成 | E-02 (L211-222) | ○ |
| C-30 | プラグインパスの絶対パス変換 | E-02 (L216-219) | ○ |

### index.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-31 | getBaseCommand関数がCommandオブジェクトを返却する | E-03 (L26-36) | ○ |
| C-32 | コマンド名が'medusa-oas'である | E-03 (L28) | ○ |
| C-33 | helpOptionがfalse | E-03 (L34) | ○ |
| C-34 | サブコマンドの追加 | E-03 (L13, L18) | ○ |

### yaml-utils.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-35 | readYaml関数でYAML読み込み | E-05 (L4-7) | ○ |
| C-36 | 存在しないファイルでエラー | E-05 (L5) fs.readFile実装による | ○ |
| C-37 | 無効YAML形式でエラー | E-05 (L6) yaml.load実装による | ○ |
| C-38 | writeYaml関数でYAML書き込み | E-05 (L9-14) | ○ |
| C-39 | writeYamlFromJson関数でJSON-YAML変換書き込み | E-05 (L16-22) | ○ |
| C-40 | jsonObjectToYamlString関数でJSON-YAML文字列変換 | E-05 (L24-26) | ○ |
| C-41 | 空オブジェクトの処理 | E-05 (L25) yaml.dump実装による | ○ |
| C-42 | jsonFileToYamlFile関数でファイル変換 | E-05 (L28-33) | ○ |

### json-utils.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-43 | readJson関数でJSON読み込み | E-06 (L3-6) | ○ |
| C-44 | 存在しないファイルでエラー | E-06 (L4) fs.readFile実装による | ○ |
| C-45 | 無効JSON形式でエラー | E-06 (L5) JSON.parse実装による | ○ |
| C-46 | writeJson関数でJSON書き込み | E-06 (L8-14) | ○ |

### fs-utils.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-47 | isFile関数でファイル判定 | E-07 (L5-12) | ○ |
| C-48 | ディレクトリの場合false | E-07 (L7) isFile()メソッドによる | ○ |
| C-49 | 存在しないパスでfalse | E-07 (L8-10) | ○ |
| C-50 | exists関数で存在判定true | E-07 (L14-21) | ○ |
| C-51 | 存在しないパスでfalse | E-07 (L18-20) | ○ |
| C-52 | getTmpDirectory関数で一時ディレクトリ作成 | E-07 (L23-29) | ○ |
| C-53 | RUNNER_TEMP環境変数の使用 | E-07 (L27) | ○ |

### merge-oas.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-54 | mergeBaseIntoOAS関数で基本プロパティ置換 | E-08 (L10-16) | ○ |
| C-55 | タグのマージと連結 | E-08 (L17-38) | ○ |
| C-56 | パスのマージ | E-08 (L42) | ○ |
| C-57 | コンポーネントのマージ | E-08 (L46-69) | ○ |
| C-58 | コンポーネントなし時のスキップ | E-08 (L46-48) | ○ |
| C-59 | mergePathsAndSchemasIntoOAS関数でパスマージ | E-08 (L79) | ○ |
| C-60 | スキーママージ | E-08 (L84-92) | ○ |
| C-61 | コンポーネント初期化 | E-08 (L85-90) | ○ |

### combine-oas.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-62 | combineOAS関数でOAS結合 | E-09 (L4-67) | ○ |
| C-63 | パスの統合 | E-09 (L34) | ○ |
| C-64 | タグの統合 | E-09 (L38-40) | ○ |
| C-65 | コンポーネントの統合 | E-09 (L44-63) | ○ |
| C-66 | タグへのプレフィックス付与 | E-09 (L85-88, L106-109) | ○ |
| C-67 | operationIdへのプレフィックス付与 | E-09 (L93-98) | ○ |
| C-68 | prepareOASForCombine関数でOAS準備 | E-09 (L69-112) | ○ |
| C-69 | getPrefixedTagName関数 | E-09 (L114-116) | ○ |
| C-70 | getPrefixedOperationId関数 | E-09 (L118-120) | ○ |

### circular-patch-utils.ts 関連テストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-71 | getCircularReferences関数で循環参照検出 | E-10 (L6-25) | ○ |
| C-72 | 循環参照なしで空配列 | E-10 (L24) | ○ |
| C-73 | 重複循環参照の除去 | E-10 (L20) | ○ |
| C-74 | getCircularPatchRecommendation関数でパッチ推奨生成 | E-10 (L27-77) | ○ |
| C-75 | 配列プロパティの循環参照処理 | E-10 (L46-49, L55-57) | ○ |
| C-76 | 空リストで空オブジェクト | E-10 (L69-76) filterとmap処理による | ○ |
| C-77 | formatHintRecommendation関数でYAML形式フォーマット | E-10 (L79-85) | ○ |
| C-78 | 空推奨の処理 | E-10 (L82-84) | ○ |

## 4) 不足情報（Unknown / Missing）
- なし - すべてのテストケースはソースコードから直接導出されています

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - すべてのテストケースにソースコードからの明確な根拠あり

## 6) レビュアーチェックリスト（最小）
- [ ] テストケースがソースコード内の全関数/メソッドをカバーしているか確認
- [ ] 正常系/異常系/境界値のバランスが適切か確認
- [ ] 優先度の設定が適切か確認
- [ ] 入力値と期待結果の記述が十分に具体的か確認
- [ ] 外部依存（OpenAPIParser, swagger-inline, Redocly CLI等）に関するモック戦略の検討
