feat: add build seed to the sim result reports

The build seed was surfaced in the original DVSim CLI reports, and so
should probably be surfaced in the HTML reports as well.

Signed-off-by: Alex Jones <alex.jones@lowrisc.org>

Author: AlexJones0

src/dvsim/sim/data.py

@@ -210,6 +210,9 @@ class SimFlowResults(BaseModel):
     timestamp: datetime
     """Timestamp for when the test ran."""
 
+    build_seed: int | None
+    """Build seed."""
+
     stages: Mapping[str, TestStage]
     """Results per test stage."""
     coverage: CoverageMetrics | None
@@ -253,6 +256,9 @@ class SimResultsSummary(BaseModel):
     timestamp: datetime
     """Run time stamp."""
 
+    build_seed: int | None
+    """Build seed."""
+
     flow_results: Mapping[str, SimFlowResults]
     """Flow results."""
 

src/dvsim/sim/flow.py

@@ -604,6 +604,7 @@ def gen_results(self, results: Sequence[CompletedJobStatus]) -> None:
         reports_dir = Path(self.scratch_base_path) / "reports"
         commit = git_commit_hash(path=Path(self.proj_root))
         url = f"https://github.com/lowrisc/opentitan/tree/{commit}"
+        build_seed = self.build_seed if not self.run_only else None
 
         try:
             dvsim_version = version("dvsim").strip()
@@ -665,6 +666,7 @@ def gen_results(self, results: Sequence[CompletedJobStatus]) -> None:
             top=IPMeta(**summary_top_args),
             version=dvsim_version,
             timestamp=timestamp,
+            build_seed=build_seed,
             flow_results=all_flow_results,
             report_path=reports_dir,
             primary_cfg=self.is_primary_cfg,
@@ -709,6 +711,8 @@ def _gen_json_results(
         )
         tool = ToolMeta(name=self.tool.lower(), version="unknown")
 
+        build_seed = self.build_seed if not self.run_only else None
+
         # --- Build stages only from testpoints that have at least one executed test ---
         stage_to_tps: defaultdict[str, dict[str, Testpoint]] = defaultdict(dict)
 
@@ -806,6 +810,7 @@ def make_test_result(tr) -> TestResult | None:
             block=block,
             tool=tool,
             timestamp=timestamp,
+            build_seed=build_seed,
             stages=stages,
             coverage=coverage_model,
             failed_jobs=failures,

src/dvsim/templates/reports/block_report.html

@@ -7,6 +7,7 @@
 {% extends "reports/wrapper.html" %}
 {% set block = results.block %}
 {% set tool = results.tool %}
+{% set build_seed = results.build_seed %}
 {% set timestamp = results.timestamp %}
 {% set stages = results.stages %}
 {% set coverage = results.coverage %}
@@ -58,6 +59,11 @@ <h2>Simulation Results: {{ block.variant_name(sep='/') }}</h2>
             <span class="badge text-bg-secondary">
                 Tool: {{ tool.name }} [{{ tool.version }}]
             </span>
+            {% if build_seed %}
+            <span class="badge text-bg-secondary">
+                Build seed: {{ build_seed }}
+            </span>
+            {% endif %}
         </div>
 
 {% macro coverage_stat(cov, kind, label) %}

src/dvsim/templates/reports/summary_report.html

@@ -8,6 +8,7 @@
 {% set top = summary.top %}
 {% set timestamp = summary.timestamp %}
 {% set version = summary.version %}
+{% set build_seed = summary.build_seed %}
 {% set title = "Simulation Results: %s"|format(top.name) if summary.primary_cfg else "Simulation Results (Summary)" %}
 {% block content %}
 <div class="container-md"> 
@@ -55,6 +56,11 @@ <h2>{{ title }}</h2>
             <span class="badge text-bg-secondary">
                 Branch: {{ top.branch }}
             </span>
+            {% if build_seed %}
+            <span class="badge text-bg-secondary">
+                Build seed: {{ build_seed }}
+            </span>
+            {% endif %}
         </div>
     </div>