refactor CLI command modules and synchronize docs

skills/vlm-library-workflow/SKILL.md

@@ -1,3 +1,6 @@
+# Documentation Status
+- Synced with refactor baseline on 2026-02-16.
+
 ---
 name: vlm-library-workflow
 description: Operate and extend the Video Library Manager (`vlm`) with a safety-first, human-in-the-loop workflow across scan, parse, enrich, analyze, plan, review-plan, execute, rollback, and developer verification. Use when requests involve organizing a video library, producing or reviewing `inventory.csv`/`identities.json`/`analysis.json`/`plan.json`, tuning VLM config templates, resolving duplicates or episode gaps, running dry-run/confirm execution, recovering changes via rollback, explaining VLM CLI usage, or developing/modifying VLM features (parser, providers, planner, executor, commands, tests).

skills/vlm-library-workflow/references/cli-reference.md

@@ -1,3 +1,6 @@
+# Documentation Status
+- Updated to current CLI options on 2026-02-16.
+
 # VLM CLI Reference
 
 ## Configuration
@@ -11,7 +14,7 @@
 - `vlm enrich [--input JSON] [--output JSON] [--refresh-all]`: Fetch TMDB metadata.
 - `vlm analyze [--input JSON] [--output JSON]`: Find gaps and duplicates.
 - `vlm plan [--input JSON] [--analysis JSON] [--output JSON]`: Generate operations.
-- `vlm execute [--plan JSON] [--confirm]`: Move/Rename files.
+- `vlm execute [--plan JSON] [--confirm] [--yes] [--verbose-ops] [--safe-mode] [--preserve-directories]`: Move/Rename/Quarantine operations with safety guards.
 - `vlm rollback [--log PATH]`: Undo operations.
 
 ## Management & Reporting
@@ -22,5 +25,5 @@
 ## Important Config Options (`~/.vlm/config.yaml`)
 - `library_root`: Path to the video collection.
 - `templates`: Naming patterns for movies and series.
-- `plan.duplicate_keep`: Strategy for duplicates (`by_quality`, `by_reputation`, `first_seen`, `manual`).
+- `plan.duplicate_keep`: Strategy for duplicates (`by_quality`, `by_reputation`, `by_reputation_quality_time`, `first_seen`, `manual`).
 - `enrichment.api_keys`: TMDB and OpenAI keys.

skills/vlm-library-workflow/references/command-recipes.md

@@ -1,3 +1,6 @@
+# Documentation Status
+- Synced with refactor baseline on 2026-02-16.
+
 # VLM Command Recipes
 
 ## Baseline

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`

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

@@ -1,3 +1,6 @@
+# Documentation Status
+- Synced with refactor baseline on 2026-02-16.
+
 # VLM Workflow Guide
 
 This guide details the standard end-to-end process for organizing a video library using VLM.