No structural review trigger was emitted.
'
+ items = "".join(
+ f"',
+ '",
+ f'',
+ 'Review routing
',
+ f"{escape(review_label)}
",
+ f'{escape(_VALIDITY_NOTICE)}
',
+ _trigger_section(report),
+ "",
+ '',
+ 'Exact provenance
',
+ provenance,
+ "",
+ '',
+ 'Criterion outcomes
',
+ criteria,
+ "",
+ '',
+ 'Evidence references
',
+ evidence,
+ "",
+ '',
+ 'Canonical JSON
',
+ 'The complete deterministic report payload is available below for audit reconstruction.
',
+ '',
+ _canonical_json(report),
+ "
",
+ "",
+ "",
+ "",
+ "",
+ )
+ )
+
+
+def render_essay_score_report_html(
+ report: EssayScoreReport,
+ output_path: str | Path,
+ *,
+ title: str | None = None,
+) -> Path:
+ """Write one replay-verified, accessible standalone HTML audit report.
+
+ The artifact contains exact criterion, evidence, engine, assessment, rubric,
+ request, result, and report provenance but no prompt, essay, or source text.
+ Its review state is not a validity or deployment decision.
+ """
+ validated = _validated_report(report)
+ output = Path(output_path)
+ if output.suffix.lower() != ".html":
+ raise ValueError("essay score report output path must end with .html")
+ if title is not None and (
+ not isinstance(title, str) or not title.strip()
+ ):
+ raise ValueError(
+ "essay score report title must be a non-empty string"
+ )
+ resolved_title = _DEFAULT_TITLE if title is None else title
+ output.parent.mkdir(parents=True, exist_ok=True)
+ output.write_text(_render_html(validated, resolved_title), encoding="utf-8")
+ return output
+
+
+__all__ = ["render_essay_score_report_html"]
diff --git a/tests/test_scoring_essay_contracts.py b/tests/test_scoring_essay_contracts.py
index dd4df322a..04948cdfd 100644
--- a/tests/test_scoring_essay_contracts.py
+++ b/tests/test_scoring_essay_contracts.py
@@ -190,6 +190,7 @@ def test_public_surface_is_explicit_and_documented() -> None:
"build_essay_scoring_request",
"build_essay_submission",
"fit_essay_facets_calibration_report",
+ "render_essay_score_report_html",
"score_essay_request",
}
assert set(essay.__all__) == expected
diff --git a/tests/test_scoring_essay_report_html.py b/tests/test_scoring_essay_report_html.py
new file mode 100644
index 000000000..568dbb5ae
--- /dev/null
+++ b/tests/test_scoring_essay_report_html.py
@@ -0,0 +1,184 @@
+"""Tests for accessible standalone governed essay score reports."""
+
+from __future__ import annotations
+
+import runpy
+from pathlib import Path
+
+import pytest
+
+import fast_mlsirm.scoring.essay.report_html as report_html
+from fast_mlsirm.scoring import AssessmentSpecError, ObservationStatus
+from fast_mlsirm.scoring.essay import (
+ EssayReviewFlag,
+ build_essay_score_report,
+ render_essay_score_report_html,
+)
+
+_REPORT_FIXTURES = runpy.run_path(
+ str(Path(__file__).with_name("test_scoring_essay_reporting.py"))
+)
+essay_request = _REPORT_FIXTURES["essay_request"]
+result_bundle = _REPORT_FIXTURES["result_bundle"]
+
+
+def clean_report():
+ """Return one deterministic report without structural review triggers."""
+ request = essay_request()
+ _engine, descriptor, result = result_bundle(request)
+ return build_essay_score_report(
+ report_id="essay_score_report",
+ request=request,
+ result=result,
+ engine=descriptor,
+ metadata={"workflow_stage": "pilot_review"},
+ )
+
+
+def review_report():
+ """Return one deterministic report with mandatory and added triggers."""
+ request = essay_request(
+ review_flags=(EssayReviewFlag.OFF_TOPIC_RESPONSE,)
+ )
+ _engine, descriptor, result = result_bundle(
+ request,
+ claim_evidence=(),
+ alignment_status=ObservationStatus.ABSTAINED,
+ alignment_reason="insufficient_evidence",
+ )
+ return build_essay_score_report(
+ report_id="review_required_report",
+ request=request,
+ result=result,
+ engine=descriptor,
+ additional_review_trigger_ids=("scorer_disagreement",),
+ )
+
+
+def test_html_renderer_surface_is_explicit_and_documented() -> None:
+ """The renderer module exposes one documented reporting operation."""
+ assert report_html.__all__ == ["render_essay_score_report_html"]
+ assert render_essay_score_report_html.__doc__
+
+
+def test_clean_report_renders_deterministic_accessible_exact_values(
+ tmp_path: Path,
+) -> None:
+ """A clean report remains exact, script-free, accessible, and deterministic."""
+ report = clean_report()
+ first_path = tmp_path / "nested_report" / "first.html"
+ second_path = tmp_path / "second.html"
+
+ returned = render_essay_score_report_html(report, first_path)
+ render_essay_score_report_html(report, second_path)
+ first = first_path.read_text(encoding="utf-8")
+ second = second_path.read_text(encoding="utf-8")
+
+ assert returned == first_path
+ assert first == second
+ assert "" in first
+ assert '