feat: persist match events and idempotency receipts in SQLite

.github/scripts/sqlite-query-check.py

@@ -0,0 +1,28 @@
+"""Prepare a migration-derived schema and verify SQLx offline query metadata."""
+import json
+import os
+from pathlib import Path
+import sqlite3
+import sys
+
+work = Path(os.environ["GFA_SQLX_WORK_DIR"])
+database = work / "schema.sqlite"
+queries = work / "queries"
+
+if sys.argv[1] == "prepare":
+    queries.mkdir(parents=True, exist_ok=True)
+    database.unlink(missing_ok=True)
+    for path in queries.glob("query-*.json"):
+        path.unlink()
+    with sqlite3.connect(database) as connection:
+        for migration in sorted(Path("crates/adapters/gfa-store/migrations/sqlite").glob("*.sql")):
+            connection.executescript(migration.read_text())
+elif sys.argv[1] == "verify":
+    def metadata(directory):
+        return {path.name: json.loads(path.read_text()) for path in directory.glob("query-*.json")}
+
+    generated = metadata(queries)
+    if not generated or generated != metadata(Path(".sqlx")):
+        raise SystemExit("SQLx metadata is missing or stale; regenerate it from the migrations.")
+else:
+    raise SystemExit("usage: sqlite-query-check.py prepare|verify")

.github/workflows/ci.yml

@@ -15,7 +15,18 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
       - uses: Swatinem/rust-cache@v2
+      - name: Prepare SQLite schema for query checking
+        run: python3 .github/scripts/sqlite-query-check.py prepare
+        env:
+          GFA_SQLX_WORK_DIR: ${{ runner.temp }}/gfa-sqlx
       - run: cargo test --workspace --all-features --locked
+        env:
+          DATABASE_URL: sqlite:${{ runner.temp }}/gfa-sqlx/schema.sqlite
+          SQLX_OFFLINE_DIR: ${{ runner.temp }}/gfa-sqlx/queries
+      - name: Verify offline query metadata
+        run: python3 .github/scripts/sqlite-query-check.py verify
+        env:
+          GFA_SQLX_WORK_DIR: ${{ runner.temp }}/gfa-sqlx
       - run: cargo xtask check-deps
       - run: cargo check -p gfa-games --no-default-features --locked
   lint: