Update README.md

README.md

@@ -1,13 +1,71 @@
 ---
 title: START HERE  Agent Forensics Suite
-emoji: 📉
-colorFrom: green
-colorTo: yellow
+emoji: 🔥
+colorFrom: indigo
+colorTo: purple
 sdk: gradio
 sdk_version: 6.3.0
 app_file: app.py
-pinned: false
+pinned: true
 short_description: 'Start here: verify agent runs with receipts, replays, diffs.'
+license: other
+thumbnail: >-
+  https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/nX59TmzGS6YkzPd5j1kyW.png
 ---
+# RFTSystems — Agent Forensics Suite (START HERE)
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+**Evidence-first instrumentation for AI agents.**  
+Audit, prove, replay, and diff agent runs — turning “trust me” into verification.
+
+## Why this exists
+AI is being shipped into real systems faster than teams can reliably reproduce or explain agent behaviour. When an agent fails, too many postmortems still rely on screenshots, partial logs, and opinions — not evidence.
+
+The deeper risk is that **nobody can prove what happened**: what the agent saw, what it called, what it wrote, and where the run diverged. When failures are unreproducible, accountability collapses.
+
+RFTSystems exists to make agent behaviour **inspectable and independently verifiable**. This suite produces artifacts you can share and validate: hash-chained timelines, tamper-evident receipts, deterministic replays, and first-divergence diffs. You don’t need to trust the author — you can verify the evidence.
+
+## Workflow
+**learn → generate proof → record reality → seal it → diff it → audit it → benchmark it**
+
+### Quick start (60 seconds)
+1. Open **ReplayProof** and run a deterministic session.  
+2. Export the run bundle (receipts + hashes).  
+3. Upload the bundle to verify integrity, then share it — anyone can replay it.
+
+### Full pipeline (real systems)
+1. **Record reality** (Agent Flight Recorder)  
+2. **Seal it** into receipts (RFT Memory Receipt Engine)  
+3. **Diff** two runs and find first divergence (TimelineDiff)  
+4. **Audit** state transitions and governance evidence (TrustStack)  
+5. **Benchmark** verifiable performance signals (Coherent Compute Engine)
+
+## The labs
+- **ReplayProof Agent POV Verified Replay** — Fast proof: generate a deterministic run bundle you can verify and replay anywhere.  
+- **Agent Flight Recorder** — Chain-of-custody logging: hash-chained events across prompts, tools, outputs, and memory reads/writes.  
+- **RFT Memory Receipt Engine** — Proof layer: generate/download tamper-evident receipts; upload to independently verify integrity.  
+- **TimelineDiff Differential Reproducibility** — First divergence: align two run bundles and pinpoint exactly where/why they split.  
+- **TrustStack Console** — Audit cockpit: inspect runs, compare state, and trace exactly what changed and why.  
+- **Coherent Compute Engine** — Verification-first benchmark: live throughput + stability/energy behaviour + downloadable receipt.
+
+## Design principle
+We don’t “imprison” agents. We measure drift from declared intent and produce evidence. Enforcement remains an operator decision; this suite is the instrumentation layer.
+
+## Licence / Rights Notice
+All materials contained in or associated with this repository — including but not limited to text, code, algorithms, equations, figures, datasets, and documentation — are original works authored by Liam Grinstead and form part of the Rendered Frame Theory (RFT) research framework.
+
+These works are protected under the following laws and treaties:
+
+- Copyright, Designs and Patents Act 1988 (UK) — ss.1–103 and ss.77–89  
+- Trade Secrets (Enforcement etc.) Regulations 2018 (UK) — Regs.2–6  
+- Copyright and Rights in Databases Regulations 1997 (UK) — Regs.14–24  
+- Berne Convention — Arts.5(2) & 6bis  
+- TRIPS Agreement — Arts.9–14  
+
+All rights are reserved.
+
+No part of this work may be copied, reproduced, distributed, performed, displayed, trained upon by AI systems, reverse-engineered, or used to create derivative works without the author’s explicit written consent.
+
+Verification: Each record is timestamped through the Zenodo/DataCite registry and may reference the master DOI: https://doi.org/10.5281/zenodo.17460107 as the consolidated legal and authorship archive.
+
+© 2025 Liam Grinstead — All Rights Reserved.
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference