feat: add IL cache stats section to diff report

- Add ShouldIncludeILCacheStatsInReport (default false) to ConfigSettings
- Track _internalMisses in ILCache.TryGetILAsync; add GetReportStats()
  and ILCacheReportStats sealed record (Hits, Misses, HitRatePct, Stores,
  Evicted, Expired)
- Add REPORT_SECTION_IL_CACHE_STATS constant and WriteILCacheStatsSection
  to ReportGenerateService; insert between Summary and Warnings when
  ShouldIncludeILCacheStatsInReport=true and ilCache!=null
- Thread optional ILCache parameter through GenerateDiffReport /
  WriteDiffReport / WriteReportSections
- Wire scopedProvider.GetService<ILCache>() in ProgramRunner.GenerateReport
- Update ConfigSettingsTests (defaults + explicit-override test)
- Add 3 ReportGenerateServiceTests for default-false, null-cache, and
  section-present-with-correct-ordering scenarios
- Update README (EN+JA): config table row, example JSON, diff_report sample
- Update CHANGELOG (EN+JA): [Unreleased] Added entries

https://claude.ai/code/session_0174R4FzjudFBdynScKbhX6m

Author: claude

CHANGELOG.md

@@ -11,6 +11,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 #### Added
 
+- Added `ShouldIncludeILCacheStatsInReport` (default `false`) to [`ConfigSettings`](Models/ConfigSettings.cs). When `true` and the IL cache is active, [`ReportGenerateService`](Services/ReportGenerateService.cs) appends an `IL Cache Stats` section between `Summary` and `Warnings` in `diff_report.md`, showing hits, misses, hit-rate, stores, evicted, and expired counts. Also added `_internalMisses` tracking to [`ILCache`](Services/Caching/ILCache.cs) (miss counter now incremented on full cache miss), a `GetReportStats()` method, and the `ILCacheReportStats` sealed record. Added 3 unit tests to [`ReportGenerateServiceTests`](FolderDiffIL4DotNet.Tests/Services/ReportGenerateServiceTests.cs) and updated [`ConfigSettingsTests`](FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs), [README.md](README.md), and [CHANGELOG.md](CHANGELOG.md).
 - Expanded CLI options: `--help`/`-h` prints usage and exits with code `0` before any logger initialization; `--version` prints the application version and exits with code `0`; `--config <path>` loads a config file from an arbitrary path instead of the default `<exe>/config.json`; `--threads <N>` overrides `MaxParallelism` in [`ConfigSettings`](Models/ConfigSettings.cs) for the current run; `--no-il-cache` forces `EnableILCache = false` for the current run; `--skip-il` skips IL decompilation and IL diff entirely for .NET assemblies (new `SkipIL` property in [`ConfigSettings`](Models/ConfigSettings.cs), also respected by [`FileDiffService`](Services/FileDiffService.cs)); `--no-timestamp-warnings` suppresses timestamp-regression warnings. Unknown flags now produce exit code `2` with a descriptive message instead of silently being ignored. [`ConfigService.LoadConfigAsync()`](Services/ConfigService.cs) now accepts an optional `configFilePath` parameter. Added [`CliOptionsTests`](FolderDiffIL4DotNet.Tests/CliOptionsTests.cs) with 21 parser unit-test cases, and new integration tests in [`ProgramRunnerTests`](FolderDiffIL4DotNet.Tests/ProgramRunnerTests.cs) and [`ConfigServiceTests`](FolderDiffIL4DotNet.Tests/Services/ConfigServiceTests.cs).
 - Added [`ConfigSettings.Validate()`](Models/ConfigSettings.cs) and the companion `ConfigValidationResult` class; [`ConfigService.LoadConfigAsync()`](Services/ConfigService.cs) now calls `Validate()` immediately after deserialization and throws [`InvalidDataException`](https://learn.microsoft.com/en-us/dotnet/api/system.io.invaliddataexception?view=net-8.0) listing all invalid settings when validation fails, so misconfigured runs are caught at startup with a clear error message instead of failing silently or causing undefined behavior later. Validated constraints: `MaxLogGenerations >= 1`; `TextDiffParallelThresholdKilobytes >= 1`; `TextDiffChunkSizeKilobytes >= 1`; and `TextDiffChunkSizeKilobytes < TextDiffParallelThresholdKilobytes`. Added validation unit tests to [`ConfigSettingsTests`](FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs) (7 cases) and validation integration tests to [`ConfigServiceTests`](FolderDiffIL4DotNet.Tests/Services/ConfigServiceTests.cs) (5 cases).
 
@@ -250,6 +251,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 #### 追加
 
+- [`ConfigSettings`](Models/ConfigSettings.cs) に `ShouldIncludeILCacheStatsInReport`（既定値 `false`）を追加しました。`true` に設定し IL キャッシュが有効な場合、[`ReportGenerateService`](Services/ReportGenerateService.cs) は `diff_report.md` の `Summary` と `Warnings` の間に `IL Cache Stats` セクションを追記します（ヒット数・ミス数・ヒット率・保存数・退避数・期限切れ数）。あわせて [`ILCache`](Services/Caching/ILCache.cs) にミス数追跡フィールド `_internalMisses`（完全なキャッシュミスの際にインクリメント）と `GetReportStats()` メソッド、`ILCacheReportStats` レコードを追加しました。[`ReportGenerateServiceTests`](FolderDiffIL4DotNet.Tests/Services/ReportGenerateServiceTests.cs) に 3 件のユニットテストを追加し、[`ConfigSettingsTests`](FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs)、[README.md](README.md)、[CHANGELOG.md](CHANGELOG.md) を更新しました。
 - CLI オプションを拡充しました。`--help`/`-h` は使い方を表示してロガー初期化前にコード `0` で終了します。`--version` はアプリバージョンを表示してコード `0` で終了します。`--config <path>` はデフォルトの `<exe>/config.json` に代わり任意のパスから設定ファイルを読み込みます。`--threads <N>` は今回の実行に限り [`ConfigSettings`](Models/ConfigSettings.cs) の `MaxParallelism` を上書きします。`--no-il-cache` は今回の実行に限り `EnableILCache = false` に設定します。`--skip-il` は .NET アセンブリの IL 逆アセンブルと IL 差分比較をまるごとスキップします（[`ConfigSettings`](Models/ConfigSettings.cs) に新設した `SkipIL` プロパティとして保持され、[`FileDiffService`](Services/FileDiffService.cs) でも参照します）。`--no-timestamp-warnings` はタイムスタンプ逆転の警告を抑制します。未知のフラグを指定した場合は、これまで黙ってスルーされていた挙動を改め、説明付きで終了コード `2` を返します。[`ConfigService.LoadConfigAsync()`](Services/ConfigService.cs) にオプショナルな `configFilePath` パラメータを追加しました。[`CliOptionsTests`](FolderDiffIL4DotNet.Tests/CliOptionsTests.cs) にパーサー単体テスト 21 件を追加し、[`ProgramRunnerTests`](FolderDiffIL4DotNet.Tests/ProgramRunnerTests.cs) と [`ConfigServiceTests`](FolderDiffIL4DotNet.Tests/Services/ConfigServiceTests.cs) にも統合テストを追加しました。
 - [`ConfigSettings.Validate()`](Models/ConfigSettings.cs) と `ConfigValidationResult` クラスを追加しました。[`ConfigService.LoadConfigAsync()`](Services/ConfigService.cs) はデシリアライズ直後に `Validate()` を呼び出し、バリデーションが失敗した場合は全エラーを列挙した [`InvalidDataException`](https://learn.microsoft.com/ja-jp/dotnet/api/system.io.invaliddataexception?view=net-8.0) をスローします。これにより、設定不正な実行は後から無言で失敗したり未定義の振る舞いを引き起こしたりする代わりに、起動時に分かりやすいエラーメッセージとして検出されます。検証対象の制約: `MaxLogGenerations >= 1`、`TextDiffParallelThresholdKilobytes >= 1`、`TextDiffChunkSizeKilobytes >= 1`、`TextDiffChunkSizeKilobytes < TextDiffParallelThresholdKilobytes`。あわせて [`ConfigSettingsTests`](FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs) にバリデーション単体テスト（7 件）、[`ConfigServiceTests`](FolderDiffIL4DotNet.Tests/Services/ConfigServiceTests.cs) にバリデーション統合テスト（5 件）を追加しました。
 

FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs

@@ -68,7 +68,8 @@ public void JsonDeserialize_ExplicitOverrides_AreApplied()
                   "ILPrecomputeBatchSize": 512,
                   "OptimizeForNetworkShares": true,
                   "AutoDetectNetworkShares": false,
-                  "SkipIL": true
+                  "SkipIL": true,
+                  "ShouldIncludeILCacheStatsInReport": true
                 }
                 """;
 
@@ -98,6 +99,7 @@ public void JsonDeserialize_ExplicitOverrides_AreApplied()
             Assert.True(config.OptimizeForNetworkShares);
             Assert.False(config.AutoDetectNetworkShares);
             Assert.True(config.SkipIL);
+            Assert.True(config.ShouldIncludeILCacheStatsInReport);
         }
 
         [Fact]
@@ -252,6 +254,7 @@ private static void AssertMatchesDefaults(ConfigSettings config)
             Assert.False(config.OptimizeForNetworkShares);
             Assert.True(config.AutoDetectNetworkShares);
             Assert.False(config.SkipIL);
+            Assert.False(config.ShouldIncludeILCacheStatsInReport);
         }
     }
 }

FolderDiffIL4DotNet.Tests/Services/ReportGenerateServiceTests.cs

@@ -4,6 +4,7 @@
 using FolderDiffIL4DotNet.Common;
 using FolderDiffIL4DotNet.Models;
 using FolderDiffIL4DotNet.Services;
+using FolderDiffIL4DotNet.Services.Caching;
 using Xunit;
 
 namespace FolderDiffIL4DotNet.Tests.Services
@@ -410,6 +411,83 @@ public void GenerateDiffReport_WritesWarningsInSeverityOrder_WhenMd5MismatchAndT
                 reportText.IndexOf("files in `new` have older last-modified timestamps", StringComparison.Ordinal));
         }
 
+        [Fact]
+        public void GenerateDiffReport_ILCacheStats_NotIncludedByDefault()
+        {
+            var oldDir = Path.Combine(_rootDir, "old-ilcs-default");
+            var newDir = Path.Combine(_rootDir, "new-ilcs-default");
+            var reportDir = Path.Combine(_rootDir, "report-ilcs-default");
+            Directory.CreateDirectory(oldDir);
+            Directory.CreateDirectory(newDir);
+            Directory.CreateDirectory(reportDir);
+
+            var config = CreateConfig();
+            _service.GenerateDiffReport(
+                oldDir, newDir, reportDir,
+                appVersion: "test", elapsedTimeString: null, computerName: "test-host",
+                config);
+
+            var reportText = File.ReadAllText(Path.Combine(reportDir, "diff_report.md"));
+            Assert.DoesNotContain("## IL Cache Stats", reportText);
+        }
+
+        [Fact]
+        public void GenerateDiffReport_ILCacheStats_NotOutputWhenEnabled_ButCacheIsNull()
+        {
+            var oldDir = Path.Combine(_rootDir, "old-ilcs-null");
+            var newDir = Path.Combine(_rootDir, "new-ilcs-null");
+            var reportDir = Path.Combine(_rootDir, "report-ilcs-null");
+            Directory.CreateDirectory(oldDir);
+            Directory.CreateDirectory(newDir);
+            Directory.CreateDirectory(reportDir);
+
+            var config = CreateConfig();
+            config.ShouldIncludeILCacheStatsInReport = true;
+            _service.GenerateDiffReport(
+                oldDir, newDir, reportDir,
+                appVersion: "test", elapsedTimeString: null, computerName: "test-host",
+                config, ilCache: null);
+
+            var reportText = File.ReadAllText(Path.Combine(reportDir, "diff_report.md"));
+            Assert.DoesNotContain("## IL Cache Stats", reportText);
+        }
+
+        [Fact]
+        public void GenerateDiffReport_ILCacheStats_OutputBetweenSummaryAndWarnings_WhenEnabledWithCache()
+        {
+            var oldDir = Path.Combine(_rootDir, "old-ilcs-full");
+            var newDir = Path.Combine(_rootDir, "new-ilcs-full");
+            var reportDir = Path.Combine(_rootDir, "report-ilcs-full");
+            Directory.CreateDirectory(oldDir);
+            Directory.CreateDirectory(newDir);
+            Directory.CreateDirectory(reportDir);
+
+            var config = CreateConfig();
+            config.ShouldIncludeILCacheStatsInReport = true;
+            var ilCache = new ILCache(ilCacheDirectoryAbsolutePath: string.Empty);
+
+            _resultLists.RecordDiffDetail("some.dll", FileDiffResultLists.DiffDetailResult.MD5Mismatch);
+            _service.GenerateDiffReport(
+                oldDir, newDir, reportDir,
+                appVersion: "test", elapsedTimeString: null, computerName: "test-host",
+                config, ilCache);
+
+            var reportText = File.ReadAllText(Path.Combine(reportDir, "diff_report.md"));
+            Assert.Contains("## IL Cache Stats", reportText);
+            Assert.Contains("- Hits    :", reportText);
+            Assert.Contains("- Misses  :", reportText);
+            Assert.Contains("- Hit Rate:", reportText);
+            Assert.Contains("- Stores  :", reportText);
+            Assert.Contains("- Evicted :", reportText);
+            Assert.Contains("- Expired :", reportText);
+            // IL Cache Stats section must appear between Summary and Warnings
+            int summaryIdx = reportText.IndexOf("## Summary", StringComparison.Ordinal);
+            int ilCacheIdx = reportText.IndexOf("## IL Cache Stats", StringComparison.Ordinal);
+            int warningsIdx = reportText.IndexOf("## Warnings", StringComparison.Ordinal);
+            Assert.True(summaryIdx < ilCacheIdx);
+            Assert.True(ilCacheIdx < warningsIdx);
+        }
+
         private static ConfigSettings CreateConfig() => new()
         {
             IgnoredExtensions = new List<string>(),

Models/ConfigSettings.cs

@@ -88,6 +88,13 @@ public List<string> TextFileExtensions
         /// </summary>
         public bool ShouldIncludeIgnoredFiles { get; set; } = true;
 
+        /// <summary>
+        /// IL キャッシュの統計情報（ヒット数・ミス数・ヒット率など）を差分レポートに出力するかどうか。
+        /// true の場合、Summary セクションと Warnings セクションの間に IL Cache Stats セクションを追加します。
+        /// なお、IL キャッシュが無効（EnableILCache = false）の場合は本設定が true でもセクションは出力されません。
+        /// </summary>
+        public bool ShouldIncludeILCacheStatsInReport { get; set; } = false;
+
         /// <summary>
         /// IL全文を出力するか否か
         /// </summary>

ProgramRunner.cs

@@ -510,14 +510,16 @@ private static void GenerateReport(
             string computerName,
             ConfigSettings config)
         {
+            var ilCache = scopedProvider.GetService<ILCache>();
             scopedProvider.GetRequiredService<ReportGenerateService>().GenerateDiffReport(
                 executionContext.OldFolderAbsolutePath,
                 executionContext.NewFolderAbsolutePath,
                 executionContext.ReportsFolderAbsolutePath,
                 appVersion,
                 elapsedTimeString,
                 computerName,
-                config);
+                config,
+                ilCache);
         }
 
         private void PromptForExitKeyIfNeeded(CliOptions opts)

README.md

@@ -150,6 +150,14 @@ Example `diff_report.md` (trimmed):
 - Modified  : 2
 - Compared  : 5 (Old) vs 5 (New)
 
+## IL Cache Stats
+- Hits    : 42
+- Misses  : 8
+- Hit Rate: 84.0%
+- Stores  : 8
+- Evicted : 0
+- Expired : 0
+
 ## Warnings
 - **WARNING:** One or more files were classified as `MD5Mismatch`. Manual review is recommended because only an MD5 hash comparison was possible.
 - **WARNING:** One or more files in `new` have older last-modified timestamps than the corresponding files in `old`.
@@ -203,7 +211,8 @@ Override only the settings you want to change. For example:
   "ILIgnoreLineContainingStrings": ["buildserver1_", "buildserver2_"],
   "ShouldOutputFileTimestamps": false,
   "ShouldOutputILText": false,
-  "ShouldIncludeIgnoredFiles": false
+  "ShouldIncludeIgnoredFiles": false,
+  "ShouldIncludeILCacheStatsInReport": true
 }
 ```
 
@@ -243,6 +252,11 @@ Override only the settings you want to change. For example:
       <td><code>true</code></td>
       <td>Includes <code>Ignored Files</code> section before <code>Unchanged</code>.</td>
     </tr>
+    <tr id="config-en-shouldincludeilcachestatsInreport">
+      <td><code>ShouldIncludeILCacheStatsInReport</code></td>
+      <td><code>false</code></td>
+      <td>When <code>true</code>, appends an <code>IL Cache Stats</code> section (hits, misses, hit-rate, stores, evicted, expired) between <code>Summary</code> and <code>Warnings</code>. Has no effect when <code>EnableILCache</code> is <code>false</code>.</td>
+    </tr>
     <tr id="config-en-shouldoutputiltext">
       <td><code>ShouldOutputILText</code></td>
       <td><code>true</code></td>
@@ -545,6 +559,14 @@ dotnet run "/path/old" "/path/new" "label" --config /etc/my-config.json --no-pau
 - Modified  : 2
 - Compared  : 5 (Old) vs 5 (New)
 
+## IL Cache Stats
+- Hits    : 42
+- Misses  : 8
+- Hit Rate: 84.0%
+- Stores  : 8
+- Evicted : 0
+- Expired : 0
+
 ## Warnings
 - **WARNING:** One or more files were classified as `MD5Mismatch`. Manual review is recommended because only an MD5 hash comparison was possible.
 - **WARNING:** One or more files in `new` have older last-modified timestamps than the corresponding files in `old`.
@@ -597,7 +619,8 @@ flowchart TD
   "ILIgnoreLineContainingStrings": ["buildserver1_", "buildserver2_"],
   "ShouldOutputFileTimestamps": false,
   "ShouldOutputILText": false,
-  "ShouldIncludeIgnoredFiles": false
+  "ShouldIncludeIgnoredFiles": false,
+  "ShouldIncludeILCacheStatsInReport": true
 }
 ```
 
@@ -637,6 +660,11 @@ flowchart TD
       <td><code>true</code></td>
       <td>レポートに <code>Ignored Files</code> セクションを出力するか。</td>
     </tr>
+    <tr id="config-ja-shouldincludeilcachestatsInreport">
+      <td><code>ShouldIncludeILCacheStatsInReport</code></td>
+      <td><code>false</code></td>
+      <td><code>true</code> の場合、<code>Summary</code> と <code>Warnings</code> の間に <code>IL Cache Stats</code> セクション（ヒット数・ミス数・ヒット率・保存数・退避数・期限切れ数）を出力します。<code>EnableILCache</code> が <code>false</code> の場合は本設定が <code>true</code> でも出力されません。</td>
+    </tr>
     <tr id="config-ja-shouldoutputiltext">
       <td><code>ShouldOutputILText</code></td>
       <td><code>true</code></td>