Files

T

windyboy dfa18ed405 refactor: consolidate skill docs, add anti-drift tests, and apply audit fixes

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.

2026-09-25 13:50:09 +08:00

1.1 KiB

Raw Blame History

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.py via main.add_command(...).

Key Models

See src/vlm/models.py: VideoFile, MovieIdentity, SeriesIdentity, FileOperation, ExecutionPlan.

1.1 KiB Raw Blame History

Developer Map

Module → Test → Verification

Adding a New Command

Key Models

1.1 KiB

Raw Blame History