# タスク指示書

[nrslib]

タスク指示書

目的

現行コードベースを広く精査し、不足している単体テストを追加して、回帰検知力を実用レベルまで引き上げる。

作業項目

1. テストギャップ分析（優先度: 高）

• 対象モジュール:
  • src/ 全体（特に分岐・状態遷移・エラー処理を持つモジュール）
  • src/__tests__/ 全体
• 作業内容:
  • 実装コードと既存テストを突き合わせ、未カバー観点を抽出
  • 正常系・異常系・境界値・エッジケースで不足を分類
  • 既存パターン（モック、ヘルパー、命名）を踏襲する方針を確定

2. 高リスク領域の単体テスト追加（優先度: 高）

• 対象モジュール:
  • src/ 内の主要ロジック（設定読み込み、分岐ルール、状態更新、入出力変換）
  • 対応する src/__tests__/*.test.ts
• 作業内容:
  • 不足ケースをテストとして追加
  • 1テスト1関心で Given-When-Then 構造を維持
  • 既存テストの可読性・一貫性を崩さない

3. 既存テストの補強・重複整理（優先度: 中）

• 対象モジュール:
  • 既存テストファイルのうち、意図不明・重複・カバレッジ不足がある箇所
• 作業内容:
  • カバレッジ価値の低い重複を整理し、欠落観点に置換
  • flaky になりやすいテストデータ/モックを安定化

4. 実行検証と回帰確認（優先度: 高）

• 対象モジュール:
  • テスト実行基盤（Vitest）
• 作業内容:
  • 追加したテストを含めてテストスイートを実行
  • 失敗時は原因を切り分け、テストコード側で修正
  • 実行結果をコマンド単位で記録

5. テスト資産の可視化（優先度: 低）

• 対象ファイル:
  • 必要に応じて docs/ またはテスト関連の説明箇所
• 作業内容:
  • 今回追加した観点（何を守るテストか）を簡潔に整理
  • 今後の追加指針になる形で残す

再現手順

1. 既存状態で npm run test を実行し、現状のテスト網を確認。
2. 対象コードと既存テストを読み、未カバー観点を抽出。
3. テストを追加後、npm run test を再実行。
4. 必要に応じて関連ファイル単位で npx vitest run <対象テストファイル> を実行して安定性を確認。

確認方法

1. 追加した単体テストが失敗ケースを適切に検知できる。
2. 既存テストを含めてテストスイートが通過する。
3. 追加テストが既存スタイル（命名、構造、モック方針）に整合している。
4. テスト追加内容と狙いが実施結果として明確に報告される。

制約（ユーザー明示）

• 現行コードを精査して不足している単体テストを追加すること。
• コード量が大きくても、妥協せず適切なテストを作成すること。

Open Questions

• 特になし（既存コードと既存テストの実測ベースで優先順位を決定して実装を進めること）。

[nrslib]

Addressed in PR #196 (commit 0e4e9e9). Release v0.11.0 (#197) でマージ済み。