Enhance project structure and add new files for enrichment and analysis

- Updated AGENTS.md to reflect changes in CLI commands and module organization, including the addition of an enrichment step and new functional modules.
- Introduced analysis.json, identities.json, inventory.csv, and plan.json to support enriched metadata and execution planning.
- Added CODE_IMPROVEMENTS.md to document identified code issues and proposed solutions for future enhancements.
- Updated README.md to include new enrichment features and configuration options.
- Removed unused dependency on ffmpeg-python from pyproject.toml.

These changes improve the overall functionality and maintainability of the Video Library Manager project.

CLAUDE.md

@@ -40,6 +40,7 @@ vlm config init
 # Common workflow
 vlm scan                    # Discover files
 vlm parse                   # Extract identities
+vlm enrich                  # (Optional) Enrich titles/reputation via TMDB
 vlm analyze                 # Detect gaps/duplicates
 vlm plan                    # Generate execution plan
 vlm execute                 # Dry-run (default)
@@ -52,15 +53,21 @@ vlm execute --confirm       # Actually execute
 VLM follows a read-first, multi-stage pipeline:
 1. **Scan** → discovers video files, extracts metadata via ffprobe (optional), saves to inventory.csv
 2. **Parse** → extracts titles/years/seasons/episodes from filenames, saves to identities.json
-3. **Analyze** → detects episode gaps and duplicates, saves to analysis.json
-4. **Plan** → generates reviewable execution plan (plan.json) with file operations
-5. **Execute** → performs file operations (dry-run by default, --confirm to execute)
-6. **Rollback** → reverses executed operations (best-effort)
+3. **Enrich** (optional) → adds bilingual titles and reputation (TMDB); updates identities.json in place; uses SQLite cache for incremental runs
+4. **Analyze** → detects episode gaps and duplicates, saves to analysis.json
+5. **Plan** → generates reviewable execution plan (plan.json) with file operations
+6. **Execute** → performs file operations (dry-run by default, --confirm to execute)
+7. **Rollback** → reverses executed operations (best-effort)
 
 ### Module Organization
-- `cli.py` - Click-based CLI interface, command definitions, all user-facing commands
+- `cli.py` - Click-based CLI interface, global options, command registration
+- `context.py` - CLIContext (config, paths) and pass_context for commands
+- `commands/` - Command implementations (scan, analyze, plan)
 - `scanner.py` - File discovery using system `find` command, metadata extraction via ffprobe
 - `parser.py` - Filename parsing using regex patterns (movies: title + year, series: SxxExx)
+- `enrichment.py` - Enrichment pipeline; `cache.py` - SQLite cache; `providers/` - TMDB etc.
+- `io.py` - Load/save identities JSON/CSV, plan/analysis input helpers
+- `utils.py` - UTC time, format_size, shared helpers
 - `analysis.py` - Completeness checking (episode gaps) and duplicate detection
 - `planner.py` - Execution plan generation with conflict detection
 - `executor.py` - File operations (move/rename/quarantine) with rollback logging
@@ -108,6 +115,7 @@ Key settings:
 - `quarantine_dir` - name of quarantine directory (default: `.quarantine`)
 - `log_level` - logging verbosity
 - `categories` - mapping of category names to directory name lists
+- `enrichment` (or `enrich`) - TMDB/api_keys, cache_db, translation, reputation; see README for full schema
 
 ### Category Mappings