Update documentation and README files to reflect current CLI structure and features

[devin-ai-integration]

Update documentation and README files to reflect current CLI structure and features

Summary

This PR comprehensively updates the Talos documentation to accurately reflect the current CLI structure and capabilities. The main changes include:

• Enhanced main README.md with complete CLI commands table, non-interactive mode documentation, and reorganized environment variables
• Created new CLI documentation for previously undocumented modules: proposals, memory, and arbiscan
• Updated existing CLI docs with comprehensive usage examples and detailed command documentation
• Expanded CONTRIBUTING.md with detailed development guidelines and testing procedures
• Updated installation docs with current Python version requirements and new environment variables

The documentation now provides complete coverage of all CLI modules and includes practical usage examples, error handling information, and integration details.

Review & Testing Checklist for Human

• Test all documented CLI commands - Verify each command works as documented, especially the new modules (proposals, memory, arbiscan) and ensure all usage examples are functional
• Verify environment variable categorization - Confirm that the required vs optional categorization in README.md matches actual runtime requirements
• Validate Python version requirement - Test that Python 3.12+ is actually required or if it can work with earlier versions
• Test installation procedures - Follow the updated installation docs end-to-end to ensure all steps work correctly
• Cross-reference CLI implementation - Compare documented commands with actual CLI code to catch any discrepancies

Recommended test plan: Set up a fresh environment, follow the installation docs, and test each CLI module with the provided examples to ensure everything works as documented.

---

Diagram

%%{ init : { "theme" : "default" }}%%
graph TD
    README["README.md<br/>Main project documentation"]:::major-edit
    CLI_README["src/talos/cli/README.md<br/>CLI documentation"]:::major-edit
    CONTRIBUTING["CONTRIBUTING.md<br/>Development guidelines"]:::major-edit
    
    CLI_OVERVIEW["docs/cli/overview.md"]:::minor-edit
    INSTALL["docs/getting-started/installation.md"]:::minor-edit
    
    PROPOSALS["docs/cli/proposals.md<br/>(NEW)"]:::major-edit
    MEMORY["docs/cli/memory.md<br/>(NEW)"]:::major-edit
    ARBISCAN["docs/cli/arbiscan.md<br/>(NEW)"]:::major-edit
    
    CLI_TWITTER["docs/cli/twitter.md"]:::minor-edit
    CLI_GITHUB["docs/cli/github.md"]:::minor-edit
    
    CLI_MAIN["src/talos/cli/main.py<br/>CLI implementation"]:::context
    
    README --> CLI_README
    CLI_README --> PROPOSALS
    CLI_README --> MEMORY  
    CLI_README --> ARBISCAN
    CLI_OVERVIEW --> CLI_TWITTER
    CLI_OVERVIEW --> CLI_GITHUB
    CLI_MAIN --> CLI_README
    
    subgraph Legend
        L1["Major Edit"]:::major-edit
        L2["Minor Edit"]:::minor-edit
        L3["Context/No Edit"]:::context
    end
    
    classDef major-edit fill:#90EE90
    classDef minor-edit fill:#87CEEB
    classDef context fill:#FFFFFF

Loading

Notes

• Environment Issue: There's a uv.lock parsing error that prevented testing the CLI commands locally, so the documentation accuracy relies on source code analysis rather than live testing
• Comprehensive Coverage: This PR adds documentation for three previously undocumented CLI modules (proposals, memory, arbiscan) that were missing from the docs
• Environment Variables: Reorganized into required vs optional categories - this categorization should be verified against actual runtime behavior
• Python Version: Updated requirement to 3.12+ based on development setup, but this should be confirmed

Link to Devin run: https://app.devin.ai/sessions/af1d480cf4c942048d902ff91894f2b3
Requested by: @talos-agent

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring