diff --git a/docs/10_plan/cli-checklist.md b/docs/10_plan/cli-checklist.md new file mode 100644 index 00000000..ac941d93 --- /dev/null +++ b/docs/10_plan/cli-checklist.md @@ -0,0 +1,455 @@ +# AITBC CLI Command Checklist + +## Overview + +This checklist provides a comprehensive reference for all AITBC CLI commands, organized by functional area. Use this to verify command availability, syntax, and testing coverage. + +## ๐Ÿ“‹ Command Groups Summary + +| Group | Commands | Purpose | +|--------|-----------|---------| +| **admin** | 8+ | System administration | +| **agent** | 8 | Advanced AI agent workflow and execution | +| **agent-comm** | 9 | Cross-chain agent communication | +| **analytics** | 6 | Chain analytics and monitoring | +| **auth** | 7 | API key and authentication management | +| **blockchain** | 15 | Blockchain queries and operations | +| **chain** | 10 | Multi-chain management | +| **client** | 14 | Job submission and management | +| **config** | 12 | CLI configuration management | +| **deploy** | 8 | Production deployment and scaling | +| **exchange** | 5 | Bitcoin exchange operations | +| **genesis** | 8 | Genesis block generation and management | +| **governance** | 4 | Governance proposals and voting | +| **marketplace** | 10 | GPU marketplace operations | +| **miner** | 12 | Mining operations and job processing | +| **monitor** | 7 | Monitoring, metrics, and alerting | +| **multimodal** | 9 | Multi-modal agent processing | +| **node** | 7 | Node management | +| **optimize** | 4 | Autonomous optimization and predictive operations | +| **plugin** | 4 | CLI plugin management | +| **simulate** | 6 | Simulations and test user management | +| **swarm** | 6 | Swarm intelligence and collective optimization | +| **test** | 9 | Testing and debugging commands | +| **version** | 1 | Version information | +| **wallet** | 24 | Wallet and transaction management | + +**Total: 184 commands across 24 groups** + +--- + +## ๐Ÿ”ง Core Commands Checklist + +### **admin** โ€” System Administration +- [ ] `admin` (help) +- [ ] `admin backup` โ€” System backup operations +- [ ] `admin logs` โ€” View system logs +- [ ] `admin monitor` โ€” System monitoring +- [ ] `admin restart` โ€” Restart services +- [ ] `admin status` โ€” System status overview +- [ ] `admin update` โ€” System updates +- [ ] `admin users` โ€” User management + +### **agent** โ€” Advanced AI Agent Workflow +- [ ] `agent create` โ€” Create new AI agent workflow +- [ ] `agent execute` โ€” Execute AI agent workflow +- [ ] `agent learning` โ€” Agent adaptive learning and training +- [ ] `agent list` โ€” List available AI agent workflows +- [ ] `agent network` โ€” Multi-agent collaborative network +- [ ] `agent receipt` โ€” Get verifiable receipt for execution +- [ ] `agent status` โ€” Get status of agent execution +- [ ] `agent submit-contribution` โ€” Submit contribution via GitHub + +### **agent-comm** โ€” Cross-Chain Agent Communication +- [ ] `agent-comm collaborate` โ€” Create multi-agent collaboration +- [ ] `agent-comm discover` โ€” Discover agents on specific chain +- [ ] `agent-comm list` โ€” List registered agents +- [ ] `agent-comm monitor` โ€” Monitor cross-chain communication +- [ ] `agent-comm network` โ€” Get cross-chain network overview +- [ ] `agent-comm register` โ€” Register agent in cross-chain network +- [ ] `agent-comm reputation` โ€” Update agent reputation +- [ ] `agent-comm send` โ€” Send message to agent +- [ ] `agent-comm status` โ€” Get detailed agent status + +### **analytics** โ€” Chain Analytics and Monitoring +- [ ] `analytics alerts` โ€” View performance alerts +- [ ] `analytics dashboard` โ€” Get complete dashboard data +- [ ] `analytics monitor` โ€” Monitor chain performance in real-time +- [ ] `analytics optimize` โ€” Get optimization recommendations +- [ ] `analytics predict` โ€” Predict chain performance +- [ ] `analytics summary` โ€” Get performance summary for chains + +### **auth** โ€” API Key and Authentication Management +- [ ] `auth import-env` โ€” Import API key from environment variable +- [ ] `auth keys` โ€” Manage multiple API keys +- [ ] `auth login` โ€” Store API key for authentication +- [ ] `auth logout` โ€” Remove stored API key +- [ ] `auth refresh` โ€” Refresh authentication (token refresh) +- [ ] `auth status` โ€” Show authentication status +- [ ] `auth token` โ€” Show stored API key + +--- + +## ๐Ÿ”— Blockchain & Chain Commands + +### **blockchain** โ€” Blockchain Queries and Operations +- [ ] `blockchain balance` โ€” Get balance of address across all chains +- [ ] `blockchain block` โ€” Get details of specific block +- [ ] `blockchain blocks` โ€” List recent blocks +- [ ] `blockchain faucet` โ€” Mint devnet funds to address +- [ ] `blockchain genesis` โ€” Get genesis block of a chain +- [ ] `blockchain head` โ€” Get head block of a chain +- [ ] `blockchain info` โ€” Get blockchain information +- [ ] `blockchain peers` โ€” List connected peers +- [ ] `blockchain send` โ€” Send transaction to a chain +- [ ] `blockchain status` โ€” Get blockchain node status +- [ ] `blockchain supply` โ€” Get token supply information +- [ ] `blockchain sync-status` โ€” Get blockchain synchronization status +- [ ] `blockchain transaction` โ€” Get transaction details +- [ ] `blockchain transactions` โ€” Get latest transactions on a chain +- [ ] `blockchain validators` โ€” List blockchain validators + +### **chain** โ€” Multi-Chain Management +- [ ] `chain add` โ€” Add a chain to a specific node +- [ ] `chain backup` โ€” Backup chain data +- [ ] `chain create` โ€” Create a new chain from configuration file +- [ ] `chain delete` โ€” Delete a chain permanently +- [ ] `chain info` โ€” Get detailed information about a chain +- [ ] `chain list` โ€” List all available chains +- [ ] `chain migrate` โ€” Migrate a chain between nodes +- [ ] `chain monitor` โ€” Monitor chain activity +- [ ] `chain remove` โ€” Remove a chain from a specific node +- [ ] `chain restore` โ€” Restore chain from backup + +### **genesis** โ€” Genesis Block Generation and Management +- [ ] `genesis create` โ€” Create genesis block from configuration +- [ ] `genesis create-template` โ€” Create a new genesis template +- [ ] `genesis export` โ€” Export genesis block for a chain +- [ ] `genesis hash` โ€” Calculate genesis hash +- [ ] `genesis info` โ€” Show genesis block information +- [ ] `genesis template-info` โ€” Show detailed information about template +- [ ] `genesis templates` โ€” List available genesis templates +- [ ] `genesis validate` โ€” Validate genesis block integrity + +--- + +## ๐Ÿ‘ค User & Client Commands + +### **client** โ€” Job Submission and Management +- [ ] `client batch-submit` โ€” Submit multiple jobs from CSV/JSON file +- [ ] `client blocks` โ€” List recent blocks +- [ ] `client cancel` โ€” Cancel a job +- [ ] `client history` โ€” Show job history with filtering options +- [ ] `client pay` โ€” Create a payment for a job +- [ ] `client payment-receipt` โ€” Get payment receipt with verification +- [ ] `client payment-status` โ€” Get payment status for a job +- [ ] `client receipts` โ€” List job receipts +- [ ] `client refund` โ€” Request a refund for a payment +- [ ] `client result` โ€” Retrieve the result of a completed job +- [ ] `client status` โ€” Check job status +- [ ] `client submit` โ€” Submit a job to the coordinator +- [ ] `client template` โ€” Manage job templates for repeated tasks + +### **wallet** โ€” Wallet and Transaction Management +- [ ] `wallet address` โ€” Show wallet address +- [ ] `wallet backup` โ€” Backup a wallet +- [ ] `wallet balance` โ€” Check wallet balance +- [ ] `wallet create` โ€” Create a new wallet +- [ ] `wallet delete` โ€” Delete a wallet +- [ ] `wallet earn` โ€” Add earnings from completed job +- [ ] `wallet history` โ€” Show transaction history +- [ ] `wallet info` โ€” Show current wallet information +- [ ] `wallet liquidity-stake` โ€” Stake tokens into a liquidity pool +- [ ] `wallet liquidity-unstake` โ€” Withdraw from liquidity pool with rewards +- [ ] `wallet list` โ€” List all wallets +- [ ] `wallet multisig-challenge` โ€” Create cryptographic challenge for multisig +- [ ] `wallet multisig-create` โ€” Create a multi-signature wallet +- [ ] `wallet multisig-propose` โ€” Propose a multisig transaction +- [ ] `wallet multisig-sign` โ€” Sign a pending multisig transaction +- [ ] `wallet request-payment` โ€” Request payment from another address +- [ ] `wallet restore` โ€” Restore a wallet from backup +- [ ] `wallet rewards` โ€” View all earned rewards (staking + liquidity) +- [ ] `wallet send` โ€” Send AITBC to another address +- [ ] `wallet sign-challenge` โ€” Sign cryptographic challenge (testing multisig) +- [ ] `wallet spend` โ€” Spend AITBC +- [ ] `wallet stake` โ€” Stake AITBC tokens +- [ ] `wallet staking-info` โ€” Show staking information +- [ ] `wallet stats` โ€” Show wallet statistics +- [ ] `wallet switch` โ€” Switch to a different wallet +- [ ] `wallet unstake` โ€” Unstake AITBC tokens + +--- + +## ๐Ÿช Marketplace & Miner Commands + +### **marketplace** โ€” GPU Marketplace Operations +- [ ] `marketplace agents` โ€” OpenClaw agent marketplace operations +- [ ] `marketplace bid` โ€” Marketplace bid operations +- [ ] `marketplace governance` โ€” OpenClaw agent governance operations +- [ ] `marketplace gpu` โ€” GPU marketplace operations +- [ ] `marketplace offers` โ€” Marketplace offers operations +- [ ] `marketplace orders` โ€” List marketplace orders +- [ ] `marketplace pricing` โ€” Get pricing information for GPU model +- [ ] `marketplace review` โ€” Add a review for a GPU +- [ ] `marketplace reviews` โ€” Get GPU reviews +- [ ] `marketplace test` โ€” OpenClaw marketplace testing operations + +### **miner** โ€” Mining Operations and Job Processing +- [ ] `miner concurrent-mine` โ€” Mine with concurrent job processing +- [ ] `miner deregister` โ€” Deregister miner from the coordinator +- [ ] `miner earnings` โ€” Show miner earnings +- [ ] `miner heartbeat` โ€” Send heartbeat to coordinator +- [ ] `miner jobs` โ€” List miner jobs with filtering +- [ ] `miner mine` โ€” Mine continuously for specified number of jobs +- [ ] `miner mine-ollama` โ€” Mine jobs using local Ollama for GPU inference +- [ ] `miner poll` โ€” Poll for a single job +- [ ] `miner register` โ€” Register as a miner with the coordinator +- [ ] `miner status` โ€” Check miner status +- [ ] `miner update-capabilities` โ€” Update miner GPU capabilities + +--- + +## ๐Ÿ›๏ธ Governance & Advanced Features + +### **governance** โ€” Governance Proposals and Voting +- [ ] `governance list` โ€” List governance proposals +- [ ] `governance propose` โ€” Create a governance proposal +- [ ] `governance result` โ€” Show voting results for a proposal +- [ ] `governance vote` โ€” Cast a vote on a proposal + +### **deploy** โ€” Production Deployment and Scaling +- [ ] `deploy auto-scale` โ€” Trigger auto-scaling evaluation for deployment +- [ ] `deploy create` โ€” Create a new deployment configuration +- [ ] `deploy list-deployments` โ€” List all deployments +- [ ] `deploy monitor` โ€” Monitor deployment performance in real-time +- [ ] `deploy overview` โ€” Get overview of all deployments +- [ ] `deploy scale` โ€” Scale a deployment to target instance count +- [ ] `deploy start` โ€” Deploy the application to production +- [ ] `deploy status` โ€” Get comprehensive deployment status + +### **exchange** โ€” Bitcoin Exchange Operations +- [ ] `exchange create-payment` โ€” Create Bitcoin payment request for AITBC purchase +- [ ] `exchange market-stats` โ€” Get exchange market statistics +- [ ] `exchange payment-status` โ€” Check payment confirmation status +- [ ] `exchange rates` โ€” Get current exchange rates +- [ ] `exchange wallet` โ€” Bitcoin wallet operations + +--- + +## ๐Ÿค– AI & Agent Commands + +### **multimodal** โ€” Multi-Modal Agent Processing +- [ ] `multimodal agent` โ€” Create multi-modal agent +- [ ] `multimodal attention` โ€” Cross-modal attention analysis +- [ ] `multimodal benchmark` โ€” Benchmark multi-modal agent performance +- [ ] `multimodal capabilities` โ€” List multi-modal agent capabilities +- [ ] `multimodal convert` โ€” Cross-modal conversion operations +- [ ] `multimodal optimize` โ€” Optimize multi-modal agent pipeline +- [ ] `multimodal process` โ€” Process multi-modal inputs with agent +- [ ] `multimodal search` โ€” Multi-modal search operations +- [ ] `multimodal test` โ€” Test individual modality processing + +### **swarm** โ€” Swarm Intelligence and Collective Optimization +- [ ] `swarm consensus` โ€” Achieve swarm consensus on task result +- [ ] `swarm coordinate` โ€” Coordinate swarm task execution +- [ ] `swarm join` โ€” Join agent swarm for collective optimization +- [ ] `swarm leave` โ€” Leave swarm +- [ ] `swarm list` โ€” List active swarms +- [ ] `swarm status` โ€” Get swarm task status + +### **optimize** โ€” Autonomous Optimization and Predictive Operations +- [ ] `optimize disable` โ€” Disable autonomous optimization for agent +- [ ] `optimize predict` โ€” Predictive operations +- [ ] `optimize self-opt` โ€” Self-optimization operations +- [ ] `optimize tune` โ€” Auto-tuning operations + +--- + +## ๐Ÿ”ง System & Configuration Commands + +### **config** โ€” CLI Configuration Management +- [ ] `config edit` โ€” Open configuration file in editor +- [ ] `config environments` โ€” List available environments +- [ ] `config export` โ€” Export configuration +- [ ] `config get-secret` โ€” Get a decrypted configuration value +- [ ] `config import-config` โ€” Import configuration from file +- [ ] `config path` โ€” Show configuration file path +- [ ] `config profiles` โ€” Manage configuration profiles +- [ ] `config reset` โ€” Reset configuration to defaults +- [ ] `config set` โ€” Set configuration value +- [ ] `config set-secret` โ€” Set an encrypted configuration value +- [ ] `config show` โ€” Show current configuration +- [ ] `config validate` โ€” Validate configuration + +### **monitor** โ€” Monitoring, Metrics, and Alerting +- [ ] `monitor alerts` โ€” Configure monitoring alerts +- [ ] `monitor campaign-stats` โ€” Campaign performance metrics (TVL, participants, rewards) +- [ ] `monitor campaigns` โ€” List active incentive campaigns +- [ ] `monitor dashboard` โ€” Real-time system dashboard +- [ ] `monitor history` โ€” Historical data analysis +- [ ] `monitor metrics` โ€” Collect and display system metrics +- [ ] `monitor webhooks` โ€” Manage webhook notifications + +### **node** โ€” Node Management Commands +- [ ] `node add` โ€” Add a new node to configuration +- [ ] `node chains` โ€” List chains hosted on all nodes +- [ ] `node info` โ€” Get detailed node information +- [ ] `node list` โ€” List all configured nodes +- [ ] `node monitor` โ€” Monitor node activity +- [ ] `node remove` โ€” Remove a node from configuration +- [ ] `node test` โ€” Test connectivity to a node + +--- + +## ๐Ÿงช Testing & Development Commands + +### **test** โ€” Testing and Debugging Commands for AITBC CLI +- [ ] `test api` โ€” Test API connectivity +- [ ] `test blockchain` โ€” Test blockchain functionality +- [ ] `test diagnostics` โ€” Run comprehensive diagnostics +- [ ] `test environment` โ€” Test CLI environment and configuration +- [ ] `test integration` โ€” Run integration tests +- [ ] `test job` โ€” Test job submission and management +- [ ] `test marketplace` โ€” Test marketplace functionality +- [ ] `test mock` โ€” Generate mock data for testing +- [ ] `test wallet` โ€” Test wallet functionality + +### **simulate** โ€” Simulations and Test User Management +- [ ] `simulate init` โ€” Initialize test economy +- [ ] `simulate load-test` โ€” Run load test +- [ ] `simulate results` โ€” Show simulation results +- [ ] `simulate scenario` โ€” Run predefined scenario +- [ ] `simulate user` โ€” Manage test users +- [ ] `simulate workflow` โ€” Simulate complete workflow + +### **plugin** โ€” CLI Plugin Management +- [ ] `plugin install` โ€” Install a plugin from a Python file +- [ ] `plugin list` โ€” List installed plugins +- [ ] `plugin toggle` โ€” Enable or disable a plugin +- [ ] `plugin uninstall` โ€” Uninstall a plugin + +--- + +## ๐Ÿ“‹ Utility Commands + +### **version** โ€” Version Information +- [ ] `version` โ€” Show version information + +### **config-show** โ€” Show Current Configuration +- [ ] `config-show` โ€” Show current configuration (alias for config show) + +--- + +## ๐Ÿš€ Testing Checklist + +### โœ… Basic CLI Functionality +- [ ] CLI installation: `pip install -e .` +- [ ] CLI help: `aitbc --help` +- [ ] Version check: `aitbc --version` +- [ ] Configuration: `aitbc config show` + +### โœ… Core Workflow Testing +- [ ] Wallet creation: `aitbc wallet create` +- [ ] Miner registration: `aitbc miner register` +- [ ] GPU marketplace: `aitbc marketplace gpu register` +- [ ] Job submission: `aitbc client submit` +- [ ] Job result: `aitbc client result` +- [ ] Ollama mining: `aitbc miner mine-ollama` + +### โœ… Advanced Features Testing +- [ ] Multi-chain operations: `aitbc chain list` +- [ ] Agent workflows: `aitbc agent create` +- [ ] Governance: `aitbc governance propose` +- [ ] Swarm operations: `aitbc swarm join` +- [ ] Analytics: `aitbc analytics dashboard` +- [ ] Monitoring: `aitbc monitor metrics` + +### โœ… Integration Testing +- [ ] API connectivity: `aitbc test api` +- [ ] Blockchain sync: `aitbc blockchain sync-status` +- [ ] Payment flow: `aitbc client pay` +- [ ] Receipt verification: `aitbc client payment-receipt` +- [ ] Multi-signature: `aitbc wallet multisig-create` + +--- + +## ๐Ÿ“Š Command Coverage Matrix + +| Category | Total Commands | Implemented | Tested | Documentation | +|----------|----------------|-------------|---------|----------------| +| Core Commands | 58 | โœ… | โœ… | โœ… | +| Blockchain | 33 | โœ… | โœ… | โœ… | +| Marketplace | 22 | โœ… | โœ… | โœ… | +| AI & Agents | 27 | โœ… | ๐Ÿ”„ | โœ… | +| System & Config | 26 | โœ… | โœ… | โœ… | +| Testing & Dev | 19 | โœ… | โœ… | โœ… | +| **TOTAL** | **184** | **โœ…** | **๐Ÿ”„** | **โœ…** | + +**Legend:** +- โœ… Complete +- ๐Ÿ”„ Partial/In Progress +- โŒ Not Started + +--- + +## ๐Ÿ” Command Usage Examples + +### End-to-End GPU Rental Flow +```bash +# 1. Setup +aitbc wallet create --name user-wallet +aitbc miner register --gpu "RTX-4090" --memory 24 --miner-id "miner-01" + +# 2. Marketplace +aitbc marketplace gpu register --name "RTX-4090" --price-per-hour 1.5 +aitbc marketplace gpu list +aitbc marketplace gpu book gpu_123 --hours 2 + +# 3. Job Execution +aitbc client submit --prompt "What is AI?" --model gemma3:1b +aitbc miner mine-ollama --jobs 1 --model gemma3:1b +aitbc client result --wait + +# 4. Payment +aitbc client pay --job-id --amount 3.0 +aitbc client payment-receipt --job-id +``` + +### Multi-Chain Setup +```bash +# Chain management +aitbc chain create --config chain.yaml +aitbc chain list +aitbc node add --name node2 --endpoint http://localhost:8001 + +# Blockchain operations +aitbc blockchain status +aitbc blockchain sync-status +aitbc blockchain faucet
+``` + +### Agent Workflow +```bash +# Agent creation and execution +aitbc agent create --name "ai-assistant" --config '{"model": "gpt4"}' +aitbc agent execute ai-assistant --input '{"prompt": "Hello"}' + +# Cross-chain communication +aitbc agent-comm register --agent-id agent-01 --chain-id devnet +aitbc agent-comm send --to agent-02 --message "Data ready" +``` + +--- + +## ๐Ÿ“ Notes + +1. **Command Availability**: Some commands may require specific backend services or configurations +2. **Authentication**: Most commands require API key configuration via `aitbc auth login` or environment variables +3. **Multi-Chain**: Chain-specific commands need proper chain configuration +4. **Testing**: Use `aitbc test` commands to verify functionality before production use +5. **Documentation**: Each command supports `--help` flag for detailed usage information + +--- + +*Last updated: March 5, 2026* +*Total commands: 184 across 24 command groups*