site: open-iov.org 2026 documentation update

- tools/site: Markdown-to-MediaWiki converter (tracked-paths-only link
  mapping, local-marker scan, About-message insert), WikiBot publisher
  with diff/check modes and publish manifest, live site auditor, image
  uploader, site-only page sources (landing page, About, index, sidebar,
  banner templates, About-message template).
- wiki: new public deep-dive sources (project status, install, FAQ,
  system overview, GSP and GSP-RM, execution frontier, host module,
  guest stack, UVM, physical backend, driver lifecycle, risc-v-gsp-rm-debugger,
  hardware/software matrix, HAAEEP, glossary); refreshed CUDA userspace
  status; corrected cross-document links; README rewritten for the new set.
- wiki/.publish-manifest.json records each published revision for rollback.

1 files changed, 50 insertions, 0 deletions

diff --git a/tools/site/pages/Documentation.wiki b/tools/site/pages/Documentation.wiki
new file mode 100644
index 0000000..00d40bc
--- /dev/null
+++ b/tools/site/pages/Documentation.wiki
@@ -0,0 +1,50 @@
+{{About message}}
+
+This is the index of the Open-IOV wiki. If you are new, read '''[[Project Status]]''' first, then '''[[System Overview]]'''. The wiki is a curated public view of the project's maintained documentation; each page names its canonical document in the [https://git.vgpu.io/open-iov repository].
+
+== Start here ==
+* [[Project Status]] — what works today, what is in progress, what is not started
+* [[Install and First Run]] — build, load, and a stock guest driver in about half an hour
+* [[System Overview]] — the architecture in one page
+* [[FAQ]] — common questions, including "why is nvidia-smi working but CUDA not?"
+
+== Architecture ==
+* [[System Overview]] — principle, layer map, data flows
+* [[GSP and GSP-RM]] — the firmware interface the project emulates
+* [[The Host Module (vgsp.ko)]] — virtual device, emulation core, memory model, forwarding
+* [[The Guest Stack and CUDASW]] — what runs unmodified inside the guest
+* [[The vGSP Execution Plane (vEP)]] — the execution and completion layer
+* [[Introduction to GMMU]] — GPU address translation from first principles
+* [[UVM in the Guest]] — unified memory, semaphores, page trees
+* [[GMMU Multi-Tenant Protection]] — isolation design for multiple VMs and tenants
+* [[Physical GPU Backend and Guest Wiring]] — how guest work reaches real hardware
+* [[Guest Driver Lifecycle: A Field Guide]] — boot to CUDA, with real control IDs and log signatures
+
+== CUDA ==
+* [[CUDA Userspace Driver]] — the <code>libcuda.so</code> deep dive
+* [[The Execution Frontier]] — the GR compute-launch chain and its current wall
+
+== Firmware interoperability ==
+* [[GSP 570.144W Firmware Analysis]] — how the 28.5 MB image was decompiled and mapped
+* [[Address Reference]] — firmware-side address tables
+* [[risc-v-gsp-rm-debugger]] — the firmware runtime workbench (hooks, watchpoints, sessions)
+* Historical protocol analyses, kept for the record: [[RPC Message Format]] · [[BAR Emulation Specification]] · [[WPR Management]] · [[Migration Protocol]] · [[GSP RPC Emulation]] · [[Error Codes]] · [[vGPU-IO Integration Guide]]
+
+== Portability and ecosystem ==
+* [[Hardware and Software Matrix]] — Reference / Target / Experimental, honestly labelled
+* [[HAAEEP and Collaboration]] — the agent-edge use case, collaboration and licensing models
+
+== Reference ==
+* [[Glossary]]
+* [[FAQ]]
+* [[Error Codes]] — historical naming, superseded by the wire status values
+
+== History ==
+This wiki previously hosted the OpenMdev / LibVF.IO project documentation (2021–2023). The pages below are archived for reference; they describe earlier projects and architectures, not Open-IOV.
+
+* [[Introduction]] · [[Virtualization Fundamentals]] · [[Virtual I/O Internals]] · [[GPU Driver Internals]] · [[GPU Firmware]] · [[GPU Support]] · [[CPU Support]] · [[Hypervisor Support]] · [[Merged Drivers]] · [[OpenRM]] · [[AMDGPU]] · [[Intel]] · [[Mdev-GPU]] · [[GVM]] · [[Hyperborea]] · [[LIME Is Mediated Emulation]] · [[LibVF.IO Setup Guide]] · [[Looking Glass KVMFR]] · [[VGPU Unlock]] · [[GPU Software Bill Of Materials (SBOM)]]
+
+== Meta ==
+* [[Open-IOV:About|About Open-IOV]]
+* [[Community]]
+* Wiki architecture pages name their canonical source in the repository; when a page and its source disagree, the repository wins.