feat: Add image management commands for ECR registry

- Add `conserver images` subcommand with:
  - list: List local and remote images
  - pull: Pull images from registry
  - use: Switch to a specific version
  - upgrade: Upgrade to newer version
  - downgrade: Downgrade to older version
  - info: Show image details
  - remove: Remove local images
  - prune: Clean up old images

- Add ImageRegistry class for ECR/GHCR/Docker Hub support
- Add ImageError and RegistryError exceptions
- Add 43 new tests for image functionality
- Update documentation and README
- Bump version to 0.2.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: howethomas

CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-01-24
+
+### Added
+
+- Image management commands: `images list`, `images pull`, `images use`, `images upgrade`, `images downgrade`, `images info`, `images remove`, `images prune`
+- Support for AWS ECR public registry (public.ecr.aws/r4g1k2s3/vcon-dev/vcon-server)
+- Version comparison for semantic versioning
+- Remote tag listing from container registries
+- Local image management and cleanup
+
+### Changed
+
+- Updated documentation with image management commands
+- Added `ImageError` and `RegistryError` exceptions
+
 ## [0.1.0] - 2025-01-23
 
 ### Added
@@ -23,5 +38,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Comprehensive test suite with 80%+ coverage
 - Full documentation
 
-[Unreleased]: https://github.com/vcon-dev/vcon-server-cli/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/vcon-dev/vcon-server-cli/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/vcon-dev/vcon-server-cli/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/vcon-dev/vcon-server-cli/releases/tag/v0.1.0

README.md

@@ -26,6 +26,7 @@ conserver logs -f
 ## Features
 
 - **Container Management**: Start, stop, restart, and upgrade vcon-server containers
+- **Image Management**: List, pull, upgrade, and downgrade vcon-server images from ECR
 - **Configuration Management**: View, edit, and validate configuration files
 - **Health Monitoring**: Check service health with detailed diagnostics
 - **Log Viewing**: Stream and filter container logs
@@ -161,6 +162,37 @@ conserver config set links.transcribe.options.model_size large --file config
 conserver config validate
 ```
 
+### Image Management
+
+```bash
+# List available remote tags
+conserver images list --remote
+
+# List local images
+conserver images list
+
+# Pull specific version
+conserver images pull v1.2.0
+
+# Pull latest main branch
+conserver images pull main
+
+# Switch to a version (and restart)
+conserver images use v1.2.0 --restart
+
+# Upgrade to latest version
+conserver images upgrade
+
+# Downgrade to older version
+conserver images downgrade v1.1.0
+
+# Show image info
+conserver images info v1.2.0
+
+# Remove old images (keep 3 most recent)
+conserver images prune
+```
+
 ### Server Path
 
 By default, conserver looks for the vcon-server installation in:
@@ -188,6 +220,11 @@ conserver start
 | `conserver health` | Check service health |
 | `conserver logs` | View container logs |
 | `conserver upgrade` | Upgrade to latest version |
+| `conserver images list` | List available images |
+| `conserver images pull` | Pull an image |
+| `conserver images use` | Switch to a version |
+| `conserver images upgrade` | Upgrade image version |
+| `conserver images downgrade` | Downgrade image version |
 | `conserver config show` | Show configuration |
 | `conserver config edit` | Edit configuration |
 | `conserver config set` | Set a config value |

conserver/__init__.py

@@ -2,5 +2,5 @@
 Conserver CLI - A command-line tool to manage vcon-server Docker containers.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __app_name__ = "conserver"

conserver/cli.py

@@ -10,6 +10,7 @@
 
 from conserver import __app_name__, __version__
 from conserver.commands import config as config_cmd
+from conserver.commands import images as images_cmd
 from conserver.commands.logs import logs
 from conserver.commands.restart import restart
 from conserver.commands.start import start
@@ -32,6 +33,9 @@
 # Add config subcommand
 app.add_typer(config_cmd.app, name="config")
 
+# Add images subcommand
+app.add_typer(images_cmd.app, name="images")
+
 # Add commands
 app.command()(start)
 app.command()(stop)