commit 2963d456e72e45047652a5a7d66546db34dcd7b9 Author: Urban Date: Sun Jul 19 16:43:05 2026 +0200 Initialize WCX collection project diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..1cc248a --- /dev/null +++ b/.gitignore @@ -0,0 +1,50 @@ +# Python +__pycache__/ +*.py[cod] +.venv/ + +# SQLite and local runtime state +*.db +*.db-shm +*.db-wal +*.db-journal +*.sqlite +*.sqlite-shm +*.sqlite-wal +*.sqlite-journal +*.sqlite3 +*.sqlite3-shm +*.sqlite3-wal +*.sqlite3-journal +runtime/ +reports/ +*.report +*.report.* +report-*.csv +report-*.json +report-*.tsv +report-*.txt + +# Local media +media/ +videos/ +*.3gp +*.avi +*.flv +*.m2ts +*.m4v +*.mkv +*.mov +*.mp4 +*.mpeg +*.mpg +*.mts +*.ogv +*.ts +*.vob +*.webm +*.wmv + +# Intentionally versioned test fixtures +!tests/fixtures/ +!tests/fixtures/** diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..00e6c13 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,11 @@ +# 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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..1bb0cdb --- /dev/null +++ b/README.md @@ -0,0 +1,11 @@ +# WCX Collection + +Tools for inventorying and matching local video files against the external WCX reference database. + +The reference database is owned by a separate project and must only be opened with SQLite `mode=ro`. This repository must not store reference metadata or write local file state to that database. + +`movie.id` is the stable external identity for references to movies in the reference database. The initial implementation requires an explicit `--database` argument and must not assume a default database location. + +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. diff --git a/docs/.gitkeep b/docs/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/.gitkeep b/scripts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/tests/.gitkeep b/tests/.gitkeep new file mode 100644 index 0000000..e69de29