chore: merge the region reference frames

.github/workflows/deploy-site.yml

@@ -46,6 +46,7 @@ on:
       - "scripts/safeparse.py"
       - "scripts/sect233r1.py"
       - "scripts/sitediagrams.py"
+      - "scripts/siteentries.py"
       - "scripts/siteguides.py"
       - "scripts/sitemarkup.py"
       - "scripts/sitemeasurements.py"

.github/workflows/validate.yml

@@ -239,6 +239,16 @@ jobs:
       - name: Check that shellcheck is installed
         run: shellcheck --version
 
+      # core_probe and the campaign run third-party cores only inside a
+      # bubblewrap sandbox and refuse without one. Ubuntu 24.04 blocks the
+      # unprivileged user namespaces bwrap needs, so the campaign tests saw
+      # "refused". The last command proves a sandbox starts.
+      - name: Give the sandbox tests a working bubblewrap
+        run: |
+          sudo apt-get install -y --no-install-recommends bubblewrap
+          sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+          bwrap --ro-bind /usr /usr --symlink usr/lib /lib --symlink usr/lib64 /lib64 --symlink usr/bin /bin --proc /proc --dev /dev --unshare-all /bin/true
+
       # The site is built as deploy-site.yml builds it, from the lockfile.
       - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1  # v7.1.0
         with:

emulators/00_example.yml

@@ -4,7 +4,11 @@ core_classification: pure_libretro
 source: "https://github.com/libretro/libretro-core-info"
 profiled_date: "2026-03-22"
 source_commit: "bd81a0b73b50449c0862b65bd755d87860925f65"
-core_version: ~
+core_version: "v1.22.2-3-gbd81a0b"
+version_basis:
+  kind: tag
+  tag: "v1.22.2"
+  distance: 3
 display_name: "Example Core (.info template)"
 cores:
   - 00_example

emulators/2048.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/libretro-2048"
 upstream: "https://github.com/gabrielecirulli/2048"
 profiled_date: "2026-03-22"
 source_commit: "39333f7b13dc4daea7c151d9c38d22b961246343"
-core_version: "1.0"
+core_version: "v1.0"
+version_basis:
+  kind: file
+  path: "libretro.c"
+  pattern: 'info->library_version\s+=\s+"([^"]+)'
 display_name: "2048"
 cores: ["2048"]
 systems: []

emulators/2600-emu.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-08-11"
 source_commit: "1c12fac5ce49badaadff2e2f210dcc30b89f4943"
 upstream_commit: "289a40f1b63022b8bbe5b722061c660009d5de2c"
 core_version: "1.5.85"
+version_basis:
+  kind: file
+  path: "EmuFramework/metadata/conf.mk"
+  pattern: '^metadata_version\s*=\s*(\S+)'
 display_name: "Atari - 2600 (2600.emu)"
 mode: standalone
 cores:

emulators/2ship.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/2ship2harkinian/2ship2harkinian"
 source_commit: "8a24047fbce8915993804e7819f4df4fa591551f"
 profiled_date: "2026-10-20"
 core_version: "5.0.1"
+version_basis:
+  kind: tag
+  tag: "5.0.1"
+  distance: 0
 display_name: "The Legend of Zelda: Majora's Mask (2 Ship 2 Harkinian)"
 cores: [2ship]
 systems: [2ship]

emulators/3dengine.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/libretro/libretro-3dengine"
 profiled_date: "2026-03-22"
 source_commit: "efa2bf6f32f930721fe9ae2361d7ec858077c483"
 core_version: "v1"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: 'info->library_version\s+=\s+"([^"]+)'
 display_name: "Test Core - 3D Engine"
 cores: [3dengine]
 systems: []

emulators/3dsen.yml

@@ -8,6 +8,9 @@ version_source:
   pattern: '<title>[Vv](?:ersion\s*)?(\d+(?:\.\d+)+)'
 profiled_date: "2026-08-07"
 core_version: "1.1"
+version_basis:
+  kind: unverified
+  why: no_artifact
 display_name: "3dSen (3D NES)"
 cores:
   - 3dsen

emulators/81.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-03-22"
 source_commit: "fa7094910d040baa5fd8b11dbf6a1a618330ecd9"
 upstream_commit: "4de3cdb8cff0060ad03e43ae2681b0628a9c5f5d"
 core_version: "1.0a"
+version_basis:
+  kind: file
+  path: "src/libretro.cpp"
+  pattern: '#define\s+VERSION\s+"([^"]+)'
 display_name: "Sinclair - ZX 81 (EightyOne)"
 cores: ["81"]
 systems:

emulators/a5200.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/alekmaul/a5200"
 profiled_date: "2026-03-22"
 source_commit: "40c6f2f1ad4a3145b328d5baaf010fae6c7e752b"
 core_version: "2.0.2"
+version_basis:
+  kind: file
+  path: "libretro/libretro.c"
+  pattern: 'info->library_version\s*=\s*"([^"\s]+)'
 display_name: "Atari - 5200 (a5200)"
 cores:
   - a5200

emulators/a7800.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-08-08"
 source_commit: "7a2afdc1ea08fc331b16b750d8c1f02d4ef62fc8"
 upstream_commit: "39eb9e44c394df9aec8186f2d2ef7517ace232e1"
 core_version: "5.2"
+version_basis:
+  kind: file
+  path: "makefile"
+  pattern: '#define BARE_BUILD_VERSION \\?"([^"\\]+)'
 display_name: "Atari - 7800 (A7800)"
 cores:
   - a7800

emulators/abuse.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/Xenoveritas/abuse"
 profiled_date: "2026-10-04"
 source_commit: "c855a923cd7fb27b629b4e1af78b1fcc5f263d01"
 core_version: "v0.9.1"
+version_basis:
+  kind: tag
+  tag: "v0.9.1"
+  distance: 0
 display_name: "Abuse"
 cores: [abuse]
 systems: []

emulators/ace-dl.yml

@@ -8,6 +8,10 @@ version_source:
   pattern: 'New release <i>[^<]*</i> - (\d{4}/\d{2}/\d{2})'
 profiled_date: "2026-10-20"
 core_version: "2026/10/16"
+version_basis:
+  kind: package
+  url: "https://roudoudou.com/ACE-DL/"
+  artifact: "BNDGEN.tar.gz (ACE-DL Linux x86-64 build), release date on the download page"
 display_name: "Amstrad - CPC/Plus (ACE-DL)"
 cores:
   - ace-dl

emulators/advanced_drastic.yml

@@ -8,6 +8,10 @@ profiled_date: "2026-10-22"
 source_commit: "eaf41ab9bc8adcc15c010bf9517bc94c38e7bffd"
 pin_frozen: "KNULLI, the only platform that ships it, builds this revision (KNULLI package/emulators/advanced_drastic/advanced_drastic.mk:7 at tag 20260511). Later commits are not part of that build."
 core_version: "r2.5.2.0"
+version_basis:
+  kind: file
+  path: "drastic"
+  pattern: "Version (r[0-9][0-9.]+[0-9])"
 display_name: "Nintendo - DS (advanced_drastic)"
 cores:
   - "advanced_drastic"

emulators/advanced_tests.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/libretro/libretro-samples"
 profiled_date: "2026-03-22"
 source_commit: "7c2ad112d7a5176de2191e473369668da8946b16"
 core_version: "v1"
