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.
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# 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
|
|
|
|
1. Create module in `src/vlm/commands/`.
|
|
2. Define with `@click.command()`.
|
|
3. Import and register in `src/vlm/cli.py` via `main.add_command(...)`.
|
|
|
|
## Key Models
|
|
|
|
See `src/vlm/models.py`: `VideoFile`, `MovieIdentity`, `SeriesIdentity`, `FileOperation`, `ExecutionPlan`.
|