fix(annotations): move image revisions when a fingerprint or the vocabulary changes

A replayed save that observes a new verified (size, mtime_ns) now bumps
image_index_revision, like refresh_image_fingerprint, so caches keyed
on it see the record become current again; an identical replay still
moves nothing.

Vocabulary rename, merge and delete (native and legacy paths) bump the
tag_revision of every image set carrying the source tag, in the same
transaction and before the links move or cascade, plus one
image_index_revision bump when any set was affected. A Tag dialog
opened before the change therefore gets tag-conflict with the renamed
set as current instead of recreating the old name.

database/annotations.py

@@ -49,7 +49,7 @@ _INSERT_OWNER = (
     f"INSERT INTO {FILES_TABLE}(id,locator,created_at) VALUES(?,?,?)"  # nosec B608
 )
 _BYTE = (
-    f"SELECT id,tag_revision FROM {BYTES_TABLE} "  # nosec B608
+    f"SELECT id,tag_revision,size,mtime_ns FROM {BYTES_TABLE} "  # nosec B608
     "WHERE file_id=? AND sha256=?"
 )
 _INSERT_BYTE = (
@@ -229,10 +229,13 @@ class AnnotationOperations:
         size: int,
         mtime_ns: int,
         now: str,
-    ) -> tuple[str, int, bool]:
+    ) -> tuple[str, int, bool, bool]:
         """The byte record for these bytes, refreshed or created.
 
-        Returns ``(id, tag_revision, created)``.
+        Returns ``(id, tag_revision, created, refingerprinted)``; the last is
+        True when an existing record's verified ``(size, mtime_ns)`` changed,
+        which moves its currency for cheap reads (the caller bumps the index
+        revision when nothing else does).
         """
         row = conn.execute(_BYTE, (file_id, sha256)).fetchone()
         if row is None:
@@ -240,9 +243,9 @@ class AnnotationOperations:
             conn.execute(
                 _INSERT_BYTE, (byte_id, file_id, sha256, size, mtime_ns, now, now)
             )
-            return byte_id, 0, True
+            return byte_id, 0, True, False
         conn.execute(_REFRESH_BYTE, (size, mtime_ns, now, row[0]))
-        return row[0], row[1], False
+        return row[0], row[1], False, (row[2], row[3]) != (size, mtime_ns)
 
     @staticmethod
     def _byte_tags(conn: sqlite3.Connection, byte_id: str) -> list[str]:
@@ -311,7 +314,7 @@ class AnnotationOperations:
             epoch = self._library_epoch(conn, expected_epoch)
             now = utc_now_iso()
             file_id = self._annotation_owner(conn, locator, now)
-            byte_id, revision, created = self._annotation_byte(
+            byte_id, revision, created, refingerprinted = self._annotation_byte(
                 conn, file_id, sha256, size, mtime_ns, now
             )
             current = self._byte_tags(conn, byte_id)
@@ -320,6 +323,8 @@ class AnnotationOperations:
                 and current == tags
                 and expected_tag_revision in (revision, revision - 1)
             ):
+                if refingerprinted:
+                    conn.execute(_BUMP_INDEX)
                 return _receipt(epoch, sha256, current, revision, True)
             if expected_tag_revision != revision:
                 raise AnnotationCommandError(
@@ -353,7 +358,7 @@ class AnnotationOperations:
             epoch = self._library_epoch(conn, expected_epoch)
             now = utc_now_iso()
             file_id = self._annotation_owner(conn, locator, now)
-            byte_id, revision, created = self._annotation_byte(
+            byte_id, revision, created, refingerprinted = self._annotation_byte(
                 conn, file_id, sha256, size, mtime_ns, now
             )
             current = self._byte_tags(conn, byte_id)
@@ -367,6 +372,8 @@ class AnnotationOperations:
                     {"sha256": sha256, "tags": current, "tag_revision": revision},
                 )
             if not created and not added:
+                if refingerprinted:
+                    conn.execute(_BUMP_INDEX)
                 return {**_receipt(epoch, sha256, current, revision, True), "added": 0}
             revision = self._write_image_tags(conn, byte_id, merged)
             return {

database/operations.py

@@ -1086,15 +1086,38 @@ class PromptDatabase(
             }
 
     @staticmethod
+    def _bump_image_tag_bytes(conn: sqlite3.Connection, tag_id: int) -> int:
+        """Move the tag revision of every image set that carries *tag_id*.
+
+        Vocabulary rename, merge and delete change what an image's set reads
+        as, so a Tag dialog opened before the change must see ``tag-conflict``
+        on Save instead of recreating the old name. Bumps the image index
+        revision once when any set was affected; returns that count.
+        """
+        cursor = conn.execute(
+            "UPDATE media_annotation_bytes SET tag_revision = tag_revision + 1 "
+            "WHERE id IN (SELECT byte_id FROM media_image_tags WHERE tag_id = ?)",
+            (tag_id,),
+        )
+        if cursor.rowcount > 0:
+            conn.execute(
+                "UPDATE media_annotation_metadata SET "
+                "image_index_revision = image_index_revision + 1 WHERE singleton_id = 1"
+            )
+        return cursor.rowcount
+
+    @classmethod
     def _move_tag_links(
-        conn: sqlite3.Connection, source_id: int, target_id: int
+        cls, conn: sqlite3.Connection, source_id: int, target_id: int
     ) -> None:
         """Repoint component, pair and image links from source to target.
 
         Owners that already carry the target keep that one link; the source's
         leftover duplicates are removed (an image set keeps the target's
         position). The source registry row is left for the caller to delete.
+        Image sets that carried the source get a new tag revision first.
         """
+        cls._bump_image_tag_bytes(conn, source_id)
         for junction in ("prompt_tags", "prompt_pair_tags", "media_image_tags"):
             conn.execute(
                 f"UPDATE OR IGNORE {junction} SET tag_id = ? WHERE tag_id = ?",
@@ -1148,6 +1171,7 @@ class PromptDatabase(
                 conn.execute("DELETE FROM tags WHERE id = ?", (old_tag_id,))
             else:
                 # Simple rename
+                self._bump_image_tag_bytes(conn, old_tag_id)
                 conn.execute(
                     "UPDATE tags SET name = ? WHERE id = ?", (new_name, old_tag_id)
                 )
@@ -1189,6 +1213,7 @@ class PromptDatabase(
             affected = cursor.fetchone()["c"]
 
             # CASCADE delete handles prompt_tags entries
+            self._bump_image_tag_bytes(conn, tag_id)
             conn.execute("DELETE FROM tags WHERE id = ?", (tag_id,))
             conn.commit()
 

database/vocabulary.py

@@ -274,6 +274,7 @@ class VocabularyOperations:
                 "SELECT id FROM tags WHERE name=?", (new_name,)
             ).fetchone()
             if target is None:
+                self._bump_image_tag_bytes(conn, tag_id)
                 conn.execute("UPDATE tags SET name=? WHERE id=?", (new_name, tag_id))
                 result_id = tag_id
             else:
@@ -299,6 +300,7 @@ class VocabularyOperations:
             epoch = self._library_epoch(conn, expected_epoch)
             self._vocabulary_identity(conn, epoch, tag_id, name)
             counts = self._tag_owner_counts(conn, tag_id)
+            self._bump_image_tag_bytes(conn, tag_id)
             conn.execute("DELETE FROM tags WHERE id=?", (tag_id,))
             return {"library_epoch": epoch, "deleted": True, **counts}