+version_basis:
+  kind: file
+  path: "audio/audio_callback/libretro-test.c"
+  pattern: 'info->library_version\s+=\s+"([^"]+)'
 display_name: "Test Core - Advanced Test"
 cores:
   - advanced_tests

emulators/advancemame.yml

@@ -5,7 +5,12 @@ source: "https://github.com/amadvance/advancemame"
 upstream: "https://www.mamedev.org"
 profiled_date: "2026-10-26"
 source_commit: "81670476672b59f430518a63e9a116db58ed6232"
-core_version: "5.0"
+core_version: "v5.0-185-g8167047"
+version_basis:
+  kind: tag
+  match: "v*"
+  tag: "v5.0"
+  distance: 185
 mame_version: "0.106"
 display_name: "Arcade (AdvanceMAME)"
 mode: standalone

emulators/advmame-0.94.yml

@@ -5,6 +5,11 @@ source: "https://files.retropie.org.uk/archives/advancemame-0.94.0.tar.gz"
 upstream: "https://www.mamedev.org"
 profiled_date: "2026-10-20"
 core_version: "0.94.0"
+version_basis:
+  kind: package
+  url: "https://files.retropie.org.uk/archives/advancemame-0.94.0.tar.gz"
+  pattern: 'advancemame-(\d+\.\d+\.\d+)\.tar\.gz'
+  artifact: "advancemame-0.94.0.tar.gz"
 mame_version: "0.94"
 display_name: "Arcade (AdvanceMAME 0.94)"
 mode: standalone

emulators/advmame-1.4.yml

@@ -6,7 +6,12 @@ upstream: "https://www.mamedev.org"
 profiled_date: "2026-10-20"
 source_commit: "237ca5c898e51e1b7a70ce52bccf008aa722e924"
 pin_frozen: "RetroPie builds the advancemame-1.4 release tarball, whose src/ tree is this tag. Later commits are not part of that build."
-core_version: "1.4"
+core_version: "advancemame-1.4"
+version_basis:
+  kind: tag
+  match: "advancemame-*"
+  tag: "advancemame-1.4"
+  distance: 0
 mame_version: "0.106"
 display_name: "Arcade (AdvanceMAME 1.4)"
 mode: standalone

emulators/aethersx2.yml

@@ -8,6 +8,11 @@ profiled_date: "2026-08-11"
 source_commit: "1d1f795dfc70e38da67724c7298779260f513889"
 upstream_commit: "f0523f8acb1d3a765ee73b74cffec63093569199"
 core_version: "1.5-3939"
+version_basis:
+  kind: package
+  url: "https://web.archive.org/web/20230320102332/https://www.aethersx2.com/archive/desktop/mac/AetherSX2-v1.5-3939-mac.zip"
+  pattern: 'AetherSX2-v([0-9.]+-[0-9]+)-mac\.zip'
+  artifact: "AetherSX2-v1.5-3939-mac.zip"
 display_name: "Sony - PlayStation 2 (AetherSX2)"
 cores:
   - aethersx2

emulators/ags.yml

@@ -5,7 +5,11 @@ source: "https://github.com/adventuregamestudio/ags"
 source_branch: release-3.6.0
 source_commit: "6802bad8dc3189462003d4a169fc591f64cfb9b6"
 profiled_date: "2026-10-20"
-core_version: "3.6.0.60"
+core_version: "v3.6.0.60"
+version_basis:
+  kind: tag
+  tag: "v3.6.0.60"
+  distance: 0
 display_name: "Adventure Game Studio (AGS)"
 cores:
   - ags

emulators/alephone.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/Aleph-One-Marathon/alephone"
 profiled_date: "2026-10-20"
 source_commit: "07a9c36aff403d143a0608815f725631a01e382c"
 pin_frozen: "RetroPie, the only platform that ships it, builds the release-20250829 tag at this commit (scriptmodules/ports/alephone.sh, _get_branch_alephone). Debian 10 and older get release-20250302."
-core_version: "1.11 (20250829)"
+core_version: "release-20250829"
+version_basis:
+  kind: tag
+  tag: "release-20250829"
+  distance: 0
 display_name: "Marathon (Aleph One)"
 cores:
   - alephone

emulators/altirra.yml

@@ -8,6 +8,11 @@ version_source:
   pattern: '<h3>Current version</h3>\s*<p>\s*Altirra (\d+\.\d+)'
 profiled_date: "2026-08-11"
 core_version: "4.40"
+version_basis:
+  kind: package
+  url: "https://www.virtualdub.org/downloads/Altirra-4.40-src.7z"
+  pattern: 'Altirra-(\d+\.\d+)-src\.7z'
+  artifact: "Altirra-4.40-src.7z"
 display_name: "Atari - 400/800/1200XL/XL/XE/XEGS/5200 (Altirra)"
 cores: [altirra]
 found_by: content

emulators/amiarcadia.yml

@@ -6,6 +6,10 @@ upstream: "https://amigan.1emu.net/releases/"
 profiled_date: "2026-10-23"
 source_commit: "8ca27c925833fe0021475155512c7f467924f647"
 core_version: "4.60"
+version_basis:
+  kind: file
+  path: "DroidArcadia/app/src/main/cpp/da.h"
+  pattern: '#define\s+INTEGERVERSION\s+"([^"]+)"'
 display_name: "Arcadia 2001 / Interton VC 4000 (AmiArcadia)"
 cores:
   - amiarcadia

emulators/amiberry.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/tonioni/WinUAE"
 profiled_date: "2026-10-26"
 source_commit: "49dbd1f027ef2afc12862b30c0c31ac8efa66221"
 upstream_commit: "15110cf6606d1188800ea7ad86bf1cbd9c688741"
-core_version: "v8.4.2"
+core_version: "8.4.2"
+version_basis:
+  kind: file
+  path: "CMakeLists.txt"
+  pattern: 'project\(amiberry\s+VERSION\s+([0-9][0-9.]*)'
 display_name: "Commodore - Amiga (Amiberry)"
 cores: [amiberry, "AMIBERRY"]
 systems:

emulators/anarch.yml

@@ -6,6 +6,10 @@ upstream: "https://gitlab.com/drummyfish/anarch"
 profiled_date: "2026-03-22"
 source_commit: "187050344ef440c4eaf3135304a020093564fa3f"
 core_version: "1.1d"
+version_basis:
+  kind: file
+  path: "texts.h"
+  pattern: '#define\s+SFG_VERSION_STRING\s+"([^"]+)"'
 display_name: "Anarch"
 cores: [anarch]
 systems: []

emulators/applewin.yml

@@ -6,7 +6,12 @@ upstream: "https://github.com/AppleWin/AppleWin"
 profiled_date: "2026-03-23"
 source_commit: "0a89db3d593a74d04590b902fb7206723591f445"
 upstream_commit: "1f3cadb88d1158c139d2e3a7b864d91836856948"
-core_version: "1.31.0.1"
+core_version: "1.32.1.0"
+version_basis:
+  kind: file
+  path: "resource/version.h"
+  pattern: '#define\s+APPLEWIN_VERSION\s+(\d+),(\d+),(\d+),(\d+)'
+  format: "{1}.{2}.{3}.{4}"
 display_name: "Apple II (AppleWin)"
 cores:
   - applewin

