Initialize WCX collection project

.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/**

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.

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.