Document collection scripts and diagnostics

This commit is contained in:
2026-07-19 18:56:41 +02:00
parent 916ac982f7
commit 8fe68d684e
2 changed files with 5 additions and 1 deletions

View File

@ -6,6 +6,8 @@ Always treat the reference database as an external dependency and open it strict
Use `movie.id` as the stable external identity when referring to a reference-database movie. The initial implementation must require an explicit `--database` argument; do not add an implicit reference-database path.
`scripts/match_filenames.py` performs filename matching. `scripts/diagnose_duration_match.py` is a manual duration diagnostic that identifies the reference movie by stable `movie.id`; it is not an automated test. Both scripts require an explicit `--database` argument and must open the reference database strictly read-only with SQLite `mode=ro`.
Keep file operations conservative. Operations that rename, move, or remove files must normally support or require a dry run before applying changes.
Do not commit databases, video files, generated reports, credentials, or Python caches.