md-06 - backup commands

[azzazzel]

Problem

The CLI lacked comprehensive backup management capabilities, which are essential for data protection and disaster recovery workflows. Additionally, collection commands were using inconsistent styling, validation, and error handling compared to the improved index commands. The error handling system was also limited to index-specific operations, making it difficult to provide consistent user-friendly error messages across all commands.

Solution

This PR introduces complete backup management functionality and unifies the styling, validation, and error handling across all vector database commands. The changes include:

• Complete Backup Management: Added full CRUD operations for backups, including create, list, describe, delete, and restore commands
• Unified Error Handling: Generalized the error handling system from HandleIndexAPIError to HandleAPIError for consistent user-friendly error messages across all commands
• Consistent Styling: Updated collection commands to use the same styling system, presenters, and validation patterns as index commands
• Positional Arguments: Made backup IDs positional arguments for delete and describe commands, following the same pattern as index commands
• Dedicated Presenters: Created specialized presenters for backup and collection data display with consistent formatting and styling
• Validation Utilities: Added validation utilities for backup and collection operations to ensure data integrity
• Improved Documentation: Enhanced help text and examples for all backup and collection commands

The implementation ensures a consistent user experience across all vector database operations while providing essential backup management capabilities for production environments.

Type of Change

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update
• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Infrastructure change (CI configs, etc)
• Non-code change (docs, etc)
• None of the above: (explain here)

Test Plan

1. Backup Management Testing: Test all backup operations:

   # Create a backup
   pc backup create --name my-backup --source my-serverless-index
   
   # List backups
   pc backup list
   
   # Describe a backup
   pc backup describe backup-123
   
   # Restore from backup
   pc backup restore --index restored-index --backup-id backup-123
   
   # Delete a backup
   pc backup delete backup-123

2. Collection Command Testing: Test updated collection commands with unified styling:

   # Test collection operations with new styling
   pc collection list
   pc collection describe my-collection
   pc collection create --name my-collection --source my-pod-index
   pc collection delete my-collection

3. Error Handling Testing: Test consistent error handling across all commands:

   # Test error handling for invalid operations
   pc backup describe invalid-backup-id
   pc collection describe invalid-collection
   pc index describe invalid-index
   
   # Test verbose error messages
   pc backup create --name test --source invalid-index --verbose

4. Positional Arguments Testing: Test positional argument usage:

   # Test backup commands with positional arguments
   pc backup describe backup-123
   pc backup delete backup-123
   
   # Test collection commands with positional arguments
   pc collection describe my-collection
   pc collection delete my-collection

5. Styling Consistency Testing: Verify consistent styling across all commands:

   # Compare styling between index, collection, and backup commands
   pc index list
   pc collection list
   pc backup list
   
   # Test describe commands styling
   pc index describe my-index
   pc collection describe my-collection
   pc backup describe backup-123

6. Integration Testing: Test backup and collection commands with other features:

   # Test with --assume-yes flag
   pc backup delete backup-123 -y
   pc collection delete my-collection -y
   
   # Test with --json flag
   pc backup list --json
   pc collection list --json

This PR enhances the vector database management capabilities by adding essential backup functionality while ensuring a consistent and polished user experience across all commands. It builds on top of #38 and contains all the changes from the previous branches in the series.