Add English documentation comments to all benchmark_cherrypick source files (adapters, scenarios, CLI, reporters, runner)

benchmark_cherrypick/lib/cli/report/csv_report.dart

@@ -1,11 +1,14 @@
 import 'report_generator.dart';
 
+/// Generates a CSV-formatted report for benchmark results.
 class CsvReport extends ReportGenerator {
+  /// List of all keys/columns to include in the CSV output.
   @override
   final List<String> keys = [
     'benchmark','chainCount','nestingDepth','mean_us','median_us','stddev_us',
     'min_us','max_us','trials','timings_us','memory_diff_kb','delta_peak_kb','peak_rss_kb'
   ];
+  /// Renders rows as a CSV table string.
   @override
   String render(List<Map<String, dynamic>> rows) {
     final header = keys.join(',');

benchmark_cherrypick/lib/cli/report/json_report.dart

@@ -1,8 +1,11 @@
 import 'report_generator.dart';
 
+/// Generates a JSON-formatted report for benchmark results.
 class JsonReport extends ReportGenerator {
+  /// No specific keys; outputs all fields in raw map.
   @override
   List<String> get keys => [];
+  /// Renders all result rows as a pretty-printed JSON array.
   @override
   String render(List<Map<String, dynamic>> rows) {
     return '[\n${rows.map((r) => '  $r').join(',\n')}\n]';

benchmark_cherrypick/lib/cli/report/markdown_report.dart

@@ -1,11 +1,17 @@
 import 'report_generator.dart';
 
+/// Generates a Markdown-formatted report for benchmark results.
+///
+/// Displays result rows as a visually clear Markdown table including a legend for all metrics.
 class MarkdownReport extends ReportGenerator {
+  /// List of columns (keys) to show in the Markdown table.
   @override
   final List<String> keys = [
     'benchmark','chainCount','nestingDepth','mean_us','median_us','stddev_us',
     'min_us','max_us','trials','memory_diff_kb','delta_peak_kb','peak_rss_kb'
   ];
+
+  /// Friendly display names for each benchmark type.
   static const nameMap = {
     'Universal_UniversalBenchmark.registerSingleton':'RegisterSingleton',
     'Universal_UniversalBenchmark.chainSingleton':'ChainSingleton',
@@ -15,6 +21,7 @@ class MarkdownReport extends ReportGenerator {
     'Universal_UniversalBenchmark.override':'Override',
   };
 
+  /// Renders all results as a formatted Markdown table with aligned columns and a legend.
   @override
   String render(List<Map<String, dynamic>> rows) {
     final headers = [
@@ -38,7 +45,7 @@ class MarkdownReport extends ReportGenerator {
       ].map((cell) => cell.toString()).toList();
     }).toList();
 
-    // Вычислить ширину каждой колонки
+    // Calculate column width for pretty alignment
     final all = [headers] + dataRows;
     final widths = List.generate(headers.length, (i) {
       return all.map((row) => row[i].length).reduce((a, b) => a > b ? a : b);

benchmark_cherrypick/lib/cli/report/pretty_report.dart

@@ -1,12 +1,17 @@
 import 'report_generator.dart';
 
+/// Generates a human-readable, tab-delimited report for benchmark results.
+///
+/// Used for terminal and log output; shows each result as a single line with labeled headers.
 class PrettyReport extends ReportGenerator {
+  /// List of columns to output in the pretty report.
   @override
   final List<String> keys = [
     'benchmark','chainCount','nestingDepth','mean_us','median_us','stddev_us',
     'min_us','max_us','trials','memory_diff_kb','delta_peak_kb','peak_rss_kb'
   ];
 
+  /// Mappings from internal benchmark IDs to display names.
   static const nameMap = {
     'Universal_UniversalBenchmark.registerSingleton':    'RegisterSingleton',
     'Universal_UniversalBenchmark.chainSingleton':       'ChainSingleton',
@@ -16,6 +21,7 @@ class PrettyReport extends ReportGenerator {
     'Universal_UniversalBenchmark.override':             'Override',
   };
 
+  /// Renders the results as a header + tab-separated value table.
   @override
   String render(List<Map<String, dynamic>> rows) {
     final headers = [

benchmark_cherrypick/lib/cli/report/report_generator.dart

@@ -1,4 +1,9 @@
+/// Abstract base for generating benchmark result reports in different formats.
+///
+/// Subclasses implement [render] to output results, and [keys] to define columns (if any).
 abstract class ReportGenerator {
+  /// Renders the given [results] as a formatted string (table, markdown, csv, etc).
   String render(List<Map<String, dynamic>> results);
+  /// List of output columns/keys included in the export (or [] for auto/all).
   List<String> get keys;
 }