Add comprehensive snippet-based examples to README and docs

Co-authored-by: 0xrinegade <[email protected]>

Author: Copilot

README.md

@@ -220,6 +220,359 @@ osvm rpc-manager devnet  # Start real devnet validator
 
 ---
 
+## 📖 Common Workflows
+
+These practical, copy-paste ready examples demonstrate the most common OSVM CLI use cases.
+
+### 🏃 Getting Started Workflow
+
+```bash
+# 1. Check system health and dependencies
+osvm doctor
+
+# Expected output:
+# ✅ System health check complete
+# ✅ Rust toolchain: 1.70+ installed
+# ✅ Solana CLI: installed
+# ✅ SSH client: available
+
+# 2. Configure your Solana network
+osvm config set --network devnet
+osvm config set --keypair ~/.config/solana/id.json
+
+# 3. Verify configuration
+osvm config show
+
+# Expected output:
+# Current Configuration:
+#   Network: devnet
+#   RPC URL: https://api.devnet.solana.com
+#   Keypair: ~/.config/solana/id.json
+```
+
+### 🔍 AI-Powered Analysis Workflow
+
+```bash
+# 1. Set up AI endpoint (OpenAI or Ollama)
+export OPENAI_URL="https://api.openai.com/v1/chat/completions"
+export OPENAI_KEY="sk-your-api-key-here"
+
+# 2. Ask natural language questions about Solana
+osvm "What's the current slot height on mainnet?"
+
+# Expected output:
+# 🤖 AI Analysis:
+# The current slot on Solana mainnet is approximately 245,678,901
+# (as of [timestamp]). This represents...
+# Confidence: 95%
+
+# 3. Analyze a transaction
+osvm "Analyze transaction signature 5J8sFH3kGxNy2Bbv7vPo8hKqM9dRT4yL5KzPr6DqM2Wx"
+
+# 4. Get validator performance insights
+osvm "How do I optimize my validator for better performance?"
+
+# 5. Security audit a program
+osvm audit ./my-solana-program
+
+# Expected output:
+# 🔍 Security Audit Report
+# ==================
+# Severity: HIGH - 2 issues found
+# Severity: MEDIUM - 5 issues found
+# [Detailed findings with code snippets...]
+```
+
+### 🚀 Local Development Workflow
+
+```bash
+# 1. Start local test validator
+osvm rpc-manager test --faucet-sol 1000
+
+# Expected output:
+# ✅ Starting local test validator
+# ✅ Airdropping 1000 SOL to faucet
+# ✅ RPC endpoint: http://localhost:8899
+# ✅ WebSocket: ws://localhost:8900
+
+# 2. Check your balance
+osvm balance
+
+# Expected output:
+# Address: 7xKx...abc123
+# Balance: 1000.000000000 SOL
+
+# 3. Deploy your program
+cargo build-bpf
+osvm deploy-program \
+  --program target/deploy/my_program.so \
+  --network localnet
+
+# Expected output:
+# 🚀 Deploying program...
+# Program ID: BPF...xyz789
+# ✅ Deployment successful in 2.3s
+```
+
+### 🔧 Remote Validator Setup Workflow
+
+```bash
+# 1. Prepare your keypairs
+solana-keygen new --outfile ~/validator-keypair.json
+solana-keygen new --outfile ~/vote-keypair.json
+
+# 2. Deploy validator to remote server
+osvm deploy-validator \
+  --host [email protected] \
+  --keypair ~/validator-keypair.json \
+  --vote-keypair ~/vote-keypair.json \
+  --network testnet
+
+# Expected output:
+# 🔌 Connecting to [email protected]...
+# ✅ SSH connection established
+# 📦 Installing dependencies...
+# ✅ Dependencies installed
+# 🚀 Deploying validator...
+# ✅ Validator deployed successfully
+# 📊 Status: Running
+# 🔗 Identity: 7xKx...abc123
+
+# 3. Monitor validator status
+osvm node status validator-001
+
+# Expected output:
+# Validator: validator-001
+# Status: ✅ Running
+# Network: testnet
+# Version: 1.18.0
+# Uptime: 2h 34m
+# Vote Account: BPF...xyz789
+
+# 4. View validator logs
+osvm node logs validator-001 --follow
+```
+
+### 📊 Monitoring & Troubleshooting Workflow
+
+```bash
+# 1. Launch the monitoring dashboard
+osvm svm dashboard
+
+# Interactive TUI showing:
+# - All SVMs and their status
+# - Resource usage (CPU, Memory, Disk)
+# - Network metrics
+# - Real-time logs
+
+# 2. Check node health
+osvm doctor --node validator-001 --detailed
+
+# Expected output:
+# 🏥 Health Check for validator-001
+# ✅ Process: Running
+# ✅ Network: Connected
+# ⚠️  Disk space: 78% used (warning)
+# ✅ Memory: 45% used
+# Recommendations:
+#   - Consider expanding disk space
+
+# 3. Auto-repair common issues
+osvm doctor --auto-repair
+
+# Expected output:
+# 🔧 Auto-repair mode enabled
+# 🔍 Detecting issues...
+# ⚠️  Found: Outdated Rust toolchain
+# 🔧 Fixing: Updating Rust...
+# ✅ Fixed: Rust toolchain updated to 1.70+
+# ✅ All issues resolved
+
+# 4. Monitor logs for errors
+osvm monitor-logs validator.log --auto-repair
+
+# Continuously monitors logs and auto-repairs issues:
+# - Restarts on crash
+# - Handles panic recovery
+# - Reports anomalies
+```
+
+### 🔌 MCP Server Integration Workflow
+
+```bash
+# 1. List available MCP servers
+osvm mcp list
+
+# Expected output:
+# Available MCP Servers:
+# - github-mcp-server (✅ Running)
+# - filesystem-server (⏸ Stopped)
+# - database-server (✅ Running)
+
+# 2. Start an MCP server
+osvm mcp start filesystem-server
+
+# Expected output:
+# 🚀 Starting MCP server: filesystem-server
+# ✅ Server started in 50ms (unikernel mode)
+# 📊 Status: Running
+# 🔒 Isolation: Hardware-enforced
+
+# 3. List available tools from MCP server
+osvm mcp tools github-mcp-server
+
+# Expected output:
+# Available Tools (github-mcp-server):
+# - search_repositories: Search GitHub repositories
+# - get_file_contents: Read file from repository
+# - list_commits: List commits in repository
+# [... more tools ...]
+
+# 4. Call an MCP tool
+osvm mcp call github-mcp-server search_repositories \
+  --query "solana program examples"
+
+# Expected output:
+# 📊 Results from github-mcp-server:
+# Found 42 repositories:
+# 1. solana-labs/solana-program-library (⭐ 2.1k)
+# 2. coral-xyz/anchor (⭐ 1.8k)
+# [... more results ...]
+```
+
+### 🧪 OVSM Research Workflow
+
+```bash
+# 1. Execute an OVSM query for blockchain analysis
+osvm ovsm execute --query "What is the average transaction fee?"
+
+# Expected output:
+# 🔬 OVSM Research Query
+# Query: "What is the average transaction fee?"
+# 
+# [TIME: ~45s] [COST: ~0.002 SOL] [CONFIDENCE: 85%]
+# 
+# Analysis:
+# Average fee: 0.000005 SOL (5,000 lamports)
+# Sample size: 10,000 transactions
+# Timeframe: Last 100 blocks
+# 
+# Detailed Statistics:
+# - Mean: 0.000005 SOL
+# - Median: 0.000005 SOL  
+# - 95th percentile: 0.000008 SOL
+# - Std dev: 0.000002 SOL
+
+# 2. Analyze specific account activity
+osvm "Show me the transaction history for account DezX..."
+
+# 3. Detect MEV opportunities
+osvm ovsm execute --query "Find recent MEV arbitrage opportunities"
+
+# 4. Smart money tracking
+osvm "Track whales moving more than 1000 SOL in the last hour"
+```
+
+### 📸 Snapshot Analysis Workflow
+
+```bash
+# 1. Export snapshot accounts to JSON
+osvm snapshot export \
+  --snapshot-dir /path/to/snapshot \
+  --output accounts.json \
+  --format json
+
+# Expected output:
+# 📦 Exporting snapshot...
+# ✅ Exported 1,234,567 accounts
+# 💾 Output: accounts.json (245 MB)
+# ⏱️  Time: 12.3s
+
+# 2. Find high-value accounts (whale hunting)
+osvm snapshot read \
+  --snapshot-dir /path/to/snapshot \
+  --min-balance 1000 \
+  --limit 100
+
+# Expected output:
+# 🐋 Top 100 accounts by balance:
+# 1. 7xKx...abc123: 1,234,567 SOL
+# 2. BPF1...xyz789: 987,654 SOL
+# [... more accounts ...]
+
+# 3. Analyze token accounts
+osvm snapshot read \
+  --filter-owner TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA \
+  --limit 100
+
+# 4. Compare two snapshots
+osvm snapshot compare \
+  --snapshot-dir /path/to/snapshot1 \
+  --other /path/to/snapshot2
+
+# Expected output:
+# 📊 Snapshot Comparison:
+# New accounts: 12,345
+# Deleted accounts: 8,901
+# Modified accounts: 45,678
+# Total lamports change: +123,456,789
+```
+
+### 🔐 Security Best Practices Workflow
+
+```bash
+# 1. Generate secure keypairs
+osvm keygen --output mainnet-validator.json
+chmod 600 mainnet-validator.json
+
+# 2. Audit your program before deployment
+osvm audit ./my-program --severity high
+
+# Expected output:
+# 🔒 Security Audit Results:
+# HIGH: 0 vulnerabilities
+# MEDIUM: 2 vulnerabilities
+# LOW: 5 vulnerabilities
+# 
+# Details:
+# [M1] Missing signer check in transfer function
+#   File: src/lib.rs:45
+#   Recommendation: Add signer validation
+
+# 3. Deploy with security verification
+osvm deploy-program \
+  --program target/deploy/my_program.so \
+  --audit-first \
+  --network mainnet
+
+# 4. Monitor for security issues
+osvm monitor-security --continuous --alerts
+```
+
+### 💡 Quick Tips
+
+```bash
+# Get help for any command
+osvm --help
+osvm deploy-validator --help
+
+# Use verbose mode for debugging
+osvm --verbose deploy-validator --host user@server
+
+# Check version
+osvm --version
+
+# Interactive AI chat mode
+osvm chat
+
+# List all available examples
+osvm examples --list-categories
+```
+
+**📚 For more examples, see [docs/examples.md](docs/examples.md)**
+
+---
+
 ## 🏗️ Architecture
 
 <div align="center">