emulators/aps3e.yml

@@ -8,7 +8,11 @@ profiled_date: "2026-10-06"
 source_commit: "c6ca18217f2f1563235f83d94df78e35423a1720"
 upstream_commit: "1f080485b95db2700c5cf244b1314f73b6cf564e"
 upstream_frozen: "RPCS3 is vendored whole under app/src/main/cpp/rpcs3 at this commit, the tree the 2.43 release reports as 20071-1f080485."
-core_version: "2.43"
+core_version: "1.37-47-gc6ca182"
+version_basis:
+  kind: tag
+  tag: "1.37"
+  distance: 47
 display_name: "Sony - PlayStation 3 (aPS3e)"
 cores:
   - aps3e

emulators/arcadeduck.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/stenzek/duckstation"
 source_commit: "80cdb6da6b51d687192a6346efe4499b10fe4faf"
 upstream_commit: "526b4a128827ecaef037134095cd95f431b52d06"
 profiled_date: "2026-10-26"
-core_version: "0.6.0"
+core_version: "0.6.0-dev"
+version_basis:
+  kind: file
+  path: "src/scmversion/arcadeduck_version.h"
+  pattern: '#define\s+ARCADEDUCK_SEMANTIC_VERSION\s+"([^"]+)"'
 display_name: "Arcade - Sony ZN-1, Namco System 11, Konami GV/GQ (ArcadeDuck)"
 cores:
   - arcadeduck

emulators/arcadeflashweb.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/aureyoboss/ArcadeFlashWeb"
 profiled_date: "2026-08-11"
 source_commit: "5de66e0cd69b48721a094887a28d042f71ddad08"
 core_version: "1.0.2"
+version_basis:
+  kind: file
+  path: "src/ArcadeFlashWeb.pro"
+  pattern: '^VERSION\s*\+?=\s*(\S+)'
 display_name: "Adobe Flash (ArcadeFlashWeb)"
 cores:
   - arcadeflashweb

emulators/ardens.yml

@@ -5,7 +5,11 @@ source: "https://github.com/tiberiusbrown/ardens"
 upstream: "https://github.com/tiberiusbrown/ardens"
 profiled_date: "2026-03-23"
 source_commit: "e811cc6be72c8a802bd3265a84daf4165c177b93"
-core_version: "Git"
+core_version: "v0.25.12"
+version_basis:
+  kind: tag
+  tag: "v0.25.12"
+  distance: 0
 display_name: "Arduboy (Ardens)"
 cores:
   - ardens

emulators/arduous.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/jmaroeder/arduous"
 profiled_date: "2026-03-23"
 source_commit: "831b83e67ad46e8c86b8165649ff81bc6fc6c157"
 core_version: "0.1.0"
+version_basis:
+  kind: file
+  path: "CMakeLists.txt"
+  pattern: 'project\(arduous\s+VERSION\s+([0-9][\w.+-]*)'
 display_name: "Arduboy (Arduous)"
 cores:
   - arduous

emulators/ares.yml

@@ -4,7 +4,12 @@ source: "https://github.com/ares-emulator/ares"
 upstream: "https://github.com/ares-emulator/ares"
 profiled_date: "2026-10-23"
 source_commit: "d400eee9764fe22a8de0247a52757d2021d0539c"
-core_version: "v148"
+core_version: "v148-143-gd400eee"
+version_basis:
+  kind: tag
+  match: "v[0-9]*"
+  tag: "v148"
+  distance: 143
 display_name: "ares"
 cores: [ares, "ares-sa"]
 mode: standalone

emulators/armsx1.yml

@@ -7,6 +7,10 @@ upstream: "https://github.com/allkern/psxe"
 profiled_date: "2026-10-26"
 source_commit: "d96a5b8ad6ccccb40a431488aa89b06f0318c217"
 core_version: "0.3.6"
+version_basis:
+  kind: file
+  path: "android/app/build.gradle"
+  pattern: 'armsxVersionName\s*=\s*\(project\.findProperty\(.armsx\.versionName.\)\s*\?:\s*.([^\x27"]+).'
 display_name: "Sony - PlayStation (ARMSX1)"
 verification: md5
 found_by: content

emulators/armsx2.yml

@@ -7,7 +7,12 @@ upstream: "https://github.com/PCSX2/pcsx2"
 profiled_date: "2026-10-26"
 source_commit: "7f9144189c74edcf5a7ab3ba2aa2247635d24047"
 upstream_commit: "36907f4b70d149b05c2700acae687bedb720a7af"
-core_version: "2.9"
+core_version: "2.9-5-g7f91441"
+version_basis:
+  kind: tag
+  match: "[0-9]*"
+  tag: "2.9"
+  distance: 5
 display_name: "Sony - PlayStation 2 (ARMSX2)"
 cores:
   - armsx2

emulators/atari800.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/atari800/atari800"
 profiled_date: "2026-03-23"
 source_commit: "4e7fbc73765c1a9670c7506616046ad1d4ccda51"
 upstream_commit: "98cc2dc749867c9c7317a0271ba062a6c797f886"
-core_version: "3.1.0"
+core_version: "7.0.0"
+version_basis:
+  kind: file
+  path: "libretro/config.h"
+  pattern: '#define\s+PACKAGE_VERSION\s+"([^"]+)"'
 display_name: "Atari - 400/800/600XL/800XL/130XE/5200 (Atari800)"
 cores: [atari800]
 systems: [atari-400-800, atari-5200, xegs]

emulators/ax360e.yml

@@ -8,7 +8,9 @@ profiled_date: "2026-08-11"
 source_commit: "b8c1838f21761ac463724e24105eda97b990e704"
 upstream_commit: "dc561e4df578c903087f9bdf56ff61d9ef9f2a93"
 upstream_frozen: "The xenia-canary tree vendored under app/src/main/cpp/xenia-canary is canary_experimental at this commit."
-core_version: "1.18"
+core_version: null
+version_basis:
+  kind: none
 display_name: "Microsoft - Xbox 360 (aX360e)"
 cores:
   - ax360e

emulators/azahar-sdl.yml

@@ -5,7 +5,11 @@ source: "https://github.com/johndoe6345789/azahar_libretro"
 profiled_date: "2026-10-22"
 source_commit: "c8d39853c1ebacc5657e51d601713a09404ca8a7"
 pin_frozen: "KNULLI, the only platform that ships it, builds this revision (KNULLI package/emulators/azahar/azahar.mk:7 at tag 20260511). Later commits are not part of that build."
-core_version: "Git"
+core_version: "2122-rc1-178-gc8d3985"
+version_basis:
+  kind: tag
+  tag: "2122-rc1"
+  distance: 178
 display_name: "Nintendo - 3DS (Azahar SDL2)"
 mode: standalone
 cores: ["azahar"]

emulators/azahar.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/azahar-emu/azahar"
 profiled_date: "2026-10-22"
 source_commit: "219d743a1e698101fe1ab8bef43e6563126c3c27"
 core_version: "2126.2"
+version_basis:
+  kind: tag
+  tag: "2126.2"
+  distance: 0
 display_name: "Nintendo - 3DS (Azahar)"
 library_name: "Azahar"
 cores:

