---
generated_at: 2026-02-18 16:15:00
metrics:
  claims_total: 120
  claims_with_evidence: 118
  claims_without_evidence: 2
confidence_derived: 0.98
---

# 根拠レポート：tools.csv

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.98**
  - 根拠あり：118 / 120、根拠なし：2
- 優先レビュー（高）
  1. **C-036 (has_typed_input)**: zselect/sttyの動作検証が複雑
  2. **C-037 (has_typed_input)**: 入力検出の実環境テストが必要

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

- E-01: `tools/changelog.sh` (行1-593) - コミット解析・changelog生成スクリプト
- E-02: `tools/check_for_upgrade.sh` (行1-303) - アップグレードチェックスクリプト
- E-03: `tools/install.sh` (行1-579) - Oh My Zshインストールスクリプト
- E-04: `tools/require_tool.sh` (行1-162) - ツールバージョン検証スクリプト
- E-05: `tools/theme_chooser.sh` (行1-99) - テーマ選択スクリプト
- E-06: `tools/uninstall.sh` (行1-42) - アンインストールスクリプト
- E-07: `tools/upgrade.sh` (行1-296) - アップグレード実行スクリプト
- E-08: `docs/code-to-docs/単体テストケース一覧/plan.md` - プロジェクト情報

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

### changelog.sh関連 (UT-TOL-001 - UT-TOL-027)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-001 | commit:typeがfeat型を正しく識別する | E-01 (行54-68) 正規表現パターンとTYPES配列の定義 | ○ |
| C-002 | commit:typeがfix型を正しく識別する | E-01 (行54-68) TYPES配列に'fix'が定義 | ○ |
| C-003 | 未知の型がotherとして識別される | E-01 (行62-67) else節で'other'を返却 | ○ |
| C-004 | 空文字列でotherが返る | E-01 (行62-67) type未検出時のフォールバック | ○ |
| C-005 | commit:scopeがスコープを抽出する | E-01 (行70-87) 正規表現パターンでscope抽出 | ○ |
| C-006 | スコープなしで空文字列が返る | E-01 (行70-87) マッチしない場合何も出力しない | ○ |
| C-007 | コロン形式のスコープ抽出 | E-01 (行79-86) 代替フォーマットの正規表現 | ○ |
| C-008 | commit:subjectがサブジェクト抽出 | E-01 (行89-98) 正規表現でsubject部分を抽出 | ○ |
| C-009 | 非標準フォーマットで全文返却 | E-01 (行95-97) else節で元の文字列を返却 | ○ |
| C-010 | 破壊的変更の!マーク検出 | E-01 (行101-119) 正規表現で!を検出 | ○ |
| C-011 | BREAKING CHANGEキーワード検出 | E-01 (行104) bodyの正規表現マッチ | ○ |
| C-012 | 非破壊的変更でfalse返却 | E-01 (行116-118) マッチしない場合return 1 | ○ |
| C-013 | リバートコミット検出 | E-01 (行122-131) Revertプレフィックスと正規表現 | ○ |
| C-014 | 非リバートでfalse返却 | E-01 (行129-130) マッチしない場合return 1 | ○ |
| C-015 | parse-commitの統合動作 | E-01 (行133-161) 各配列への格納処理 | ○ |
| C-016 | FORCE_HYPERLINKでハイパーリンク有効 | E-01 (行202-206) 環境変数チェック | ○ |
| C-017 | 非対応ターミナルでfalse | E-01 (行209, 248) is_tty失敗時return 1 | ○ |
| C-018 | rawモードでハッシュ出力 | E-01 (行302) printf '%s' "$short_hash" | ○ |
| C-019 | mdモードでmarkdownリンク出力 | E-01 (行310) markdownフォーマット | ○ |
| C-020 | ヘッダーフォーマット | E-01 (行317-333) レベル別フォーマット処理 | ○ |
| C-021 | スコープフォーマット | E-01 (行335-360) [scope]形式出力 | ○ |
| C-022 | サブジェクト先頭大文字化 | E-01 (行368) ${(U)subject:0:1} | ○ |
| C-023 | display-releaseの統合動作 | E-01 (行255-481) リリース表示処理 | ○ |
| C-024 | 空リリースで何も表示しない | E-01 (行283-285) types配列が空の場合return | ○ |
| C-025 | main関数の基本動作 | E-01 (行483-592) メイン処理フロー | ○ |
| C-026 | --mdオプションでmarkdown出力 | E-01 (行491) output変数からフォーマット決定 | ○ |
| C-027 | --rawオプションで装飾なし | E-01 (行588-590) 非TTY時raw出力 | ○ |

