improve review-plan preview output and docs

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 2026-04-02
+
+### Schema Validation & Deterministic Planning
+
+- Added runtime validation for `identities.json`, `analysis.json`, and `plan.json` on load/save.
+- Plan generation now records environment-derived checks in `validation_snapshot` metadata, keeping logical plan output reproducible.
+- Added targeted regression tests for plan round-trip validation and invalid-schema rejection.
+- Verified the affected workflows with `uv run pytest tests/test_io.py tests/test_planner.py`.
+
+
+### Logic Optimization & Human-in-the-Loop
+
+- **Human-in-the-Loop Workflow Completion**:
+  - Added `vlm apply-review` command to sync modifications from `plan_manual_review.csv` back to `plan.json`.
+  - Implemented `apply_review_to_plan` in `src/vlm/planner.py` to allow manual rejection/modification of high-risk operations via CSV.
+
+- **Scanner Robustness & Environment Awareness**:
+  - Added proactive `ffprobe` availability check at the start of `vlm scan`.
+  - Implemented graceful degradation: if `ffprobe` is missing, the scanner automatically falls back to file-only metadata mode with a clear warning, instead of failing per-file.
+
+- **Parser Enhancements**:
+  - Improved `src/vlm/parser.py` to better handle release group tags (`[Group]`, `(Group)`, `Group_Subs`).
+  - Added support for hyphenated episode numbering (e.g., `Name - 01`) common in Anime, defaulting to Season 1 with reduced confidence.
+  - Refined release group removal to be more robust against various bracket styles.
+
+- **CLI & UX**:
+  - `vlm review-plan` now prints a plan overview plus a structured high-risk operation preview in terminal output.
+  - Added `--preview-limit` and `--show-all` to control review-plan preview verbosity.
+  - Added shared plan rendering helpers so `review-plan` and `execute` reuse the same summary fallback behavior.
+  - Added `vlm apply-review` to the main CLI group.
+
 ## 2026-02-16
 
 ### Artifact Path Governance