emulators/azaharplus.yml

@@ -5,7 +5,11 @@ source: "https://github.com/AzaharPlus/AzaharPlus"
 upstream: "https://github.com/AzaharPlus/AzaharPlus"
 profiled_date: "2026-08-08"
 source_commit: "cf9068844820f819a6eabbeeeb6a70d546e3e85a"
-core_version: "2126.0-A"
+core_version: "AZAHAR_PLUS_2126_2_A"
+version_basis:
+  kind: tag
+  tag: "AZAHAR_PLUS_2126_2_A"
+  distance: 0
 display_name: "Nintendo - 3DS (AzaharPlus)"
 cores:
   - azaharplus

emulators/b2.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-03-23"
 source_commit: "9793f6a8040c416d147003cada29363b955b54e7"
 upstream_commit: "e1c9b84a9460909d4dc2030ad1d4e050012b1910"
 core_version: "v0.4"
+version_basis:
+  kind: file
+  path: "src/libretro/core.cpp"
+  pattern: 'info->library_version\s+=\s+"([^"]+)'
 display_name: "Acorn - BBC Micro (b2)"
 cores: [b2]
 systems:

emulators/basiliskii.yml

@@ -5,6 +5,11 @@ upstream: "https://github.com/cebix/macemu"
 profiled_date: "2026-08-08"
 source_commit: "96e512bd6376e78a2869f16dcc8a9028bce5ee72"
 core_version: "1.0"
+version_basis:
+  kind: file
+  path: "BasiliskII/src/include/version.h"
+  pattern: 'const int VERSION_MAJOR = (\d+);\s*\nconst int VERSION_MINOR = (\d+);'
+  format: "{1}.{2}"
 display_name: "Apple - Macintosh 68k (Basilisk II)"
 cores:
   - basiliskii

emulators/bbkemu.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/AloysHF/BBKEmu"
 profiled_date: "2026-10-26"
 source_commit: "6641863f6ec59a74635753766e3f9d34adf92b05"
 core_version: "0.1.0"
+version_basis:
+  kind: file
+  path: "Cargo.toml"
+  pattern: 'version\s+=\s+"([^"]+)'
 display_name: "BBK - Electronic Dictionary (BBKEmu)"
 cores:
   - bbkemu

emulators/beebem.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/stardot/beebem-windows"
 profiled_date: "2026-08-11"
 source_commit: "a982ba6a74af09e801c296b29d514dbd4da09b94"
 core_version: "4.19"
+version_basis:
+  kind: file
+  path: "Src/Version.h"
+  pattern: '#define\s+VERSION_STRING\s+"([^"]+)'
 display_name: "Acorn - BBC Micro (BeebEm)"
 cores: [beebem]
 systems:

emulators/beetle_gba.yml

@@ -6,6 +6,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "b158166237b17253188cfdbe73a8a0b9fe4b3a8c"
 core_version: "v0.9.36"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "Nintendo - Game Boy Advance (Beetle GBA)"
 cores: [beetle_gba, mednafen_gba]
 systems:

emulators/beetle_lynx.yml

@@ -6,6 +6,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "fcdefcfb3c11d6d2e71be076a5d3df2e88ab73ed"
 core_version: "v1.24.0"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "Atari - Lynx (Beetle Lynx)"
 cores: [mednafen_lynx, "beetle-lynx"]
 systems: [atari-lynx]

emulators/beetle_ngp.yml

@@ -6,6 +6,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "a50d5ac288a81f2104ddf43195a4efdd15c72227"
 core_version: "v1.29.0.0"
+version_basis:
+  kind: file
+  path: "libretro.c"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "SNK - Neo Geo Pocket / Color (Beetle NeoPop)"
 cores: [mednafen_ngp, "beetle-ngp"]
 systems: [snk-ngp, snk-ngpc]

emulators/beetle_pce.yml

@@ -6,6 +6,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "b96c11e095b6a40a412d2da02766ae1c3f4fd539"
 core_version: "v1.29.0"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "NEC - PC Engine / SuperGrafx / CD (Beetle PCE)"
 cores: [beetle_pce, mednafen_pce, pce, beetle-pce]
 systems: [nec-pc-engine]

emulators/beetle_pcfx.yml

@@ -7,6 +7,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "c1650bad5fbdcc3c3ccd45e29e3983e1ccf16cff"
 core_version: "v0.9.36.5"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "NEC - PC-FX (Beetle PC-FX)"
 systems:
   - nec-pcfx

emulators/beetle_psx.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/beetle-psx-libretro"
 upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-29"
 source_commit: "7fea57a541abb39b8c5035b6261c3e70962d221b"
-core_version: "v0.9.44.1"
+core_version: "0.9.44.1"
+version_basis:
+  kind: file
+  path: "libretro_options.h"
+  pattern: '#define\s+MEDNAFEN_CORE_SETVERSION\s+"([^"]+)"'
 display_name: "Sony - PlayStation (Beetle PSX)"
 cores: [beetle_psx, mednafen_psx, mednafen_psx_hw, "beetle-psx"]
 systems: [sony-playstation]
@@ -85,7 +89,7 @@ files:
       - "SCPH-7003.BIN"
     evidence:
       aliases: ["2026-10-27-48269ae11777", "2026-10-27-ba941702c6c2", "2026-10-27-fc95254312c0", "2026-10-27-5a191f2b540b", "2026-10-27-12ba45024f8c", "2026-10-27-a7c1a301bdb0"]
-      hle_fallback: ["2026-10-27-f2ecd7ed71b5", "2026-10-27-ca1f49599ca1"]
+      hle_fallback: ["2026-10-27-6e97b657aca7", "2026-10-27-699ca140a270", "2026-10-27-ec1ab64f96d3", "2026-10-27-47c3dcceed98"]
 
   # -- Region: Europe (REGION_EU) --
 

emulators/beetle_saturn.yml

@@ -7,6 +7,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-10-05"
 source_commit: "2ce77e20a956dc9a67b8d3d527f477b984310feb"
 core_version: "v1.32.1"
+version_basis:
+  kind: file
+  path: "libretro.c"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "Sega - Saturn (Beetle Saturn)"
 cores:
   - mednafen_saturn

emulators/beetle_vb.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/beetle-vb-libretro"
 upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "d5ae54c8e23b573a3b34e888b2d48a588027e92c"
-core_version: "v0.9.36.1"
+core_version: "v1.31.0"
+version_basis:
+  kind: file
+  path: "libretro.cpp"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "Nintendo - Virtual Boy (Beetle VB)"
 cores: [mednafen_vb, vb, "beetle-vb"]
 systems: [nintendo-virtualboy]

emulators/beetle_wswan.yml

@@ -6,6 +6,10 @@ upstream: "https://mednafen.github.io/"
 profiled_date: "2026-03-24"
 source_commit: "4b01295838ea89e3f1355bbe4cb5cf98aa6108cd"
 core_version: "v0.9.35.1"
+version_basis:
+  kind: file
+  path: "libretro.c"
+  pattern: '#define\s+MEDNAFEN_CORE_VERSION\s+"([^"]+)'
 display_name: "Bandai - WonderSwan/Color (Beetle Wonderswan)"
 cores: [beetle_wswan, mednafen_wswan, "beetle-wswan"]
 systems: [bandai-wswan, bandai-wswanc]