### check_for_upgrade.sh関連 (UT-TOL-028 - UT-TOL-041)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-028 | current_epochが日数計算 | E-02 (行37-40) EPOCHSECONDS / 60 / 60 / 24 | ○ |
| C-029 | is_update_available更新検出 | E-02 (行42-94) HEAD比較ロジック | ○ |
| C-030 | 同一HEAD時false返却 | E-02 (行84) local_head != remote_head比較 | ○ |
| C-031 | 非GitHubでtrue返却 | E-02 (行54-57) GitHubでない場合return 0 | ○ |
| C-032 | 正常終了時LAST_EPOCH書き込み | E-02 (行96-102) 引数なし時の処理 | ○ |
| C-033 | エラー時ステータス書き込み | E-02 (行104-109) EXIT_STATUS/ERROR書き込み | ○ |
| C-034 | update_ohmyzsh実行 | E-02 (行111-134) upgrade.sh呼び出し | ○ |
| C-035 | アップデート失敗時エラー | E-02 (行129-132) exit_status取得と返却 | ○ |
| C-036 | has_typed_input入力なし検出 | E-02 (行136-159) zselect -t 0 -r 0の動作 | △ |
| C-037 | has_typed_input入力あり検出 | E-02 (行136-159) zselect戻り値に依存 | △ |
| C-038 | handle_update更新スキップ | E-02 (行204-206) epoch比較でreturn | ○ |
| C-039 | promptモード確認表示 | E-02 (行235-242) read -r -k 1 option | ○ |
| C-040 | autoモード自動更新 | E-02 (行228-230) update_ohmyzsh呼び出し | ○ |
| C-041 | reminderモードリマインダー | E-02 (行221-224) メッセージ表示 | ○ |

