feat: align benchmark reports for v0.2.2

Author: O2eg

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pg-perf-bench"
-version = "0.2.1"
+version = "0.2.2"
 description = "Reproducible PostgreSQL TPS benchmarks with environment evidence and report comparison"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -17,7 +17,7 @@ license-files = [
   "src/pg_perf_bench/templates/vendor/THIRD_PARTY_LICENSES.txt",
 ]
 authors = [
-  { name = "O2eg", email = "oleg.ispu@yandex.ru" },
+  { name = "O2eg", email = "oleg.ispu@gmail.com" },
 ]
 keywords = ["postgresql", "benchmark", "pgbench", "performance", "diagnostics"]
 dependencies = [

src/pg_perf_bench/__init__.py

@@ -1,3 +1,3 @@
 """PostgreSQL performance benchmark and evidence collector."""
 
-__version__ = '0.2.1'
+__version__ = '0.2.2'

src/pg_perf_bench/benchmark.py

@@ -446,6 +446,44 @@ def setup_report_structure(report_conf: dict, logger) -> dict:
         logger.info('Report structure initialized.')
         return report
 
+    @staticmethod
+    def build_invocation_summary(
+        conn_type: str,
+        db_conf: dict[str, Any],
+        workload_conf: dict[str, Any],
+    ) -> dict[str, Any]:
+        """Return the safe, user-facing parameters that define a benchmark run."""
+        return {
+            'schema_version': 'pg_perf_bench/invocation-v1',
+            'mode': 'benchmark',
+            'connection_type': str(conn_type),
+            'database': {
+                'host': db_conf.get('host'),
+                'port': db_conf.get('port'),
+                'name': db_conf.get('database'),
+                'user': db_conf.get('user'),
+            },
+            'workload': {
+                'profile': workload_conf.get('workload_profile'),
+                'scale': workload_conf.get('workload_scale'),
+                'duration_seconds': workload_conf.get('workload_duration_seconds'),
+                'iteration_parameter': workload_conf.get('pgbench_iter_name'),
+                'iteration_values': list(workload_conf.get('pgbench_iter_list') or []),
+            },
+            'metrics': {
+                'engine': 'pg_diag',
+                'interval_seconds': workload_conf.get('system_metrics_interval'),
+                'duration_override_seconds': workload_conf.get('system_metrics_duration'),
+            },
+            'safety': {
+                'database_recreated_before_each_iteration': True,
+                'database_reset_authorized': bool(workload_conf.get('allow_database_reset')),
+                'os_caches_dropped_before_each_iteration': bool(
+                    workload_conf.get('drop_os_caches')
+                ),
+            },
+        }
+
     @staticmethod
     def setup_connection(conn_type: str, conn_conf: dict, logger):
         """
@@ -559,6 +597,11 @@ async def run_benchmark_and_collect_metrics(
 
         try:
             report = BenchmarkRunner.setup_report_structure(report_conf, logger)
+            report['invocation'] = BenchmarkRunner.build_invocation_summary(
+                conn_type,
+                db_conf,
+                workload_conf,
+            )
             load_iterations = BenchmarkRunner.load_iterations_config(db_conf, workload_conf)
             if not load_iterations:
                 logger.error('No valid load iterations configured.')

src/pg_perf_bench/templates/all_info_report_struct.json

@@ -4,7 +4,7 @@
     "description": "",
     "sections": {
         "system": {
-            "header": "System properties <hn>",
+            "header": "System properties",
             "description": "Common info about current host",
             "state": "expanded",
             "reports": {

src/pg_perf_bench/templates/benchmark_report_struct.json

@@ -4,7 +4,7 @@
     "description": "",
     "sections": {
         "system": {
-            "header": "System properties <hn>",
+            "header": "System properties",
             "description": "Common info about current host",
             "state": "expanded",
             "reports": {