Add Comprehensive Management CLI with Rich Formatting

[tbille]

Summary

Transforms the any-llm CLI from a simple decryption tool into a full-featured management interface for the any-llm platform. This PR adds complete CRUD operations for projects, provider keys, budgets, and clients with modern terminal formatting and multiple output formats.

Key Features

🔧 Management Operations

• Project Management: Create, list, update, and delete projects
• Provider Key Management: CRUD operations with encryption key generation and automatic migration
• Budget Management: Create and manage budgets with period-based tracking (daily/weekly/monthly)
• Client Management: Full client lifecycle management with default client support

🎨 Enhanced UX

• Rich table formatting with adaptive terminal width
• Multiple output formats: table (default), JSON, YAML
• Smart column truncation for narrow terminals
• Authentication flow with token management and automatic refresh

🔐 Security Features

• Encryption key generation with X25519 keypair creation
• Automatic key migration when rotating encryption keys
• Token-based authentication with 24-hour expiration and refresh logic

📚 Documentation

• Agent-first development guide (AGENTS.md) as knowledge map
• Restructured architecture docs into docs/architecture/
• Comprehensive CLI usage guide with examples for all commands
• Code style guide and development workflow documentation

Changes

Added:

• client_management.py - Management API client with authentication (851 lines)
• Crypto utilities for encryption, key generation, and formatting
• Rich CLI with command groups: project, key, budget, client
• Comprehensive test suite (404 new test lines)
• Agent development guide and structured documentation

Enhanced:

• CLI expanded from 25 to 1,112 lines with management commands
• Client with token authentication and automatic refresh
• README with complete CLI documentation

Dependencies:

• pyyaml - YAML output format support
• rich - Terminal formatting and tables

Testing

• ✅ All 48 tests passing
• ✅ Unit tests for CLI command structure and help text
• ✅ Integration tests for authentication flows and management operations
• ✅ Output format validation (table/JSON/YAML)

Backward Compatibility

All changes are fully backward compatible:

• Existing decrypt functionality preserved and unchanged
• New commands are additive, not breaking
• Environment variables maintain same behavior
• Library API unchanged for programmatic usage

Example Usage

# Authenticate
export ANY_LLM_USERNAME="user@example.com"
export ANY_LLM_PASSWORD="password"

# Manage projects
any-llm project list
any-llm project create "My Project"

# Generate new encryption key with migration
any-llm key generate <project-id> --old-key "ANY.v1...."

# List provider keys
any-llm key list <project-id>

# JSON output for scripting
any-llm --format json project list | jq '.data[0].id'

Commits

This PR consists of 11 atomic commits following single-responsibility principle:

1. Dependencies (pyyaml, rich)
2. Infrastructure (.gitignore updates)
3. Crypto utilities (encryption, key generation)
4. Management API client
5. Client integration (token auth)
6. Documentation restructure
7. Agent development guide
8. CLI expansion with management commands
9. Comprehensive test suite
10. README updates
11. Development tooling

---

Stats: +4,636 lines, -57 lines across 18 files