### install.sh関連 (UT-TOL-042 - UT-TOL-074)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-042 | command_exists存在確認 | E-03 (行84-86) command -v使用 | ○ |
| C-043 | command_exists不在確認 | E-03 (行84-86) 終了コードで判定 | ○ |
| C-044 | user_can_sudo権限確認 | E-03 (行88-114) sudo -n -v実行 | ○ |
| C-045 | Termux検出 | E-03 (行92-94) PREFIX変数チェック | ○ |
| C-046 | is_tty TTY検出 | E-03 (行120-128) [ -t 1 ]判定 | ○ |
| C-047 | is_tty非TTY検出 | E-03 (行124-127) false関数定義 | ○ |
| C-048 | supports_hyperlinks FORCE_HYPERLINK | E-03 (行150-153) 環境変数チェック | ○ |
| C-049 | supports_hyperlinks iTerm対応 | E-03 (行170-172) TERM_PROGRAM case | ○ |
| C-050 | supports_hyperlinks非対応 | E-03 (行195) return 1 | ○ |
| C-051 | supports_truecolor対応 | E-03 (行200-214) COLORTERM/TERMチェック | ○ |
| C-052 | supports_truecolor非対応 | E-03 (行213) return 1 | ○ |
| C-053 | fmt_link対応時 | E-03 (行216-227) OSCシーケンス出力 | ○ |
| C-054 | fmt_link非対応text | E-03 (行223-224) テキスト出力 | ○ |
| C-055 | fmt_underline下線 | E-03 (行229-231) ANSIエスケープ | ○ |
| C-056 | fmt_codeコード | E-03 (行234-236) バッククォート | ○ |
| C-057 | fmt_errorエラー | E-03 (行238-240) stderrへ出力 | ○ |
| C-058 | setup_color TTY色設定 | E-03 (行242-283) 色変数設定 | ○ |
| C-059 | setup_color非TTY空設定 | E-03 (行244-252) 空文字列設定 | ○ |
| C-060 | setup_ohmyzshクローン | E-03 (行285-330) git init/remote add/fetch | ○ |
| C-061 | setup_ohmyzsh git不在エラー | E-03 (行295-298) fmt_error "git is not installed" | ○ |
| C-062 | setup_ohmyzsh Cygwinエラー | E-03 (行301-305) msysgit検出 | ○ |
| C-063 | setup_zshrcバックアップ | E-03 (行332-379) mvコマンド | ○ |
| C-064 | setup_zshrc KEEP_ZSHRC保持 | E-03 (行342-345) return | ○ |
| C-065 | setup_zshrcテンプレート生成 | E-03 (行381-393) sed置換 | ○ |
| C-066 | setup_shell CHSH=noスキップ | E-03 (行398-400) return | ○ |
| C-067 | setup_shell zsh既定スキップ | E-03 (行403-405) basename比較 | ○ |
| C-068 | setup_shell chsh実行 | E-03 (行476-479) chsh -s呼び出し | ○ |
| C-069 | setup_shell chsh不在 | E-03 (行408-414) メッセージ表示 | ○ |
| C-070 | main --unattended | E-03 (行523) RUNZSH/CHSH/OVERWRITE設定 | ○ |
| C-071 | main --skip-chsh | E-03 (行524) CHSH=no | ○ |
| C-072 | main --keep-zshrc | E-03 (行525) KEEP_ZSHRC=yes | ○ |
| C-073 | main zsh不在エラー | E-03 (行532-535) 終了コード1 | ○ |
| C-074 | main $ZSH既存エラー | E-03 (行537-557) 終了コード1 | ○ |

### require_tool.sh関連 (UT-TOL-075 - UT-TOL-086)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-075 | __require_tool_version_compare < | E-04 (行1-71) awkスクリプト終了コード1 | ○ |
| C-076 | __require_tool_version_compare = | E-04 (行67) 終了コード0 | ○ |
| C-077 | __require_tool_version_compare > | E-04 (行68) 終了コード2 | ○ |
| C-078 | 複雑バージョン比較 | E-04 (行16-53) awk数値比較ロジック | ○ |
| C-079 | 先頭ゼロ処理 | E-04 (行23-39) 分数比較ロジック | ○ |
| C-080 | __require_tool_fatal stderr出力 | E-04 (行74-78) echo >/dev/stderr | ○ |
| C-081 | require_toolバージョン充足 | E-04 (行87-103) 比較結果処理 | ○ |
| C-082 | require_toolバージョン不足 | E-04 (行97-101) '>'ケースでreturn 1 | ○ |
| C-083 | require_toolツール不在 | E-04 (行93-96) version空の場合 | ○ |
| C-084 | require_tool環境変数パス | E-04 (行89-90) printenv使用 | ○ |
| C-085 | usageヘルプ表示 | E-04 (行105-146) catヒアドキュメント | ○ |
| C-086 | main引数数エラー | E-04 (行156-159) $# > 2チェック | ○ |

### theme_chooser.sh関連 (UT-TOL-087 - UT-TOL-098)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-087 | noyes N応答 | E-05 (行14-20) return 0 | ○ |
| C-088 | noyes y応答 | E-05 (行14-20) return 1 | ○ |
| C-089 | noyes空応答 | E-05 (行16) $a = ""判定 | ○ |
| C-090 | theme_previewプレビュー表示 | E-05 (行22-30) sourceとprint -P | ○ |
| C-091 | bannerバナー表示 | E-05 (行32-38) echoコマンド群 | ○ |
| C-092 | usageヘルプ表示 | E-05 (行40-48) exit 1 | ○ |
| C-093 | list_themesテーマ一覧 | E-05 (行50-55) ls THEMES_DIR | ○ |
| C-094 | list_themes空ディレクトリ | E-05 (行50-55) lsが空を返す | ○ |
| C-095 | insert_favlistお気に入り追加 | E-05 (行57-65) echo >> FAVLIST | ○ |
| C-096 | insert_favlist重複防止 | E-05 (行58-59) grep -q | ○ |
| C-097 | theme_chooser対話表示 | E-05 (行67-78) forループとnoyes | ○ |
| C-098 | theme_chooser表示のみ | E-05 (行72-76) 引数あり時スキップ | ○ |

