windyboy
dfa18ed405
DLO-13: Restructure vlm-library-workflow skill as safety contract layer. - Rewrite SKILL.md (69 lines): safety contract, execution threshold semantics, six-step high-risk loop, decision rules, phase skeleton - Delete redundant references (cli-reference, workflow, command-recipes, dev-guide) - Add triage.md (failure mapping + preflight) and dev-map.md (module→test mapping) - Add tests/test_docs_consistency.py: 78 parametrized tests verifying documented vlm commands exist in CLI registry - Add CSV path mismatch test to test_plan_review.py (4th safety gate path) - Delete vlm-expert.skill (Gemini package, 7 months stale) and README Gemini section DLO-2 audit fixes: rate limiter injection, symmetric quarantine categories, review-plan safety gates, parser improvements, planner validation. CLI modularization: commands/ directory with one module per command group.
1.1 KiB
1.1 KiB
Developer Map
Module → Test → Verification
| Module | Tests | When to run |
|---|---|---|
scanner.py |
tests/test_scanner.py |
File discovery, metadata extraction |
parser.py |
tests/test_parser.py |
Filename parsing changes |
enrichment.py, providers/ |
tests/test_enrichment.py |
TMDB/API changes |
planner.py |
tests/test_planner.py |
Operation generation, duplicate resolution |
executor.py |
tests/test_executor.py |
File operations, rollback |
plan_review.py |
tests/test_plan_review.py |
Review gate, CSV handling |
commands/*.py |
tests/test_cli_*.py |
CLI flag/behavior changes |
analysis.py |
tests/test_analysis_properties.py |
Property-based tests (Hypothesis) |
| Full integration | pytest |
Before any commit |
Adding a New Command
- Create module in
src/vlm/commands/. - Define with
@click.command(). - Import and register in
src/vlm/cli.pyviamain.add_command(...).
Key Models
See src/vlm/models.py: VideoFile, MovieIdentity, SeriesIdentity, FileOperation, ExecutionPlan.