v2.2.6

CLAUDE.md

@@ -103,7 +103,7 @@ sibling `cfg` boilerplate system. Key fragments: `codex.mk`, `django.mk`,
 
 ### Key Libraries
 
-- **Backend:** Django 6, Channels 4.2, DRF 3.16, Granian 2.7, comicbox (comic
+- **Backend:** Django 6, Channels 4.2, DRF 3.16, Granian 2.8, comicbox (comic
   parsing), Pillow, django-cachalot, loguru
 - **Frontend:** Vue 3.5, Vite 8, Vuetify 4, Pinia 3, xior
 - **Database:** SQLite + WAL + FTS5 full-text search

Dockerfile

@@ -117,7 +117,7 @@ RUN set -eux \
     && rm -f /tmp/${CODEX_WHEEL}
 
 # ---- Stage 4: final (production image) ------------------------------------
-FROM ghcr.io/ajslater/python-debian:3.14.4-slim-trixie_0 AS final
+FROM ghcr.io/ajslater/python-debian:3.14.6-slim-trixie_0 AS final
 ARG CODEX_VERSION=dev
 LABEL org.opencontainers.image.title="Codex" \
     org.opencontainers.image.description="Codex Comic Server" \

NEWS.md

@@ -6,6 +6,13 @@ width: 128px;
 border-radius: 128px;
 " />
 
+## v2.2.6
+
+- Features
+    - The Comic Vine custom URL is back, for tagging against a Comic Vine proxy
+      or mirror. URLs discarded by v2.2.4 must be entered again. Metron Cloud's
+      stays gone; it never did anything.
+
 ## v2.2.5
 
 - Features

codex/librarian/onlinetag/credential_validator.py

@@ -137,6 +137,8 @@ def _validate_comicvine(creds: OnlineCredentials) -> ValidationResult:
             "cache_expiry": DO_NOT_CACHE,
             "ratelimit_path": tmp_path / "ratelimits.sqlite",
         }
+        if creds.comicvine_url:
+            kwargs["base_url"] = creds.comicvine_url
         cv = Comicvine(**kwargs)
         try:
             cv.list_publishers(params={"limit": "1"}, max_results=1)

codex/librarian/onlinetag/explicit_id.py

@@ -52,7 +52,10 @@ def _build_auth_source(
             user=credentials.metron_user,
             password=credentials.metron_password,
         )
-    return OnlineSourceCredentials(key=credentials.comicvine_key)
+    return OnlineSourceCredentials(
+        key=credentials.comicvine_key,
+        url=credentials.comicvine_url,
+    )
 
 
 def build_explicit_id_config(

codex/librarian/onlinetag/session_manager.py

@@ -115,6 +115,7 @@ def _build_credentials(self) -> OnlineCredentials | None:
             metron_user=defaults.metron_user or "",
             metron_password=defaults.metron_password or "",
             comicvine_key=defaults.comicvine_key or "",
+            comicvine_url=defaults.comicvine_url or "",
         )
 
     @staticmethod

codex/librarian/telemeter/admin_stats.py

@@ -143,7 +143,7 @@ def _default_sources(defaults: ComicboxTaggingDefaults) -> dict[str, int]:
 
 
 def get_tagging_stats() -> dict[str, Any]:
-    """Report the online tagging defaults. Never the credentials."""
+    """Report the online tagging defaults. Never the credentials or the url."""
     defaults = ComicboxTaggingDefaults.objects.first()
     if not defaults:
         return {}
@@ -160,6 +160,7 @@ def get_tagging_stats() -> dict[str, Any]:
             defaults.metron_key or (defaults.metron_user and defaults.metron_password)
         ),
         "has_comicvine_credentials": bool(defaults.comicvine_key),
+        "comicvine_url_set": bool(defaults.comicvine_url),
     }
 
 

codex/migrations/0052_comicboxtaggingdefaults_comicvine_url.py

@@ -0,0 +1,29 @@
+"""Generated by Django 6.0.7 on 2026-08-03 12:00."""
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    """
+    Restore the custom Comic Vine URL override removed by 0051.
+
+    Only the Comic Vine half comes back. comicbox passes the url through to
+    simyan's ``base_url``, so pointing tagging at a Comic Vine proxy or mirror
+    works. Metron's twin stays gone: mokkari hardcodes its API endpoint and
+    comicbox warns that the url is ignored.
+
+    0051 dropped the column outright, so any URL saved before it is
+    unrecoverable — admins re-enter it.
+    """
+
+    dependencies = [
+        ("codex", "0051_remove_comicboxtaggingdefaults_urls"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="comicboxtaggingdefaults",
+            name="comicvine_url",
+            field=models.URLField(blank=True, default="", max_length=256),
+        ),
+    ]