emulators/bennugd-monolithic.yml

@@ -4,7 +4,11 @@ core_classification: game_engine
 source: "https://github.com/christianhaitian/bennugd-monolithic"
 profiled_date: "2026-10-22"
 source_commit: "60ee3389efcf9b402d66035e87f33d17d70cbd83"
-core_version: "git"
+core_version: "1.0.0"
+version_basis:
+  kind: file
+  path: "projects/cmake/include/common_defs.cmake"
+  pattern: '-DVERSION="([^"]+)"'
 display_name: "Bennu Game Development (bennugd-monolithic)"
 cores:
   - "bgdi"

emulators/bennugd.yml

@@ -5,7 +5,11 @@ source: "https://github.com/diekleinekuh/BennuGD_libretro"
 upstream: "https://github.com/SplinterGU/BennuGD"
 profiled_date: "2026-03-23"
 source_commit: "5fba764ac709545d4b0d3b28deff2ec0c7d1a91b"
-core_version: "git"
+core_version: "1.0.0"
+version_basis:
+  kind: file
+  path: "core/common/bgd_version.c"
+  pattern: 'snprintf\(buffer, sizeof\(buffer\), "([0-9][0-9.]*)-BennuGD_libretro'
 display_name: "Bennu Game Development"
 cores:
   - bennugd

emulators/bermuda.yml

@@ -5,6 +5,10 @@ source: "https://github.com/cyxx/bermuda"
 profiled_date: "2026-10-22"
 source_commit: "cf6bdb68d53a1618967da565a44c931b15daf791"
 core_version: "0.1.7"
+version_basis:
+  kind: file
+  path: "main_libretro.cpp"
+  pattern: 'static\s+const\s+char\s+\*kVersion\s+=\s+"([^"]+)'
 display_name: "Bermuda Syndrome (bs)"
 cores:
   - "bs"

emulators/bigpemu.yml

@@ -7,6 +7,12 @@ version_source:
   pattern: 'Current Version: <strong>([0-9.]+)</strong>'
 profiled_date: "2026-10-20"
 core_version: "1.221"
+version_basis:
+  kind: package
+  url: "https://www.richwhitehouse.com/jaguar/builds/BigPEmu_Linux64_v1221.tar.gz"
+  pattern: 'BigPEmu_Linux64_v(\d)(\d+)\.tar\.gz'
+  format: "{1}.{2}"
+  artifact: "BigPEmu_Linux64_v1221.tar.gz"
 display_name: "BigPEmu (Atari Jaguar)"
 cores:
   - bigpemu

emulators/bizhawk.yml

@@ -5,6 +5,10 @@ source: "https://github.com/TASEmulators/BizHawk"
 source_commit: "bdddf4a58aa1a022afb11dc73294a81a5aa7bbd5"
 profiled_date: "2026-10-20"
 core_version: "2.11.1"
+version_basis:
+  kind: tag
+  tag: "2.11.1"
+  distance: 0
 display_name: "Multi-system (BizHawk EmuHawk)"
 cores:
   - bizhawk

emulators/bk.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/bk-emulator"
 upstream: "https://github.com/emestee/bk-emulator"
 profiled_date: "2026-03-23"
 source_commit: "92042a753289cedf05e7e6bd8e75849f83e48966"
-core_version: "1.00"
+core_version: "v1.0"
+version_basis:
+  kind: file
+  path: "libretro.c"
+  pattern: 'library_version\s*=\s*"([^"]+)"'
 display_name: "Elektronika - BK-0010/BK-0011(M)"
 cores:
   - bk

emulators/blastem.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-10-20"
 source_commit: "ab743653ed110eeb7b1fe64d00cc5f9279c2bfec"
 prose_written_at: "1e0de94dc7e669c0925a22c0fccf6cdc837af0a0"
 core_version: "1.0.1-pre"
+version_basis:
+  kind: file
+  path: "version.inc"
+  pattern: '#define\s+BLASTEM_VERSION\s+"([^"]+)'
 display_name: "Sega - Mega Drive - Genesis (BlastEm)"
 cores:
   - blastem

emulators/bluemsx.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/blueMSX-libretro"
 upstream: "http://bluemsx.msxblue.com/"
 profiled_date: "2026-03-23"
 source_commit: "e3086eb5d36d77fa11704cf53dc176686e70127d"
-core_version: "SVN"
+core_version: "2.8.3"
+version_basis:
+  kind: file
+  path: "Src/BuildInfo/version.h"
+  pattern: '#define\s+BLUE_MSX_VERSION\s+"([^"]+)"'
 display_name: "MSX/SVI/ColecoVision/SG-1000 (blueMSX)"
 cores:
   - bluemsx

emulators/bnes.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/Sir-Walrus/bsnes-gc"
 profiled_date: "2026-03-23"
 source_commit: "8e26e89a93bef8eb8992d1921b539dce1792660a"
 core_version: "v083"
+version_basis:
+  kind: file
+  path: "libretro/libretro.cpp"
+  pattern: 'info->library_version\s+=\s+"([^"]+)'
 display_name: "Nintendo - NES / Famicom (bnes)"
 cores:
   - bnes

emulators/boom3.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/dhewm/dhewm3"
 profiled_date: "2026-03-23"
 source_commit: "efe140ce8fdf8793f5a6fbba062fb34df7f55a81"
 upstream_commit: "455b88e8dff2be822f08eb498f51b383e851fa38"
-core_version: "git"
+core_version: "1.5.5"
+version_basis:
+  kind: file
+  path: "neo/framework/Licensee.h"
+  pattern: '#define\s+ENGINE_VERSION\s+"dhewm3 ([^"]+)"'
 display_name: "Doom 3 (boom3)"
 cores: [boom3, boom3_xp]
 systems: [doom3]

emulators/boytacean.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/joamag/boytacean"
 profiled_date: "2026-03-23"
 source_commit: "4d806d0770f117cc8e6ac0fe75b95aa9dc39fc4f"
 core_version: "0.13.2"
+version_basis:
+  kind: file
+  path: "setup.py"
+  pattern: 'version="([^"]+)'
 display_name: "Nintendo - Game Boy / Color (Boytacean)"
 cores:
   - boytacean

emulators/bsnes-jg.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-03-23"
 source_commit: "4aef191fef72be539ccc07ada21c6e0a65360eb7"
 upstream_commit: "53e6a7c2ec4b4220adc2f8dcb3786489bd04fe0e"
 core_version: "2.1.2"
+version_basis:
+  kind: file
+  path: "version.h"
+  pattern: '#define\s+JG_VERSION\s+"([^"]+)'
 display_name: "Nintendo - SNES / SFC (bsnes-jg)"
 cores: [bsnes-jg, bsnes_jg]
 systems:

emulators/bsnes.yml

@@ -8,6 +8,10 @@ profiled_date: "2026-04-05"
 source_commit: "05439f96121d2b9d7ad7a5fc1f29d7eebdcc8c43"
 upstream_commit: "78474e5d39f58872dc21aca18cf9eb583b147fe7"
 core_version: "115"
