From 8fe68d684eeb846ec2a729da2774176293b7296c Mon Sep 17 00:00:00 2001 From: Urban Date: Sun, 19 Jul 2026 18:56:41 +0200 Subject: [PATCH] Document collection scripts and diagnostics --- AGENTS.md | 2 ++ README.md | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 00e6c13..c665c13 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. diff --git a/README.md b/README.md index 1bb0cdb..0ad2caf 100644 --- a/README.md +++ b/README.md @@ -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. -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`.