docs(thesis): resolve review findings and verify examples

tests/docs/test_thesis_front_matter.py

@@ -58,3 +58,46 @@ def test_abbreviations_compile_without_a_dummy_float(tmp_path: Path) -> None:
     assert "API" in rendered
     assert "Application Programming Interface" in rendered
     assert "None 1" not in rendered
+
+
+@pytest.mark.skipif(
+    any(shutil.which(tool) is None for tool in ("pandoc", "xelatex", "pdftotext")),
+    reason="Pandoc, XeLaTeX, and pdftotext are needed for the inline-code build",
+)
+def test_inline_identifier_moves_to_next_line_intact(tmp_path: Path) -> None:
+    """A prose line ending must not split a callable's name into fragments."""
+    output = tmp_path / "inline.pdf"
+    identifier = "local.report.render_markdown_report"
+    result = subprocess.run(
+        [
+            "pandoc",
+            "--standalone",
+            "--pdf-engine=xelatex",
+            "--variable=geometry:textwidth=10cm",
+            "--variable=monofont:Libertinus Mono",
+            "--include-in-header",
+            str(THESIS / "header-includes.tex"),
+            "--output",
+            str(output),
+        ],
+        # Shift the identifier along the line to expose both forced splitting
+        # and font-dependent automatic hyphenation near the right margin.
+        input="\n\n".join(
+            f"{'word ' * count}`{identifier}`." for count in range(1, 16)
+        ),
+        text=True,
+        encoding="utf-8",
+        capture_output=True,
+        check=False,
+        timeout=90,
+    )
+    assert result.returncode == 0, result.stderr
+    rendered = subprocess.run(
+        ["pdftotext", "-layout", str(output), "-"],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        check=True,
+        timeout=15,
+    ).stdout
+    assert rendered.count(identifier) == 15

tests/docs/test_thesis_langgraph_example.py

@@ -0,0 +1,28 @@
+"""Exercise the comparison snippet when the optional LangGraph library exists."""
+
+from pathlib import Path
+
+import pytest
+
+
+@pytest.mark.parametrize(
+    ("text", "expected_report"),
+    [(" Notes ", "# Report\n\nNotes"), ("   ", "")],
+)
+def test_langgraph_comparison_routes_updated_state(
+    text: str, expected_report: str
+) -> None:
+    """Check the rendered example without making LangGraph a product dependency."""
+    pytest.importorskip("langgraph.graph")
+    manuscript = (
+        Path(__file__).resolve().parents[2]
+        / "docs/thesis/system-design-implementation.md"
+    ).read_text(encoding="utf-8")
+    section = manuscript.split("<!-- langgraph-comparison -->", 1)[1]
+    snippet = section.split("```python\n", 1)[1].split("```", 1)[0]
+    namespace = {}
+    # This is trusted repository prose, executed exactly as displayed.
+    exec(compile(snippet, "thesis-langgraph-example", "exec"), namespace)
+    result = namespace["graph"].invoke({"text": text, "report": ""})
+    assert result["text"] == text.strip()
+    assert result["report"] == expected_report