docs(examples): Reorganize and document real-world OVSM examples

- Rename from_tmp/ to real_world/ for clarity
- Update README.md with categorized examples:
  - Async & Streaming
  - AI & Agents
  - DeFi & Governance
  - Wallet & Token Analysis
  - On-Chain Operations
- Document deployed programs on Solana devnet
- Add --auto and --query flags to research command

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: 0xrinegade

crates/ovsm/examples/README.md

@@ -89,8 +89,72 @@ cargo run --example run_file your_script.ovsm
 3. **Ranges:** `[1..10]` creates range 1-9 (exclusive end)
 4. **Comments:** Use `//` for single-line comments
 
+## Real-World Examples (`real_world/`)
+
+Production-ready OVSM scripts demonstrating advanced patterns:
+
+### Async & Streaming
+| Script | Description |
+|--------|-------------|
+| `async_stream_example.ovsm` | Async stream processing with backpressure handling |
+| `event_driven_stream.ovsm` | Event-driven architecture patterns |
+
+### AI & Agents
+| Script | Description |
+|--------|-------------|
+| `ai_compatibility_demo.ovsm` | AI model integration patterns |
+| `onchain_ai_agent.ovsm` | Fully on-chain AI agent (11KB) |
+
+### DeFi & Governance
+| Script | Description |
+|--------|-------------|
+| `dao_simulation.ovsm` | Complete DAO governance simulation |
+| `pumpfun_graduation_tracker.ovsm` | Track pump.fun token graduations to Raydium |
+| `grad_tracker_final.ovsm` | Optimized graduation tracker |
+| `whale_hunter.ovsm` | Whale wallet detection and tracking (11KB) |
+
+### Wallet & Token Analysis
+| Script | Description |
+|--------|-------------|
+| `wallet_discovery_deep.ovsm` | Multi-hop wallet relationship discovery |
+| `analyze_wallet.ovsm` | Basic wallet activity analysis |
+| `token_analysis_paginated.ovsm` | Paginated token flow analysis |
+| `token_flow_analysis.ovsm` | Track token movement patterns |
+| `working_token_analysis.ovsm` | Complete token analysis workflow |
+
+### On-Chain Operations
+| Script | Description |
+|--------|-------------|
+| `sol_transfer.ovsm` | Native SOL transfer via system program |
+| `spl_token_transfer_signed.ovsm` | SPL token transfer with PDA signing |
+| `ovsm_full_analysis.ovsm` | Comprehensive market analysis |
+| `final_demo.ovsm` | Feature demonstration script |
+
+### Running Real-World Examples
+
+```bash
+# Using OSVM CLI
+osvm ovsm run crates/ovsm/examples/real_world/whale_hunter.ovsm
+
+# Check syntax only
+osvm ovsm check crates/ovsm/examples/real_world/dao_simulation.ovsm
+
+# Compile to Solana BPF
+osvm ovsm compile crates/ovsm/examples/real_world/onchain_ai_agent.ovsm -o agent.so
+```
+
+## Deployed Programs (Devnet)
+
+These OVSM programs are live on Solana devnet:
+
+| Program | Program ID | Description |
+|---------|-----------|-------------|
+| Strategy Registry | `1yEJEpCk1cKDmVGC7iFp8pf9EUcvKkczUmgHWKeX7p2` | Hot-swappable agent strategies |
+| Basic Strategy | `2uiPuUnNjh4R1x3bwiX3ZRzqr7gbQyYtZ2PvXwU68xyh` | Entry-level agent strategy |
+
 ## See Also
 
 - `../USAGE_GUIDE.md` - Complete language reference
 - `../TEST_RESULTS_SUMMARY.md` - Implementation status
 - `../tests/` - Unit test examples
+- `../../examples/ovsm_scripts/` - More OVSM program examples