Update README.md

Author: qectorlab

README.md

@@ -1,45 +1,95 @@
 # QECTOR Decoder Workbench
 
-Official desktop application (Windows / Linux / macOS) for the **QECTOR Decoder v3** quantum error-correction platform.
+**Version 3.5.1** · Backend: [qector-decoder-v3==0.6.9](https://pypi.org/project/qector-decoder-v3/)
 
-**Python package**: [qector-decoder-v3 on PyPI](https://pypi.org/project/qector-decoder-v3/)  
-**Website**: [https://www.qector.store](https://www.qector.store)  
-**Author**: Guillaume Lessard (iD01t Productions) · ORCID: [0009-0000-3465-3753](https://orcid.org/0009-0000-3465-3753)
+Professional desktop application for quantum error correction research, evaluation, and documentation.
+
+- 13 decoder algorithms
+- 9 code families (surface, toric, heavy-hex, bicycle qLDPC, …)
+- 47-tool Model Context Protocol (MCP) server for AI agents
+- Portable Windows executable · Linux .deb · macOS .dmg
+- Full GUI + command-line + headless MCP mode
+
+**Website**: [https://www.qector.store](https://www.qector.store)
+**Author**: Guillaume Lessard / iD01t Productions · ORCID [0009-0000-3465-3753](https://orcid.org/0009-0000-3465-3753)
 
 ---
 
 ## Downloads
 
 | Platform | File | Notes |
 |----------|------|-------|
-| Windows  | `QECTOR-Workbench-x.y.z-windows-x64.exe` or portable zip | Recommended: portable version |
-| Linux    | `QECTOR-Workbench-x.y.z-linux-x86_64.AppImage` | Make executable: `chmod +x *.AppImage` |
-| macOS    | `QECTOR-Workbench-x.y.z-macos-arm64.dmg` (or Intel) | — |
+| **Windows** | `QectorWorkbench-Portable.exe` or `.zip` | Fully portable, no install required |
+| **Linux** | `qector-workbench_3.5.1_amd64.deb` | Ubuntu 20.04+ / Debian 11+ |
+| **macOS** | `QectorWorkbench-3.5.1.dmg` | macOS 12+ (Apple Silicon & Intel) |
 
-**Latest release**: [Releases page](https://github.com/GuillaumeLessard/qector-workbench/releases/latest)
+→ **[Latest Release](https://github.com/GuillaumeLessard/qector-workbench/releases/latest)**
 
-Always verify the SHA-256 checksums published with each release.
+Always verify the SHA-256 checksums included with each release.
 
 ---
 
-## Features
+## Quick Start
+
+**Windows**
+
+1. Extract the zip (or run the portable `.exe` directly)
+2. Double-click `QectorWorkbench-Portable.exe`
+
+**Linux**
+
+```bash
+sudo apt install ./qector-workbench_3.5.1_amd64.deb
+qector-workbench
+```
 
-- Graphical interface for decoder selection, code generation, and batch runs
-- Integration with the `qector-decoder-v3` Python package
-- Benchmark orchestration (Workbench harness)
-- Stim / Sinter compatible workflows
-- Offline license token support (Ed25519)
+**macOS**
+
+Mount the DMG and drag to Applications.
+
+**MCP Server (AI agents)**
+
+```bash
+QectorWorkbench-Portable.exe --mcp          # Windows
+qector-workbench --mcp                      # Linux / macOS
+```
+
+---
+
+## Key Features
+
+- Interactive GUI (Code Explorer, Decoder Lab, Benchmark Suite, Batch/Streaming, Diagnostics, Documentation Studio)
+- 13 decoders including exact Blossom MWPM, Union-Find family, BP-OSD, belief-matching, auto-router, hybrid cascade
+- 9 code families (graph-like + qLDPC)
+- Publication-grade charts and multi-format export (MD, JSON, HTML, LaTeX, PDF, SVG)
+- 47-tool MCP server (stdio JSON-RPC 2.0)
+- Automatic backend provisioning from PyPI on first run (subsequent runs fully offline)
+- Self-healing decoder engine
 
 ---
 
 ## Licensing
 
-Source-available.
+**Workbench (this application)** — see `EULA.txt`
+Royalty-free for any purpose (including commercial) as long as QECTOR notices are retained.
+
+**Backend (qector-decoder-v3)** — separately licensed
+Free for personal / academic / non-commercial research.
+Commercial use requires a paid license → [qector.store/pricing](https://www.qector.store/pricing)
+
+---
+
+## Documentation
 
-- **Free**: personal, academic, educational, and non-commercial research use
-- **Commercial license required** for company use, commercial R&D, SaaS, OEM embedding, or revenue-linked work
+Included in releases:
 
-Contact: [admin@qector.store](mailto:admin@qector.store)
+- `README.txt` – full package overview
+- `EULA.txt` – End User License Agreement
+- Platform user manuals (Windows / Linux / macOS)
+- `QECTOR_API_Reference.md` / `.pdf`
+- `QECTOR_MCP_Integration_Guide.pdf`
+- `QECTOR_Quick_Start_Guide.pdf`
+- `QECTOR_LLM_Manual.json` – machine-readable agent guide
 
 ---
 
@@ -54,3 +104,12 @@ Contact: [admin@qector.store](mailto:admin@qector.store)
   url     = {https://www.qector.store},
   orcid   = {0009-0000-3465-3753}
 }
+```
+
+---
+
+## Related
+
+- Core library: [GuillaumeLessard/qector-decoder](https://github.com/GuillaumeLessard/qector-decoder)
+- PyPI: [qector-decoder-v3](https://pypi.org/project/qector-decoder-v3/)
+- Website & commercial licensing: [qector.store](https://www.qector.store)