refactor CLI command modules and synchronize docs

skills/vlm-library-workflow/references/dev-guide.md

@@ -1,7 +1,10 @@
+# Documentation Status
+- Updated for the modular command architecture on 2026-02-16.
+
 # VLM Developer Guide
 
 ## Project Structure
-- `src/vlm/cli.py`: Entry point and command definitions.
+- `src/vlm/cli.py`: Entry point and thin command wrappers.
 - `src/vlm/parser.py`: Regex-based filename parsing logic.
 - `src/vlm/enrichment.py`: Pipeline for external metadata fetching.
 - `src/vlm/providers/`: API implementations (e.g., TMDB).
@@ -11,7 +14,7 @@
 ## Adding a New Command
 1. Create a new module in `src/vlm/commands/`.
 2. Define the command using `@click.command()`.
-3. Register it in `src/vlm/cli.py` using `main.add_command()`.
+3. Register it in `src/vlm/cli.py` with a Click-decorated function that delegates to the module implementation.
 
 ## Modifying the Parser
 - The parser uses a sequence of regex patterns in `src/vlm/parser.py`.
@@ -21,8 +24,8 @@
 ## Data Models
 See `src/vlm/models.py` for core data structures:
 - `VideoFile`: Basic file metadata.
-- `MediaIdentity`: Parsed and enriched information.
-- `PlanOperation`: Definition of a file move/rename/quarantine.
+- `MovieIdentity` / `SeriesIdentity`: Parsed/enriched identity records.
+- `FileOperation`: Definition of a move/rename/quarantine/no-op/preserve-directory operation.
 
 ## Testing
 - **Unit Tests**: `pytest`