Update README.md

README.md

@@ -12,23 +12,24 @@ short_description: Diff agent timelines. Find first divergence. Export forensic
 thumbnail: >-
   https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/cc2glLOtiZJWxbbDoELfT.jpeg
 ---
-# TimelineDiff — Differential Reproducibility Protocol (DRP)
+TimelineDiff — Differential Reproducibility Protocol (DRP)
 
-Production agents fail in non-deterministic ways: sampling variance, flaky tools, drifting data, timing/race effects.
-Benchmarks tell you *whether* you failed. Logs tell you *what happened once*. TimelineDiff tells you **why two runs diverged**.
+Production agents diverge: sampling variance, flaky tools, drifting data, timing/race effects.
+Benchmarks tell you *whether* you failed. Logs tell you *what happened once*.
+TimelineDiff tells you **why two runs diverged**.
 
 ## What this Space does
 - Upload **two DRP trace bundles (.zip)**
 - Computes:
-  - **First divergence point**
-  - Divergence class (sampling / tool / memory / control-flow / state)
-  - Per-event structured JSON diffs
+  - **Timeline alignment** (same / diff / missing)
+  - **First divergence index**
+  - Divergence class (sampling / tool / memory / control-flow / governance / state)
+  - Per-event structured diffs (JSON)
 - Exports:
-  - `report.md`, `diff.json`, `drp-diff-report.zip`
-- Can also:
-  - Verify hash-chained integrity of a bundle
-  - Generate demo bundles to test the UI
-  - Create a patched “fork” bundle (counterfactual edit) for sandbox what-if workflows
+  - `report.md` (human-readable)
+  - `report.pdf` (stakeholder-ready)
+  - `diff.json` (machine-readable)
+  - `drp-diff-report.zip` (all of the above)
 
 ## DRP bundle format (v0)
 A bundle is a `.zip` containing:
@@ -38,17 +39,22 @@ A bundle is a `.zip` containing:
 Each event is hash-chained:
 - `prev` is the previous event hash
 - `hash` is SHA-256 of canonical event JSON
-This gives a tamper-evident timeline, and makes diffs trustworthy.
+This makes the timeline tamper-evident.
 
-## Integrations (where this plugs in)
-- Agent frameworks can export DRP events at decision points (LLM call, tool call, memory write, planner step).
-- Observability can be ingested and mapped to DRP (spans → events).
-- Verification primitives (signing / zk / attestations) can be layered later.
+## Optional ReplayProof deep-linking
+If you include either of the following in `manifest.json`, TimelineDiff will generate per-event links:
+
+### Option A (recommended)
+```json
+"replay": {
+  "base_url": "https://your-space-or-site",
+  "pattern": "/?run_id={run_id}&i={i}"
+}
+
+Option B
+"run_url": "https://your-viewer/run/demo-123"
+Links will appear in the report and in the diff JSON.
 
-## Quick start (local)
-```bash
-pip install -r requirements.txt
-python app.py
 Suggested event kinds
 	•	llm_sample
 	•	tool_call
@@ -57,9 +63,17 @@ Suggested event kinds
 	•	plan_step
 	•	guardrail
 	•	state_snapshot
+
+Optional reward delta
+
+If your state_snapshot.payload includes:
+	•	reward_total, or
+	•	metrics.reward_total
+
+…TimelineDiff will compute final_reward_delta.
 ---
 
-# `drp/__init__.py`
+## `drp/__init__.py`
 
 ```python
 __all__ = [
@@ -71,6 +85,7 @@ __all__ = [
     "write_bundle_zip",
     "diff_bundles",
     "render_report_markdown",
+    "write_pdf_report",
     "make_demo_bundle_zip",
     "fork_patch_bundle",
 ]