codex/models/admin.py

@@ -124,6 +124,11 @@ class PromptsModeChoices(TextChoices):
     metron_user = EncryptedCharField()
     metron_password = EncryptedCharField()
     comicvine_key = EncryptedCharField()
+    # Points simyan at a Comic Vine proxy or mirror instead of the public API.
+    # Not a secret, and the admin form echoes it back as a placeholder, so it
+    # stays a plain URLField. Metron has no twin: mokkari hardcodes its
+    # endpoint, so a custom URL there was always a no-op.
+    comicvine_url = URLField(max_length=256, blank=True, default="")
 
     # Active session id + pending prompts used to live here. They are
     # transient operational state — they only matter while a tagging

codex/serializers/admin/stats.py

@@ -171,7 +171,7 @@ class StatsTaggingSerializer(Serializer):
     """
     Online Tagging Defaults.
 
-    Credentials report only whether they are configured.
+    Credentials and the Comic Vine url report only whether they are configured.
     """
 
     default_match_mode = CharField(required=False, read_only=True)
@@ -183,6 +183,7 @@ class StatsTaggingSerializer(Serializer):
     default_format_count = IntegerField(required=False, read_only=True)
     has_metron_credentials = BooleanField(required=False, read_only=True)
     has_comicvine_credentials = BooleanField(required=False, read_only=True)
+    comicvine_url_set = BooleanField(required=False, read_only=True)
 
 
 class StatsAuthSerializer(Serializer):

codex/serializers/admin/tagging.py

@@ -106,6 +106,7 @@ class TaggingValidateRequestSerializer(Serializer):
     )
     metron_key = CharField(required=False, allow_blank=True)
     comicvine_key = CharField(required=False, allow_blank=True)
+    comicvine_url = CharField(required=False, allow_blank=True)
 
 
 class TaggingRateLimitWindowSerializer(Serializer):
@@ -207,6 +208,9 @@ class Meta(BaseModelSerializer.Meta):
             "merge_all_sources",
             "metron_key",
             "comicvine_key",
+            # Not a secret, so unlike the keys this reads back: the form shows
+            # the saved url as its placeholder.
+            "comicvine_url",
             "metron_key_set",
             "comicvine_key_set",
             "has_metron_credentials",

codex/user_data/restore.py

@@ -374,6 +374,7 @@ def _build_tagging_defaults(row) -> dict[str, Any]:
         "metron_user": "",
         "metron_password": "",
         "comicvine_key": "",
+        "comicvine_url": "",
     }
     # ``sqlite3.Row`` raises on a missing column, so skip what a sidecar
     # predating a column doesn't carry (e.g. metron_key) and let the model
@@ -386,10 +387,10 @@ def _build_tagging_defaults(row) -> dict[str, Any]:
     defaults["default_sources"] = json.loads(row["default_sources"] or "[]")
     defaults["delete_original"] = bool(row["delete_original"])
     # ``active_session_id`` / ``active_prompts`` used to be on this row before
-    # they moved to the Django cache as transient state, and ``metron_url`` /
-    # ``comicvine_url`` before the custom URL overrides were removed. Older
-    # sidecar backups still carry those columns — since this comprehension
-    # walks ``coalesced`` rather than the row, they are silently ignored.
+    # they moved to the Django cache as transient state, and ``metron_url``
+    # before that no-op override was removed for good. Older sidecar backups
+    # still carry those columns — since this comprehension walks ``coalesced``
+    # rather than the row, they are silently ignored.
     return defaults
 
 

codex/user_data/schema.sql

@@ -176,6 +176,7 @@ CREATE TABLE IF NOT EXISTS tagging_defaults (
     metron_user TEXT NOT NULL DEFAULT '',
     metron_password TEXT NOT NULL DEFAULT '',
     comicvine_key TEXT NOT NULL DEFAULT '',
+    comicvine_url TEXT NOT NULL DEFAULT '',
     updated_at TEXT
 );
 

codex/user_data/serializers.py

@@ -381,6 +381,7 @@ def serialize_tagging_defaults(
             "metron_user": defaults.metron_user or "",
             "metron_password": defaults.metron_password or "",
             "comicvine_key": defaults.comicvine_key or "",
+            "comicvine_url": defaults.comicvine_url or "",
             "updated_at": _datetime_str(getattr(defaults, "updated_at", None)),
         },
     )

codex/views/admin/tagging_validate.py

@@ -26,6 +26,7 @@
     "metron_user",
     "metron_password",
     "comicvine_key",
+    "comicvine_url",
 )