docs: Add missing source files to architecture docs (#150)

docs/architecture.md

@@ -351,3 +351,11 @@ Integration with [Glances](https://nicolargo.github.io/glances/) for real-time h
 - Fetches CPU, memory, and load from Glances REST API on each host
 - Used by web UI dashboard to display host resource usage
 - Requires `glances_stack` config option pointing to a Glances stack running on all hosts
+
+### Container Registry Client (`src/compose_farm/registry.py`)
+
+OCI Distribution API client for checking image updates:
+
+- Parses image references (registry, namespace, name, tag, digest)
+- Fetches available tags from Docker Hub, GHCR, and other registries
+- Compares semantic versions to find newer releases

docs/commands.md

@@ -73,7 +73,7 @@ cf apply [OPTIONS]
 | `--dry-run, -n` | Preview changes without executing |
 | `--no-orphans` | Skip stopping orphaned stacks |
 | `--no-strays` | Skip stopping stray stacks (running on wrong host) |
-| `--full, -f` | Also refresh running stacks |
+| `--full, -f` | Also run up on all stacks (applies compose/env changes, triggers migrations) |
 | `--config, -c PATH` | Path to config file |
 
 **What it does:**
@@ -98,7 +98,7 @@ cf apply --no-orphans
 # Don't stop stray stacks
 cf apply --no-strays
 
-# Also refresh all running stacks
+# Also run up on all stacks (applies compose/env changes, triggers migrations)
 cf apply --full
 ```