+version_basis:
+  kind: file
+  path: "bsnes/emulator/emulator.hpp"
+  pattern: 'static const string Version\s*=\s*"([^"]+)"'
 display_name: "Nintendo - SNES / SFC (bsnes)"
 cores: [bsnes]
 systems: [nintendo-snes, nintendo-super-game-boy, nintendo-satellaview]

emulators/bsnes2014.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/bsnes-emu/bsnes"
 profiled_date: "2026-03-25"
 source_commit: "3c1394e042ee444c8248e1b9210e14ea55e836e9"
 upstream_commit: "78474e5d39f58872dc21aca18cf9eb583b147fe7"
-core_version: "v094"
+core_version: "094"
+version_basis:
+  kind: file
+  path: "emulator/emulator.hpp"
+  pattern: 'static const char Version\[\]\s*=\s*"([^"]+)"'
 display_name: "Nintendo - SNES / SFC (bsnes 2014)"
 cores: [bsnes2014_accuracy, bsnes2014_balanced, bsnes2014_performance]
 systems:

emulators/bsnes_cplusplus98.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/bsnes-libretro-cplusplus98"
 upstream: "https://byuu.org/"
 profiled_date: "2026-03-23"
 source_commit: "baec09aa4796b7575aba1c1ae7335f493c2216af"
-core_version: "v085 (Performance)"
+core_version: "v085"
+version_basis:
+  kind: file
+  path: "snes/libretro/libretro.cpp"
+  pattern: 'static string version\("(v[0-9]+)'
 display_name: "Nintendo - SNES / SFC (bsnes C++98 (v085))"
 cores: [bsnes_cplusplus98]
 systems:

emulators/bsnes_hd_beta.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/bsnes-emu/bsnes"
 profiled_date: "2026-03-23"
 source_commit: "fc26b25ea236f0f877f0265d2a2c37dfd93dfde9"
 upstream_commit: "78474e5d39f58872dc21aca18cf9eb583b147fe7"
-core_version: "v10.6"
+core_version: "10.6"
+version_basis:
+  kind: file
+  path: "bsnes/emulator/emulator.hpp"
+  pattern: 'static const string Version\s*=\s*"([^"]+)"'
 display_name: "Nintendo - SNES / SFC (bsnes-hd beta)"
 cores: [bsnes_hd_beta, bsneshd, bsnes_hd]
 systems:

emulators/bsnes_mercury.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/bsnes-mercury"
 upstream: "https://byuu.org/higan"
 profiled_date: "2026-03-25"
 source_commit: "79d7f9de218b6ffa65a80bbdc5828532bc239232"
-core_version: "v094 (Mercury)"
+core_version: "094"
+version_basis:
+  kind: file
+  path: "emulator/emulator.hpp"
+  pattern: 'static const char Version\[\]\s*=\s*"([^"]+)"'
 display_name: "Nintendo - SNES / SFC (bsnes-mercury)"
 cores: [bsnes_mercury_accuracy, bsnes_mercury_balanced, bsnes_mercury_performance]
 systems:

emulators/bstone.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/bibendovsky/bstone"
 profiled_date: "2026-10-04"
 source_commit: "e65a6b40b960a409d7ea840580c2431f56fb6fd4"
 core_version: "v1.3.4"
+version_basis:
+  kind: tag
+  tag: "v1.3.4"
+  distance: 0
 display_name: "Blake Stone (BStone)"
 cores: [bstone]
 systems: [blake-stone]

emulators/bsyndrome.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/cyxx/bermuda"
 source_commit: "c3aaa0337daca116eab5804456673bd01396bbb4"
 profiled_date: "2026-10-20"
 core_version: "0.1.7"
+version_basis:
+  kind: tag
+  tag: "0.1.7"
+  distance: 0
 display_name: "Bermuda Syndrome (bs)"
 cores: [bsyndrome]
 systems: [bsyndrome]

emulators/c64-emu.yml

@@ -7,6 +7,10 @@ profiled_date: "2026-08-11"
 source_commit: "1c12fac5ce49badaadff2e2f210dcc30b89f4943"
 upstream_commit: "46b1bc4393251f838ce3dadd241c1f567d9371d1"
 core_version: "1.5.85"
+version_basis:
+  kind: file
+  path: "EmuFramework/CMakeLists.txt"
+  pattern: 'project\(\s*EmuFramework\s+VERSION\s+([0-9.]+)'
 display_name: "Commodore - C64 (C64.emu)"
 mode: standalone
 cores:

emulators/cannonball.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/djyt/cannonball"
 profiled_date: "2026-03-23"
 source_commit: "0d83575d920ea4c0a280847a19d7802f673e6a68"
 upstream_commit: "27493ebf62be3498dff93ed6a45e8e2db819bae1"
-core_version: "1.0"
+core_version: "0.3"
+version_basis:
+  kind: file
+  path: "src/main/frontend/menu.c"
+  pattern: 'menu_about\[[^\]]+\]\s*=\s*"CANNONBALL ([0-9.]+) '
 display_name: "Cannonball"
 cores:
   - cannonball

emulators/cap32.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/ColinPitrat/caprice32"
 profiled_date: "2026-10-23"
 source_commit: "8e61dd69d948cea16c3bad734f7b9d0c2a018cc8"
 upstream_commit: "8c778bf072a06fb7c23b9cccd179041db7f79a52"
-core_version: "v4.5.4"
+core_version: "4.5.4"
+version_basis:
+  kind: file
+  path: "libretro/libretro-core.h"
+  pattern: '#define\s+VERSION_STRING\s+"([^"]+)"'
 display_name: "Amstrad - CPC/GX4000 (Caprice32)"
 cores:
   - cap32

emulators/capriceforever.yml

@@ -5,6 +5,10 @@ source: "https://www.retrobat.org/repo/win64/stable/emulators/capriceforever.7z"
 upstream: closed-source
 profiled_date: "2026-10-20"
 core_version: "26.4"
+version_basis:
+  kind: package
+  url: "https://www.retrobat.org/repo/win64/stable/emulators/capriceforever.7z"
+  artifact: "capriceforever.7z, Caprice.exe version resource ProductVersion"
 display_name: "Amstrad - CPC / PLUS (CaPriCe Forever)"
 cores:
   - capriceforever

emulators/capricerpi.yml

@@ -5,7 +5,11 @@ source: "https://github.com/KaosOverride/CapriceRPI"
 upstream: "https://sourceforge.net/projects/caprice32/"
 source_commit: "7d86ebdc6a5e645220c6f30cf407ac57c3256054"
 profiled_date: "2026-10-20"
-core_version: "1.3c"
+core_version: "V1.3d"
+version_basis:
+  kind: file
+  path: "src/cap32.h"
+  pattern: '#define\s+VERSION_STRING\s+"\s*(V[0-9][^ ]*)'
 display_name: "Amstrad - CPC (CapriceRPI)"
 cores:
   - capricerpi

emulators/catacombgl.yml

@@ -6,6 +6,11 @@ upstream: "https://github.com/ArnoAnsems/CatacombGL"
 profiled_date: "2026-10-04"
 source_commit: "d11ba549382278cbc67ba6171faf8af338e29f77"
 core_version: "0.5.7 Beta"
