837 B
Repository Guidelines
This repository owns local file inventory and matching behavior. It does not own the WCX reference database, its schema, metadata, OCR, history, or aliases.
Always treat the reference database as an external dependency and open it strictly read-only with SQLite mode=ro. Store any future local paths, collection state, or matching decisions separately.
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.
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.