refactor CLI command modules and synchronize docs

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## Project Structure & Module Organization
 - Core package lives in `src/vlm/`.
-- CLI entrypoint is `src/vlm/cli.py` (`vlm` console script). Commands use `pass_context` and `CLIContext` from `context.py`; some command logic lives in `commands/` (e.g. `scan`, `analyze`, `plan`).
+- CLI entrypoint is `src/vlm/cli.py` (`vlm` console script). Commands use `pass_context` and `CLIContext` from `context.py`; command logic is modularized in `commands/` (e.g. `scan`, `parse`, `enrich`, `analyze`, `plan`, `execute`).
 - Functional modules by concern: scanning (`scanner.py`), parsing (`parser.py`), enrichment (`enrichment.py`, `cache.py`, `providers/`), analysis/planning/execution (`analysis.py`, `planner.py`, `executor.py`), I/O helpers (`io.py`), utilities (`utils.py`), state/reporting/logging (`state.py`, `reports.py`, `logging_config.py`), config (`config.py`), models (`models.py`).
 - Tests live in `tests/` and mirror feature areas (e.g. `tests/test_scanner.py`, `tests/test_cli_state.py`, `tests/test_enrichment.py`).
 - Project metadata and tool config are in `pyproject.toml`.
@@ -36,3 +36,8 @@
 ## Security & Configuration Tips
 - Do not commit local paths, personal media metadata, or generated state/log artifacts.
 - Validate config changes against `vlm --help` and at least one end-to-end CLI flow before merging.
+
+
+## Documentation baseline
+- Updated to reflect refactor results as of 2026-02-16.
+- Canonical release notes are tracked in `CHANGELOG.md`.