models.json: release index (versions, current_version, superseded_by chain), full-version display name

models.json

@@ -4,13 +4,22 @@
   "family": "birdnet-geomodel",
   "updated": "2026-10-03",
   "family_meta": {
-    "display_name": "BirdNET Geomodel v3.0",
+    "display_name": "BirdNET Geomodel v3.0.2",
     "description": "Spatiotemporal species occurrence prediction for post-filtering acoustic detections. Predicts which species are likely at a given location and week of the year.",
     "author": "Stefan Kahl, Cornell Lab of Ornithology",
     "license": "Apache-2.0",
     "commercial_use": true,
     "upstream_url": "https://github.com/birdnet-team/geomodel",
-    "species_count": 12012
+    "species_count": 12012,
+    "current_version": "3.0.2",
+    "versions": {
+      "3.0.2": {
+        "display_name": "BirdNET Geomodel v3.0.2",
+        "species_count": 12012,
+        "released": "2026-04-02",
+        "upstream_source": "https://github.com/birdnet-team/geomodel/releases/tag/v3.0.2"
+      }
+    }
   },
   "requirements_note": "requirements.min_ram_mb is a conservative, high-biased RAM floor: measured peak RSS + 15% where a benchmark exists, else a size-derived estimate biased high (a too-low floor risks OOM; a too-high floor only over-excludes on the smallest devices). Measured values will replace the estimates over time.",
   "naming": "legacy names, frozen; new files follow <family>-<upstream>[-<region>]-<variant>-b<build>.<ext>",
@@ -19,7 +28,7 @@
     "x86-64/openvino-cpu": "birdnet-geomodel-v3.0-fp32.onnx",
     "aarch64/onnxruntime": "birdnet-geomodel-v3.0-fp32.onnx"
   },
-  "notes": "VERSION MISMATCH, kept for backward compatibility: the files named birdnet-geomodel-v3.0-* actually contain BirdNET Geomodel V3.0.2 weights. The upstream_version field is authoritative (3.0.2); the filename is not. Under the current naming scheme these would be birdnet-geomodel-v3.0.2-<variant>-b1.onnx. The files are frozen because released clients pin their checksums.",
+  "notes": "Upstream patch releases are hosted side by side: family_meta.versions describes each one and family_meta.current_version names the current one. An entry of an older release has superseded_by set to the same-variant file of the next release; follow the chain to the entry whose superseded_by is null to find the update for an installed file. Old files are never removed. VERSION MISMATCH, kept for backward compatibility: the files named birdnet-geomodel-v3.0-* actually contain BirdNET Geomodel V3.0.2 weights. The upstream_version field is authoritative (3.0.2); the filename is not. Under the current naming scheme these would be birdnet-geomodel-v3.0.2-<variant>-b1.onnx. The files are frozen because released clients pin their checksums.",
   "models": [
     {
       "path": "BirdNET+_Geomodel_V3.0.2_Global_12K_FP16.onnx",