+version_basis:
+  kind: file
+  path: "src/Engine/EngineCore.cpp"
+  pattern: 'versionMajor\s*=\s*(\d+);\s*\n.*versionMinor\s*=\s*(\d+);\s*\n.*versionLevel\s*=\s*(\d+);\s*\n.*versionPhase\s*=\s*"([^"]+)"'
+  format: "{1}.{2}.{3} {4}"
 display_name: "Catacomb 3-D (CatacombGL)"
 cores: [catacombgl]
 systems: [catacomb-3d, catacomb-adventure]

emulators/ccleste.yml

@@ -4,7 +4,11 @@ core_classification: game_engine
 source: "https://github.com/lemon32767/ccleste"
 profiled_date: "2026-10-22"
 source_commit: "261d96f15af430b8111abc7a5250229246654f52"
-core_version: "git"
+core_version: "v1.4.0"
+version_basis:
+  kind: tag
+  tag: "v1.4.0"
+  distance: 0
 display_name: "Celeste Classic (ccleste)"
 cores:
   - "ccleste"

emulators/cdi2015.yml

@@ -6,14 +6,19 @@ upstream: "https://github.com/mamedev/mame/tree/mame0160"
 profiled_date: "2026-03-23"
 source_commit: "7adbf440d5f554097f58f8c6ebb673adc4320a31"
 upstream_commit: "0147bb4cc82e642cf75151f039f240eb20989fbc"
-core_version: "0.160"
+core_version: "0.159"
+version_basis:
+  kind: file
+  path: "src/version.c"
+  pattern: '#define\s+BARE_BUILD_VERSION\s+"([^"]+)"'
 display_name: "Philips CDi (CDi 2015)"
 cores: [cdi2015]
 systems:
   - philips-cdi
 
 notes: |
-  MAME 0.160 compiled with SUBTARGET=cdi, only cdimono1 driver.
+  MAME 0.159 (version.c, the core reports 0.160) compiled with SUBTARGET=cdi,
+  only cdimono1 driver.
   Checks cdimono1.zip existence in system_dir, then game dir. Returns -2 if missing.
   cdic.bin and slave.bin are undumped 68HC05 MCUs (NO_DUMP), not in the ZIP.
 

emulators/cdogs.yml

@@ -6,6 +6,11 @@ upstream: "https://github.com/cxong/cdogs-sdl"
 profiled_date: "2026-10-27"
 source_commit: "c70d1feaf9d89cf80e23265b256d9a364848e6ea"
 core_version: "2.5.0"
+version_basis:
+  kind: file
+  path: "CMakeLists.txt"
+  pattern: 'set\(VERSION_MAJOR "(\d+)"\)\s*\nset\(VERSION_MINOR "(\d+)"\)\s*\nset\(VERSION_PATCH "(\d+)"\)'
+  format: "{1}.{2}.{3}"
 display_name: "C-Dogs"
 cores: [cdogs, cdogs-sdl]
 systems: []

emulators/cemu.yml

@@ -8,7 +8,11 @@ logo: "https://raw.githubusercontent.com/cemu-project/Cemu/main/dist/linux/info.
 profiled_date: "2026-10-23"
 source_commit: "14f56b569b3668db01a4972225993abd3e8f2096"
 upstream_commit: "42876aa86d2b92f9c620a76959a792bf392b89d3"
-core_version: "2.6"
+core_version: "2.6-372-g29f2f1fa"
+version_basis:
+  kind: file
+  path: "src/libretro/CemuLibretro.cpp"
+  pattern: 'info->library_version\s*=\s*"([^"]+)"'
 display_name: "Nintendo - Wii U (Cemu)"
 library_name: "Cemu"
 save_folder_once: true

emulators/cgenius.yml

@@ -5,7 +5,11 @@ source: "https://gitlab.com/Dringgstein/Commander-Genius"
 upstream: "https://gitlab.com/Dringgstein/Commander-Genius"
 profiled_date: "2026-10-27"
 source_commit: "58a3c4fd0782fa2a087e38a039599b2ecf69ccc9"
-core_version: "v3.6.4"
+core_version: "3.6.4-Release"
+version_basis:
+  kind: file
+  path: "version.h"
+  pattern: '#define\s+CGVERSION\s+"([^"]+)"'
 display_name: "Commander Genius"
 cores: [cgenius, "CGeniusExe"]
 systems: [commander-keen]

emulators/chailove.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/libretro/libretro-chailove"
 profiled_date: "2026-03-23"
 source_commit: "524ef951abbd07464830ee12a3f6f5e2aba9efd3"
 core_version: "2.0.0"
+version_basis:
+  kind: file
+  path: "src/ChaiLove.h"
+  pattern: '#define\s+CHAILOVE_VERSION_STRING\s+"([^"]+)'
 display_name: "ChaiLove"
 cores: [chailove]
 systems: []

emulators/chihiro-ds.yml

@@ -5,6 +5,10 @@ source: "https://www.retrobat.org/repo/win64/stable/emulators/chihiro-ds.7z"
 upstream: closed-source
 profiled_date: "2026-10-20"
 core_version: "1.0 (Mar 14 2025)"
+version_basis:
+  kind: package
+  url: "https://www.retrobat.org/repo/win64/stable/emulators/chihiro-ds.7z"
+  artifact: "chihiro-ds.7z, build string in cxbx.exe and cxbxr-emu.dll"
 display_name: "Sega - Chihiro (Chihiro-DS)"
 cores:
   - chihiro-gun

emulators/chimerasnes.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/snes9xgit/snes9x"
 profiled_date: "2026-03-23"
 source_commit: "04c57c2902c25f36ae5a5d9c57aff851a772c868"
 upstream_commit: "1bcc369e89f08243e0a462882fb1f3e42e51de3a"
-core_version: ""
+core_version: "86bab70_20231001-4-g04c57c2"
+version_basis:
+  kind: tag
+  tag: "86bab70_20231001"
+  distance: 4
 display_name: "Nintendo - SNES / SFC (ChimeraSNES)"
 cores: [chimerasnes]
 systems:

emulators/chocolate-doom.yml

@@ -6,6 +6,10 @@ profiled_date: "2026-10-22"
 source_commit: "72d9e9318c4ccc61dab29bb9cc30bc8a9a93266d"
 pin_frozen: "EmuELEC, the only platform that ships it, builds this revision (EmuELEC packages/sx05re/emuelec-ports/chocolate-doom/package.mk:5). Later commits are not part of that build."
 core_version: "3.0.0"
+version_basis:
+  kind: file
+  path: "configure.ac"
+  pattern: 'AC_INIT\(Chocolate\s+Doom,\s+([0-9][\w.+-]*)'
 display_name: "Doom (Chocolate Doom)"
 cores:
   - "Chocolate-Doom"

emulators/citra-mmj.yml

@@ -6,6 +6,10 @@ upstream: "https://github.com/weihuoya/citra"
 profiled_date: "2026-08-11"
 source_commit: "9198dc24df2eb534b8fe7fa1c5c457081a7244ab"
 core_version: "20251112"
+version_basis:
+  kind: tag
+  tag: "20251112"
+  distance: 0
 display_name: "Nintendo - 3DS (Citra MMJ)"
 cores:
   - citra-mmj

emulators/citra.yml