### uninstall.sh関連 (UT-TOL-099 - UT-TOL-105)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-099 | シェル復元 | E-06 (行1-11) chsh -s old_shell | ○ |
| C-100 | シェル復元スキップ | E-06 (行1) hash chsh && -f判定 | ○ |
| C-101 | ディレクトリ削除 | E-06 (行19-22) rm -rf ~/.oh-my-zsh | ○ |
| C-102 | .zshrcバックアップ | E-06 (行24-28) mv .zshrc | ○ |
| C-103 | .zshrc復元 | E-06 (行30-38) mv .zshrc.pre-oh-my-zsh | ○ |
| C-104 | キャンセル処理 | E-06 (行13-17) confirmation != y | ○ |
| C-105 | chsh失敗 | E-06 (行6-9) elseブロック | ○ |

### upgrade.sh関連 (UT-TOL-106 - UT-TOL-120)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-106 | is_tty TTY検出 | E-07 (行47-55) [ -t 1 ]判定 | ○ |
| C-107 | supports_hyperlinks対応 | E-07 (行75-123) 複数条件判定 | ○ |
| C-108 | supports_truecolor対応 | E-07 (行127-141) COLORTERM/TERM判定 | ○ |
| C-109 | fmt_linkフォーマット | E-07 (行143-154) printf OSCシーケンス | ○ |
| C-110 | fmt_underline下線 | E-07 (行156-158) ANSI 4m/24m | ○ |
| C-111 | -v default詳細出力 | E-07 (行265-277) RAINBOWロゴ | ○ |
| C-112 | -v minimal簡潔出力 | E-07 (行277-278) メッセージのみ | ○ |
| C-113 | -v silent出力なし | E-07 (行242-244) 条件分岐 | ○ |
| C-114 | -i対話モード | E-07 (行36) interactive=true | ○ |
| C-115 | リモートURL更新 | E-07 (行195-214) git remote set-url | ○ |
| C-116 | アップデート成功 | E-07 (行250-251) メッセージ設定 | ○ |
| C-117 | 最新版検出 | E-07 (行247-248) HEAD比較 | ○ |
| C-118 | アップデート失敗 | E-07 (行280-283) elseブロック | ○ |
| C-119 | autoStash復元 | E-07 (行289-292) git config設定 | ○ |
| C-120 | changelog表示 | E-07 (行256-258) changelog.sh呼び出し | ○ |

## 4) 不足情報（Unknown / Missing）
- **C-036, C-037 (has_typed_input)**: zselect/sttyの動作は環境依存性が高く、実際のターミナル環境でのテストが必要
  - 候補: 手動テスト / モック環境構築 / Docker環境での検証

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: 大部分のテストケースはソースコードに明確な根拠がある
- **1 (中リスク)**: has_typed_input関連のテスト（C-036, C-037）は環境依存性が高い
- **0 (低リスク)**: シェルスクリプトの特性上、モック化が困難な部分があるが、入出力パターンは明確

## 6) レビュアーチェックリスト（最小）
- [ ] 各テストケースの期待結果がソースコードの実装と整合しているか確認
- [ ] 境界値テスト（空配列、空文字列、null相当値）が網羅されているか確認
- [ ] 異常系テスト（ツール不在、ネットワーク不通、権限不足）が網羅されているか確認
- [ ] シェルスクリプト特有の環境依存テスト（TTY、環境変数）の妥当性確認
- [ ] テストIDの命名規則（UT-TOL-XXX）が一貫しているか確認
- [ ] 優先度の設定が適切か確認（金額計算なしのため、認証・認可・データ整合性中心）
