feat: add Prism snake and gameplay database lifecycle

- Add bitboard-accelerated Prism and versioned Supreme snake implementations.
- Add database-backed move benchmarks and focused strategy tests.
- Normalize gameplay storage while preserving replay compatibility.
- Add deterministic game quality scoring and replay retention tiers.
- Add backup-first SQLite cleanup, verification, and replacement tooling.
- Add safe compact-plus-delta database merging with conflict detection.
- Extend SQLite and PostgreSQL schemas for replay and quality metadata.
- Add PostgreSQL development service and pytest import configuration.
- Update gameplay documentation and the quart_common submodule revision.

tests/test_GameplayDatabase.py

@@ -88,6 +88,27 @@ class TestGameplayDatabase(unittest.IsolatedAsyncioTestCase):
       turns_count = connection.execute("SELECT COUNT(*) FROM turns WHERE game_id = ?", ("game-abc",)).fetchone()[0]
       self.assertEqual(turns_count, 2)
 
+      compact_turn = connection.execute("""
+        SELECT snakes_json, you_json, food_json, hazards_json
+        FROM turns WHERE game_id = ? AND turn = ?
+      """, ("game-abc", 2)).fetchone()
+      self.assertEqual(compact_turn, ("[]", "{}", '[{"x":2,"y":2}]', "[]"))
+      stored_body = connection.execute("""
+        SELECT body_json FROM snake_turns
+        WHERE game_id = ? AND turn = ? AND snake_id = ?
+      """, ("game-abc", 2, "me")).fetchone()[0]
+      self.assertNotEqual(stored_body, "[]")
+      identities = connection.execute("""
+        SELECT snake_id, snake_name, is_you FROM game_snakes
+        WHERE game_id = ? ORDER BY snake_id
+      """, ("game-abc",)).fetchall()
+      self.assertEqual(identities, [("enemy", "Enemy", 0), ("me", "Me", 1)])
+      repeated_identity = connection.execute("""
+        SELECT snake_name, is_you FROM snake_turns
+        WHERE game_id = ? AND turn = ? AND snake_id = ?
+      """, ("game-abc", 2, "me")).fetchone()
+      self.assertEqual(repeated_identity, (None, 0))
+
       me_inferred = connection.execute("SELECT inferred_move FROM snake_turns WHERE game_id = ? AND turn = ? AND snake_id = ?", ("game-abc", 2, "me")).fetchone()[0]
       enemy_inferred = connection.execute("SELECT inferred_move FROM snake_turns WHERE game_id = ? AND turn = ? AND snake_id = ?", ("game-abc", 2, "enemy")).fetchone()[0]
       self.assertEqual(me_inferred, "up")
@@ -104,6 +125,9 @@ class TestGameplayDatabase(unittest.IsolatedAsyncioTestCase):
       self.assertEqual(len(replay["turns"]), 2)
       self.assertEqual(replay["turns"][1]["my_move"], "up")
       self.assertEqual(replay["turns"][1]["my_thinking"]["reason"], "food")
+      self.assertEqual(replay["turns"][1]["food"], [{"x": 2, "y": 2}])
+      self.assertEqual(replay["turns"][1]["you"]["id"], "me")
+      self.assertEqual(len(replay["turns"][1]["snakes"][0]["body"]), 3)
 
       connection.close()