@@ -5,7 +5,9 @@ source: "https://github.com/libretro/citra"
 upstream: "https://github.com/citra-emu/citra"
 profiled_date: "2026-03-23"
 source_commit: "a0483e9abe8134ae6b290cdca7d49cb77689f05b"
-core_version: "Git"
+core_version: null
+version_basis:
+  kind: none
 display_name: "Nintendo - 3DS (Citra)"
 library_name: "Citra"
 cores: [citra]

emulators/citra2018.yml

@@ -5,7 +5,9 @@ source: "https://github.com/libretro/citra2018"
 upstream: "https://github.com/citra-emu/citra"
 profiled_date: "2026-03-23"
 source_commit: "95e2f06c179c8daf44fa344c206f549cf332d21b"
-core_version: "Git"
+core_version: null
+version_basis:
+  kind: none
 display_name: "Nintendo - 3DS (Citra 2018)"
 library_name: "Citra2018"
 cores: [citra2018]

emulators/citra_canary.yml

@@ -6,7 +6,11 @@ upstream: "https://github.com/citra-emu/citra"
 profiled_date: "2026-03-23"
 source_commit: "5401990a9be46e4497abc92db3d5f2042674303d"
 source_branch: canary
-core_version: "Git"
+core_version: "canary-82-6-g5401990"
+version_basis:
+  kind: tag
+  tag: "canary-82"
+  distance: 6
 display_name: "Nintendo - 3DS (Citra Canary/Experimental)"
 library_name: "Citra Canary"
 cores: [citra_canary]

emulators/citron.yml

@@ -6,6 +6,9 @@ upstream: "https://git.citron-emu.org/citron-emu/Citron"
 profiled_date: "2026-03-26"
 upstream_gone: "git.citron-emu.org no longer resolves, and git.citron-emu.com redirects to an unrelated survey site, the domain having been taken. Observed 2026-09-04, no mirror found."
 core_version: "2026.03.12"
+version_basis:
+  kind: unverified
+  why: host_gone
 display_name: "Citron (Nintendo Switch)"
 cores:
   - citron

emulators/clk.yml

@@ -4,7 +4,11 @@ source: "https://github.com/TomHarte/CLK"
 upstream: "https://github.com/TomHarte/CLK"
 profiled_date: "2026-03-26"
 source_commit: "9020107b563b68595ffdb6ef18aacdec85c78d69"
-core_version: "2026-07-28"
+core_version: "2026-07-23-136-g9020107"
+version_basis:
+  kind: tag
+  tag: "2026-07-23"
+  distance: 136
 display_name: "Clock Signal"
 cores: [clk]
 systems:

emulators/clownmdemu.yml

@@ -7,7 +7,11 @@ profiled_date: "2026-03-23"
 source_commit: "d43c2708b0a31c285ce16724b6c4a2e92af07346"
 # The core the port vendors at source_commit (common -> core submodule).
 upstream_commit: "88ef45a6585556e2247dd26b6c937d6b9fb4a12d"
-core_version: "Git"
+core_version: "v1.6.12"
+version_basis:
+  kind: file
+  path: "source/libretro-interface.c"
+  pattern: 'info->library_version\s*=\s*"([^"]+)"'
 display_name: "Sega - MD/CD (ClownMDEmu)"
 cores:
   - clownmdemu

emulators/colem.yml

@@ -8,6 +8,12 @@ version_source:
   pattern: 'The Latest Version of ColEm is (\d+(?:\.\d+)+)'
 profiled_date: "2026-08-08"
 core_version: "5.6"
+version_basis:
+  kind: package
+  url: "https://fms.komkon.org/ColEm/ColEm56-Source.zip"
+  pattern: 'ColEm(\d)(\d+)-Source\.zip'
+  format: "{1}.{2}"
+  artifact: "ColEm56-Source.zip"
 display_name: "Coleco - ColecoVision / Adam (ColEm)"
 cores:
   - colem

emulators/coolbaremu.yml

@@ -5,7 +5,11 @@ source: "https://github.com/AloysHF/CoolbarEmu"
 upstream: "https://github.com/AloysHF/CoolbarEmu"
 profiled_date: "2026-10-17"
 source_commit: "88e90440daab0bdc7bc141728b51841e0c730528"
-core_version: "0.2.0"
+core_version: "v0.2.0"
+version_basis:
+  kind: tag
+  tag: "v0.2.0"
+  distance: 0
 display_name: "Coolbar (CoolbarEmu)"
 cores:
   - "coolbaremu"

emulators/coolcv.yml

@@ -5,6 +5,10 @@ source: "https://files.retropie.org.uk/archives/coolcv.tar.gz"
 upstream: "http://nanochess.org/"
 profiled_date: "2026-10-20"
 core_version: "0.6.2"
+version_basis:
+  kind: package
+  url: "https://files.retropie.org.uk/archives/coolcv.tar.gz"
+  artifact: "coolcv.tar.gz, latest entry of coolcv.txt"
 display_name: "Coleco - ColecoVision / Adam (CoolCV)"
 cores:
   - coolcv

emulators/corsixth.yml

@@ -5,7 +5,11 @@ source: "https://github.com/CorsixTH/CorsixTH"
 upstream: ~
 profiled_date: "2026-10-04"
 source_commit: "e5668b9b2a6f59c492b2446821528d67f5d0ee53"
-core_version: "0.70.1"
+core_version: "v0.70.1-263-ge5668b9"
+version_basis:
+  kind: tag
+  tag: "v0.70.1"
+  distance: 263
 display_name: "Theme Hospital (CorsixTH)"
 cores: [corsixth]
 systems: [theme-hospital]

emulators/cpcemu.yml

@@ -8,6 +8,11 @@ version_source:
   pattern: 'CPCemu (\d+(?:\.\d+)+) released'
 profiled_date: "2026-08-08"
 core_version: "3.0.2"
+version_basis:
+  kind: package
+  url: "https://cpc-emu.org/Release/2025-04-24/cpcemu_portable-win32-x86-3.0.2.zip"
+  pattern: 'cpcemu_portable-win32-x86-(\d+(?:\.\d+)+)\.zip'
+  artifact: "cpcemu_portable-win32-x86-3.0.2.zip"
 display_name: "Amstrad - CPC (CPCemu)"
 cores:
   - cpcemu

emulators/craft.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/Craft"
 upstream: "https://github.com/fogleman/Craft"
 profiled_date: "2026-03-23"
 source_commit: "f30e7b4b1d1406c750a504583adf0cc88449a699"
-core_version: "v1"
+core_version: "v1.0-353-gf30e7b4"
+version_basis:
+  kind: tag
+  tag: "v1.0"
+  distance: 353
 display_name: "Minecraft (Craft)"
 cores: [craft]
 systems: []

emulators/crocods.yml

@@ -5,7 +5,11 @@ source: "https://github.com/libretro/libretro-crocods"
 upstream: "https://github.com/redbug26/crocods-core"
 profiled_date: "2026-03-23"
 source_commit: "a9c63b29443715ae2add392010fca4eae7f93e67"
-core_version: "v1"
+core_version: "2024-10-16"
+version_basis:
+  kind: file
+  path: "crocods-core/crocods.h"
+  pattern: '#define\s+CROCOVERSION\s+"([^"]+)"'
 display_name: "Amstrad - CPC (CrocoDS)"
 cores:
   - crocods