Merge gitea/main, preserving release v0.2.2 stability and CLI documentation

docs/beginner/05_cli/README.md

@@ -15,25 +15,39 @@
 
 ### Installation and Setup
 ```bash
-# Load development environment
-source /opt/aitbc/.env.dev
-
 # Test CLI installation
 aitbc --help
 aitbc version
 ```
 
+**Note**: The CLI is pre-configured with a bash alias for automatic virtual environment activation:
+```bash
+# The following alias is configured in ~/.bashrc:
+alias aitbc="source /opt/aitbc/cli/venv/bin/activate && aitbc"
+```
+
+This allows you to use `aitbc <command>` directly without manually sourcing the virtual environment.
+
 ### Basic Operations
 ```bash
-# Wallet operations
-aitbc wallet create
-aitbc wallet list
-aitbc wallet balance
+# Core operations
+aitbc client submit --prompt "Generate an image" --model llama2
+aitbc miner status
+aitbc wallet create --type hd
+aitbc marketplace list
+aitbc blockchain info
+aitbc exchange create-pair --pair AITBC/BTC --base-asset AITBC --quote-asset BTC
+aitbc explorer status
+aitbc explorer block 12345
+aitbc explorer transaction 0x123...
+aitbc explorer search --address 0xabc...
 
-# Exchange operations
-aitbc exchange register --name "Binance" --api-key <key>
-aitbc exchange create-pair AITBC/BTC
-aitbc exchange start-trading --pair AITBC/BTC
+# Advanced features
+aitbc analytics summary
+aitbc ai-trading start --strategy arbitrage
+aitbc compliance kyc-submit --user-id user123
+aitbc agent create --type trading
+aitbc multimodal process --input image.jpg --mode text
 
 # AI Trading & Analytics
 aitbc ai-trading start --strategy mean_reversion
@@ -119,35 +133,52 @@ aitbc-services restart
 - `wallet backup` - Backup wallet
 - `wallet restore` - Restore wallet
 
-### **Exchange Commands**
-- `exchange register` - Register with exchange
-- `exchange create-pair` - Create trading pair
-- `exchange start-trading` - Start trading
-- `exchange stop-trading` - Stop trading
-- `exchange status` - Exchange status
-- `exchange balances` - Exchange balances
+### **Advanced Features**
+- `analytics` - Chain performance monitoring and predictions
+- `ai-trading` - AI-powered trading strategies
+- `surveillance` - Market surveillance and compliance
+- `compliance` - Regulatory compliance and reporting
+- `governance` - Network governance and proposals
 
-### **Blockchain Commands**
-- `blockchain info` - Blockchain information
-- `blockchain status` - Node status
-- `blockchain blocks` - List blocks
-- `blockchain balance` - Check balance
-- `blockchain peers` - Network peers
-- `blockchain transaction` - Transaction details
+### **Development Tools**
+- `admin` - Administrative operations
+- `config` - Configuration management
+- `monitor` - System monitoring and health
+- `test` - CLI testing and validation
+- `deploy` - Deployment and infrastructure management
 
-### **Config Commands**
-- `config show` - Show configuration
-- `config get <key>` - Get config value
-- `config set <key> <value>` - Set config value
-- `config edit` - Edit configuration
-- `config validate` - Validate configuration
+### **Specialized Services**
+- `agent` - AI agent operations
+- `multimodal` - Multi-modal AI processing
+- `oracle` - Price discovery and data feeds
+- `market-maker` - Automated market making
+- `genesis-protection` - Advanced security features
+- `swarm` - Swarm intelligence operations
+- `ai` - AI provider commands
 
-### **Compliance Commands**
-- `compliance list-providers` - List KYC providers
-- `compliance kyc-submit` - Submit KYC verification
-- `compliance kyc-status` - Check KYC status
-- `compliance aml-screen` - AML screening
-- `compliance full-check` - Full compliance check
+### **Enterprise Integration**
+- `enterprise-integration` - Enterprise system integration
+- `cross-chain` - Cross-chain operations
+- `regulatory` - Regulatory reporting
+
+### **Security & Authentication**
+- `auth` - Authentication and token management
+- `keystore` - Key management
+- `multisig` - Multi-signature operations
+- `genesis` - Genesis block operations
+
+### **Network & Infrastructure**
+- `node` - Node management
+- `chain` - Chain operations
+- `sync` - Synchronization operations
+- `optimize` - Performance optimization
+
+### **Plugin System**
+- `plugin` - Plugin management
+- `plugin-registry` - Plugin registry
+- `plugin-marketplace` - Plugin marketplace
+- `plugin-security` - Plugin security
+- `plugin-analytics` - Plugin analytics
 
 ## 🧪 **Testing**
 
@@ -192,9 +223,6 @@ python3 run_simple_tests.py
 
 ### Environment Variables
 ```bash
-# Load development environment
-source /opt/aitbc/.env.dev
-
 # Available aliases
 aitbc-services    # Service management
 aitbc-fix         # Quick permission fix
@@ -210,13 +238,30 @@ aitbc --output json wallet balance
 aitbc --output yaml blockchain info
 
 # Debug mode
-aitbc --debug wallet list
+aitbc --debug client submit --prompt "Test"
 
 # Test mode
 aitbc --test-mode exchange status
 
 # Custom configuration
 aitbc --config-file /path/to/config wallet list
+
+# Dry run mode
+aitbc --dry-run deploy --target production
+
+# Custom timeout
+aitbc --timeout 60 blockchain info
+
+# Custom API endpoint
+aitbc --url http://localhost:8000 blockchain status
+
+# Custom API key
+aitbc --api-key <key> exchange register --name "Exchange"
+
+# Verbosity levels
+aitbc -v client list
+aitbc -vv marketplace show --job-id 123
+aitbc -vvv admin system-status
 ```
 
 ### Service Integration
@@ -229,6 +274,27 @@ aitbc --api-key <key> exchange register --name "Exchange"
 
 # Timeout configuration
 aitbc --timeout 60 blockchain info
+
+# Skip SSL verification (testing only)
+aitbc --no-verify --test-mode client status
+
+# Plugin management
+aitbc plugin list
+aitbc plugin install --name gpu-optimizer
+aitbc plugin enable --name monitoring
+
+# Multi-modal processing
+aitbc multimodal process --input document.pdf --modes text,image
+aitbc multimodal status --job-id 12345
+
+# AI operations
+aitbc ai list-providers
+aitbc ai generate --provider ollama --model llama2 --prompt "Summarize"
+
+# Agent operations
+aitbc agent create --type trading --name trader1
+aitbc agent start --agent-id trader1
+aitbc agent status --agent-id trader1
 ```
 
 ## 🔍 **Troubleshooting**
@@ -254,13 +320,14 @@ aitbc --test-mode blockchain status
 ## 📚 **Additional Resources**
 
 - [Testing Procedures](./testing.md) - Detailed testing documentation
-- [Permission Setup](./permission-setup.md) - Development environment configuration
 - [Service Management](../8_development/) - Service operation guides
 - [Exchange Integration](../19_marketplace/) - Exchange and trading documentation
 
 ---
 
-**Last Updated**: March 8, 2026  
+**Last Updated**: March 25, 2026  
 **CLI Version**: 0.1.0  
 **Test Coverage**: 67/67 tests passing (100%)  
-**Infrastructure**: Complete
+**Infrastructure**: Complete  
+**Command Groups**: 45+ command groups available  
+**Plugin System**: Full plugin architecture supported