---
generated_at: 2026-03-01 10:30:00
metrics:
  claims_total: 96
  claims_with_evidence: 96
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：synthetic モジュール単体テストケース一覧

## 本レポートについて

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

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

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

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

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

---

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

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

- E-01: `src/synthetic/main.zig` - モジュールのエントリーポイント、エクスポート定義
- E-02: `src/synthetic/Generator.zig` - Generatorインターフェース定義（init, next関数）
- E-03: `src/synthetic/Bytes.zig` - バイト生成ロジック（generateAlphabet, newAlphabet, atLeast, atMost, write, next, format, generator関数）
- E-04: `src/synthetic/Utf8.zig` - UTF-8生成ロジック（Utf8Len enum, generator, next関数）、既存テスト"utf8"
- E-05: `src/synthetic/Osc.zig` - OSCシーケンス生成ロジック（ValidKind, InvalidKind enum, generator, next, nextUnwrapped, nextUnwrappedValidExact, nextUnwrappedInvalidExact, chooseValidity, bytes, checkKvAlphabet, checkOscAlphabet関数）、既存テスト"OSC generator", "OSC generator valid", "OSC generator invalid"
- E-06: `src/synthetic/cli.zig` - CLIエントリーポイント（Action enum, Struct関数, main, mainAction, mainActionImpl関数）
- E-07: `src/synthetic/cli/Ascii.zig` - ASCII CLIハンドラ（Options struct, create, destroy, run, checkAsciiAlphabet関数）、既存テスト"Ascii"
- E-08: `src/synthetic/cli/Osc.zig` - OSC CLIハンドラ（Options struct, create, destroy, run関数）、既存テスト"Osc"
- E-09: `src/synthetic/cli/Utf8.zig` - UTF-8 CLIハンドラ（Options struct, create, destroy, run関数）、既存テスト"Utf8"

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Generator.initはポインタと関数からGeneratorを生成する | E-02 (L18-37) | ○ |
| C-02 | Generator.initは非ポインタでassert失敗 | E-02 (L23) | ○ |
| C-03 | Generator.initは非単一要素ポインタでassert失敗 | E-02 (L24) | ○ |
| C-04 | Generator.initは非構造体ポインタでassert失敗 | E-02 (L25) | ○ |
| C-05 | Generator.nextはwriterにデータを書き込む | E-02 (L40-42) | ○ |
| C-06 | Generator.nextは書き込み失敗時にWriteFailedを返す | E-02 (L9, L40-42) | ○ |
| C-07 | Bytes.generateAlphabetはフィルタ関数でアルファベット生成 | E-03 (L21-37) | ○ |
| C-08-09 | Bytes.generateAlphabetの境界値（全マッチ/無マッチ） | E-03 (L21-37) | ○ |
| C-10 | Bytes.generatorはGeneratorを返す | E-03 (L39-41) | ○ |
| C-11-12 | Bytes.newAlphabetは新しいアルファベットで複製 | E-03 (L44-51) | ○ |
| C-13-14 | Bytes.atLeastは最小長を設定（上限キャップ含む） | E-03 (L55-62) | ○ |
| C-15-17 | Bytes.atMostは最大長を設定（境界値含む） | E-03 (L66-73) | ○ |
| C-18-24 | Bytes.write/next/formatのバイト書き込み動作 | E-03 (L75-104) | ○ |
| C-25 | Utf8.generatorはGeneratorを返す | E-04 (L40-42) | ○ |
| C-26-34 | Utf8.nextのUTF-8生成動作（各エンコード長、境界値） | E-04 (L44-93) | ○ |
| C-35 | Osc.generatorはGeneratorを返す | E-05 (L73-75) | ○ |
| C-36-40 | Osc.nextのOSCシーケンス生成（有効/無効、境界値） | E-05 (L90-119) | ○ |
| C-41-54 | Osc.nextUnwrappedValidExactの各ValidKind生成 | E-05 (L121-270) | ○ |
| C-55-56 | Osc.nextUnwrappedInvalidExactの各InvalidKind生成 | E-05 (L272-287) | ○ |
| C-57-58 | Osc.chooseValidityの有効/無効選択 | E-05 (L298-303) | ○ |
| C-59 | Osc.bytesはBytesを返す | E-05 (L289-294) | ○ |
| C-60-67 | checkKvAlphabet/checkOscAlphabetのフィルタ動作 | E-05 (L49-68) | ○ |
| C-68-75 | cli.zig Action enumとmainAction関数 | E-06 (L8-57) | ○ |
| C-76-84 | cli/Ascii.zigのcreate/destroy/run動作 | E-07 (L22-53) | ○ |
| C-85-90 | cli/Osc.zigのcreate/destroy/run動作 | E-08 (L26-67) | ○ |
| C-91-96 | cli/Utf8.zigのcreate/destroy/run動作 | E-09 (L13-43) | ○ |

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

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 全テストケースがソースコードに基づいている
- syntheticモジュールはベンチマーク・ファジング用のデータ生成ライブラリであり、直接的なセキュリティリスクは低い
- Generator.Errorのerror.WriteFailedは唯一許可されたエラー型であり、エラーハンドリングは限定的

## 6) レビュアーチェックリスト（最小）
- [ ] Generator.initの型チェック(assert)が実際のテストで検証可能か確認
- [ ] Bytes.writeのmin_len/max_len assertがテスト時にパニックを引き起こさないか確認
- [ ] Osc.nextのmax_len<3時のassertがテスト時にパニックを引き起こさないか確認
- [ ] UTF-8サロゲートハーフのスキップ処理が確率的に発生するためテストの再現性を確認
- [ ] 各CLIハンドラのrun関数が無限ループするため、テスト時のバッファサイズ設定が適切か確認
- [ ] 既存のZigテスト（test "utf8", test "OSC generator"等）との整合性を確認
