urban/WCX-collection
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document collection scripts and diagnostics

Browse Source
This commit is contained in:
Urban
2026-07-19 18:56:41 +02:00
parent 916ac982f7
commit 8fe68d684e
2 changed files with 5 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
AGENTS.md
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. 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. 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. Do not commit databases, video files, generated reports, credentials, or Python caches.

4
README.md
View File

@ -8,4 +8,6 @@ The reference database is owned by a separate project and must only be opened wi
File operations must be conservative. Any functionality that renames, moves, or removes files should normally support or require a dry run before applying changes. File operations must be conservative. Any functionality that renames, moves, or removes files should normally support or require a dry run before applying changes.
Implementation has not been copied into this repository yet. `scripts/match_filenames.py` matches local video files against the external reference database. `scripts/diagnose_duration_match.py` is a manual diagnostic tool that compares one local file with current and historical durations for a specified `movie.id`; it is not an automated test.
Both scripts require an explicit `--database` argument and open the reference database strictly read-only with SQLite `mode=ro`.