docs: add BotCanvas references across main documentation and CLI flags

Author: MSTU0

ADVANCED_FEATURES.md

@@ -581,6 +581,7 @@ For technical questions about advanced features, implementation details, or cust
 - **[CLI Flags Reference](CLI_FLAGS.md)** - Complete command-line options
 - **[Profile Configuration](profiles/PROFILE_CONFIGS.md)** - Advanced profile customization
 - **[Validation Results](VALIDATION.md)** - Research and testing data
+- **[BotCanvas Lab](tools/botcanvas/)** - Canvas forensics and fingerprint analysis tool
 - **[Examples](examples/)** - Automation code samples
 
 ---

CLI_FLAGS.md

@@ -115,6 +115,23 @@ Accepts a JSON string containing bookmark data for startup.
 --bot-bookmarks='[{"title":"Example","type":"url","url":"https://example.com"},{"title":"Folder","type":"folder","children":[{"title":"Example","type":"url","url":"https://example.com"}]}]'
 ```
 
+### `--bot-canvas-record-file`
+Canvas forensics and fingerprint analysis.
+
+Records all Canvas 2D API calls to a JSONL file for forensic analysis and future replay capabilities.
+
+```bash
+--bot-canvas-record-file="/tmp/botcanvas.jsonl"
+```
+
+**Key Features:**
+- Complete Canvas 2D API call recording with full parameter serialization
+- Deterministic capture (noise injection disabled during recording)
+- JSONL format for easy parsing and analysis
+- HTML viewer included for interactive event inspection
+
+📖 **Learn More:** [BotCanvas Documentation](tools/botcanvas/)
+
 ### `--bot-script`
 Framework‑less automation with a privileged JavaScript context.
 

README.md

@@ -240,6 +240,7 @@ Our compatibility research examines browser fingerprinting techniques across dif
 | **[Validation Results](VALIDATION.md)** | Research data | 25+ anti-bot systems, 50,000+ test sessions, statistical analysis |
 | **[CLI Flags Reference](CLI_FLAGS.md)** | Command-line options | `--bot-config-*` flags, proxy auth, session management |
 | **[Profile Configuration](profiles/PROFILE_CONFIGS.md)** | Profile customization | Fingerprint control, cross-platform compatibility |
+| **[BotCanvas Lab](tools/botcanvas/)** | Canvas forensics tool | Canvas 2D recording, JSONL event viewer, replay roadmap |
 | **[Examples](examples/)** | Code samples | Playwright, Puppeteer, bot-script automation |
 
 ### Quick Access