Update app.py

app.py

@@ -38,11 +38,43 @@ WHY = (
     "When an agent fails, too many postmortems still rely on screenshots, partial logs, and opinions — not evidence.\n\n"
     "The operational risk is not only that an agent does the wrong thing. 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.\n\n"
-    "RFTSystems exists to make agent behaviour **inspectable and independently verifiable**. This suite produces artifacts you can share and validate: "
+    "RFTSystems exists to make agent behaviour **inspectable and independently verifiable**. This suite produces evidence bundles 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.\n\n"
     "I can’t promise “AI will never take over.” No one can. What I *can* promise is this: **with chain-of-custody logs and receipts, we can prove what happened and who is responsible.**"
 )
 
+WHY_VERIFICATION_DOC = (
+    "# Why verification matters (the risks, plainly)\n\n"
+    "AI is being built and deployed at a pace that is now outstripping accountability. That mismatch is where harm happens.\n\n"
+    "The problem isn’t that agents make mistakes. Mistakes are inevitable. The unacceptable part is what usually follows:\n\n"
+    "- “We can’t reproduce it.”\n"
+    "- “We’re not sure which prompt/tool/model version caused it.”\n"
+    "- “We changed a few things and it seems better now.”\n"
+    "- “Trust us.”\n\n"
+    "That is not engineering. That is damage control.\n\n"
+    "Recent “nearly-Grok” style incidents are the warning flare: capabilities shipped fast, edge cases exploited, then a scramble to patch. "
+    "And once it’s patched, the public can’t prove what was true yesterday. That’s the accountability gap.\n\n"
+    "## What must be provable (every time)\n\n"
+    "If you’re shipping agents that browse, call tools, write files, automate actions, or influence real users, you need to be able to prove:\n\n"
+    "1) **WHEN** it happened (a verifiable timeline)\n"
+    "2) **WHAT** happened (inputs → decisions → tool calls → outputs)\n"
+    "3) **WHY** it happened (the exact chain of state transitions)\n"
+    "4) **HOW** to stop it happening again (what changed, and proof that the change works)\n\n"
+    "If you cannot answer those with evidence, you do not have a safe system — you have a black box.\n\n"
+    "## Why this collection exists\n\n"
+    "This suite exists to end the “unanswered for” failure mode.\n\n"
+    "It turns agent runs into **evidence you can verify independently**:\n\n"
+    "- deterministic replays (so anyone can reproduce behaviour)\n"
+    "- chain-of-custody logging (so the record can’t be quietly rewritten)\n"
+    "- tamper-evident receipts (so integrity can be proven)\n"
+    "- first-divergence diffs (so you can pinpoint exactly where and why two runs split)\n"
+    "- audit views (so governance becomes evidence-led, not opinion-led)\n\n"
+    "### Bottom line\n\n"
+    "**If you can’t replay it, you don’t understand it. If you can’t prove it, you can’t govern it.**\n\n"
+    "Collection:\n"
+    "https://huggingface.co/collections/RFTSystems/rftsystems-agent-forensics-suite\n"
+)
+
 LICENSE_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:
@@ -104,9 +136,24 @@ def _build_markdown() -> str:
     return "\n".join(md)
 
 
+def render_doc(which: str) -> str:
+    if which == "Why verification matters":
+        return WHY_VERIFICATION_DOC
+    return _build_markdown()
+
+
 with gr.Blocks(title="RFTSystems — Agent Forensics Suite") as demo:
-    gr.Markdown(_build_markdown())
+    doc = gr.Dropdown(
+        choices=["Start Here", "Why verification matters"],
+        value="Start Here",
+        label="Pages",
+    )
+
+    main = gr.Markdown(render_doc("Start Here"))
+
+    doc.change(fn=render_doc, inputs=doc, outputs=main)
+
     with gr.Accordion("Licence / Rights Notice (click to expand)", open=False):
         gr.Markdown(LICENSE_NOTICE)
 
-demo.launch()
+demo.launch()