chore: standardize notes: to note: in file entries

240 file-level entries used notes: instead of the canonical note: field. verify.py and cross_reference.py only read note:, so these were silently ignored.
2026-04-13 04:12:33 -05:00 · 2026-03-29 10:02:20 +02:00
parent b7528a71e7
commit e13e8734b9
67 changed files with 240 additions and 240 deletions
--- a/emulators/ardens.yml
+++ b/emulators/ardens.yml
@@ -48,7 +48,7 @@ platform_details:
        array: "ARDENS_BOOT_MENU_E2"
        size: 8548
        device: "Arduboy Mini"
-    notes: |
+    note: |
      All bootloaders are compiled from Intel HEX into C arrays at build
      time. The core selects the game or menu variant at reset depending
      on whether a flashcart image was loaded and the boot_to_menu config
@@ -60,7 +60,7 @@ platform_details:
    source_ref: "src/boot/boot_flashcart.c, src/absim_w25q128.hpp:14"
    array: "ARDENS_BOOT_FLASHCART"
    size: 1536
-    notes: |
+    note: |
      Empty flashcart header written to the first 1536 bytes of the
      W25Q128 flash image during initialization. This is not a BIOS
      file -- it is the default flash content the Arduboy FX expects
--- a/emulators/beetle_lynx.yml
+++ b/emulators/beetle_lynx.yml
@@ -32,4 +32,4 @@ files:
    size: 512
    crc32: "0d973c9d"
    source_ref: "libretro.cpp:191, rom.cpp:50-78, cart.cpp:67"
-    notes: "512-byte boot ROM. Core silently degrades without it but games will not run."
+    note: "512-byte boot ROM. Core silently degrades without it but games will not run."
--- a/emulators/beetle_psx.yml
+++ b/emulators/beetle_psx.yml
@@ -85,7 +85,7 @@ files:
    mode: libretro
    source_ref: "libretro.cpp:190-195"
    aliases: ["PSXONPSP660.bin"]
-    notes: "override_bios=1. Falls back to region BIOS if not found."
+    note: "override_bios=1. Falls back to region BIOS if not found."

  - name: "ps1_rom.bin"
    description: "PS3 embedded PS1 BIOS (region-free override)"
@@ -98,4 +98,4 @@ files:
    mode: libretro
    source_ref: "libretro.cpp:198-203"
    aliases: ["PS1_ROM.bin"]
-    notes: "override_bios=2. Falls back to region BIOS if not found."
+    note: "override_bios=2. Falls back to region BIOS if not found."
--- a/emulators/bk.yml
+++ b/emulators/bk.yml
@@ -140,7 +140,7 @@ files:
 platform_details:
  bios_mapping:
    source_ref: "libretro.c:718-760, boot.c:83-116"
-    notes: |
+    note: |
      ROM directory is {system_dir}/bk/ (libretro.c:724-726).
      Model selection via core option "bk_model" determines which ROMs are loaded.
      The core shuts down immediately if any required ROM for the selected model
@@ -148,7 +148,7 @@ platform_details:

  model_rom_map:
    source_ref: "libretro.c:734-756, boot.c:83-116"
-    notes: |
+    note: |
      BK-0010:            MONIT10.ROM + FOCAL10.ROM
      BK-0010.01:         MONIT10.ROM + BASIC10.ROM
      BK-0010.01 + FDD:   MONIT10.ROM + DISK_327.ROM
@@ -158,7 +158,7 @@ platform_details:

  rom_loading:
    source_ref: "libretro.c:1050-1107"
-    notes: |
+    note: |
      load_rom_file() first tries {romdir}/{filename} with original casing.
      If not found, retries with the filename converted to lowercase.
      Returns NULL and shuts down the core on failure.
--- a/emulators/blastem.yml
+++ b/emulators/blastem.yml
@@ -64,7 +64,7 @@ analysis:
    rom_size: 2048  # 2 KB
    config_path: "system\0tmss_path\0"
    source_ref: "genesis.c:1910"
-    notes: |
+    note: |
      TMSS ROM is loaded from tmss.md (configurable via system/tmss_path).
      Models with tmss=on: md1va6, md2va1, md2va2, md3va1, md3va2.
      Models with tmss=off: md1va0, md1va3 (default), teradrive.
@@ -73,10 +73,10 @@ analysis:
  sega_cd:
    supported: false
    source_ref: "system.c:16"
-    notes: "TODO comment only: 'Differentiate between vanilla Genesis and Sega CD/32X games'"
+    note: "TODO comment only: 'Differentiate between vanilla Genesis and Sega CD/32X games'"

  jaguar_bios:
    libretro_relevant: false
-    notes: |
+    note: |
      blastjag (jaguar.c) is a separate standalone binary, not compiled
      into the libretro core. Requires BIOS as first CLI argument.
--- a/emulators/cap32.yml
+++ b/emulators/cap32.yml
@@ -94,7 +94,7 @@ files:
 platform_details:
  bios_mapping:
    source_ref: "cap32/cap32.c:1072-1100, cap32/cap32.c:342-345"
-    notes: |
+    note: |
      All ROMs are embedded. emulator_select_ROM() copies the appropriate
      ROM array into the pbROM buffer based on CPC.model. No filesystem
      lookup occurs in the libretro port. The retro_system_bios_directory
@@ -103,7 +103,7 @@ platform_details:

  embedded_roms:
    source_ref: "cap32/rom/464.h, cap32/rom/6128.h, cap32/rom/amsdos.h, cap32/rom/6128p.h, cap32/rom/cpm.h"
-    notes: |
+    note: |
      5 ROM sets embedded as C arrays:
      OS_BASIC10 (32KB) - CPC 464/664 OS + BASIC 1.0
      OS_BASIC11 (32KB) - CPC 6128 OS + BASIC 1.1
@@ -113,7 +113,7 @@ platform_details:

  model_rom_map:
    source_ref: "cap32/cap32.c:1072-1100"
-    notes: |
+    note: |
      CPC 464:  OS_BASIC10 only (no disk support)
      CPC 664:  OS_BASIC10 + AMSDOS in ROM slot 7
      CPC 6128: OS_BASIC11 + AMSDOS in ROM slot 7
--- a/emulators/chimerasnes.yml
+++ b/emulators/chimerasnes.yml
@@ -29,7 +29,7 @@ files:
    source_ref: "source/bsx.c:857-882"
    aliases: ["BS-X.bios"]
    validation: [size]
-    notes: |
+    note: |
      Loaded by BSX_LoadBIOS() from system_dir when core option
      chimerasnes_bsx_bios is set to 'load' (default: skip).
      Tries BS-X.bin first, then BS-X.bios as fallback.
@@ -41,7 +41,7 @@ files:
    required: true
    size: 262144
    source_ref: "source/memmap.c:275-289"
-    notes: |
+    note: |
      Loaded by LoadSFTBIOS() from system_dir when Sufami Turbo game
      detected (BANDAI SFC-ADX header at ROM offset 0, memmap.c:833).
      Reads 0x40000 bytes into Memory.ROM. No validation performed.
--- a/emulators/crocods.yml
+++ b/emulators/crocods.yml
@@ -45,20 +45,20 @@ files: []
 platform_details:
  bios_mapping:
    source_ref: "crocods-core/vga.c:185-200, crocods-core/platform.c:1009-1020"
-    notes: |
+    note: |
      All ROMs are embedded. InitMemCPC() copies cpc6128_bin and romdisc_bin
      into ROMINF and ROMEXT arrays via memcpy. No filesystem lookup occurs.
      retro_set_environment() does not request system_directory.

  embedded_roms:
    source_ref: "crocods-core/cpc6128.bin.c, crocods-core/romdisc.bin.c"
-    notes: |
+    note: |
      2 ROM sets embedded as C byte arrays:
      cpc6128_bin (32KB) - CPC 6128 OS (lower 16KB) + BASIC 1.1 (upper 16KB)
      romdisc_bin (16KB) - AMSDOS disk controller ROM, mapped to slot 7

  model_rom_map:
    source_ref: "crocods-core/vga.c:189-192"
-    notes: |
+    note: |
      CPC 6128 only: OS in ROMINF, BASIC in ROMEXT[0], AMSDOS in ROMEXT[7]
      emulator_patch_ROM() applies language patches to ROMINF after loading
--- a/emulators/desmume.yml
+++ b/emulators/desmume.yml
@@ -24,7 +24,7 @@ files:
    size: 16384
    validation: [size]
    source_ref: "desmume/src/NDSSystem.cpp:2178-2182, frontend/libretro/libretro.cpp:763"
-    notes: "Native file needed for firmware boot and SWI-from-BIOS accuracy"
+    note: "Native file needed for firmware boot and SWI-from-BIOS accuracy"

  - name: "bios9.bin"
    system: nintendo-ds
@@ -34,7 +34,7 @@ files:
    size: 4096
    validation: [size]
    source_ref: "desmume/src/NDSSystem.cpp:2236-2239, frontend/libretro/libretro.cpp:764"
-    notes: "Native file needed for firmware boot and logo comparison (Pal Park)"
+    note: "Native file needed for firmware boot and logo comparison (Pal Park)"

  - name: "firmware.bin"
    system: nintendo-ds
@@ -42,4 +42,4 @@ files:
    required: false
    hle_fallback: true
    source_ref: "desmume/src/firmware.cpp:249-280, frontend/libretro/libretro.cpp:765"
-    notes: "Loaded only if both BIOS files present; needed for boot animation, wifi config, user settings"
+    note: "Loaded only if both BIOS files present; needed for boot animation, wifi config, user settings"
--- a/emulators/dosbox_core.yml
+++ b/emulators/dosbox_core.yml
@@ -58,7 +58,7 @@ files:
    size: 65536
    sha1: "b083518fffb7f66b03c23b7eb4f868e62dc5a987"
    source_ref: "midi_mt32.cpp:55, ROMInfo.cpp:67, dosbox_core_libretro.info:firmware0"
-    notes: "version referenced in .info file (md5: 5626206284b22c2734f3e9efefcd2675)"
+    note: "version referenced in .info file (md5: 5626206284b22c2734f3e9efefcd2675)"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control BlueRidge"
@@ -112,7 +112,7 @@ files:
    size: 65536
    sha1: "a439fbb390da38cada95a7cbb1d6ca199cd66ef8"
    source_ref: "midi_mt32.cpp:53, ROMInfo.cpp:76, dosbox_core_libretro.info:firmware2"
-    notes: "version referenced in .info file (md5: bfff32b6144c1d706109accb6e6b1113)"
+    note: "version referenced in .info file (md5: bfff32b6144c1d706109accb6e6b1113)"

  - name: "CM32L_CONTROL.ROM"
    description: "CM-32LN/CM-500/LAPC-N Control v1.00"
@@ -121,7 +121,7 @@ files:
    size: 65536
    sha1: "dc1c5b1b90a4646d00f7daf3679733c7badc7077"
    source_ref: "midi_mt32.cpp:53, ROMInfo.cpp:77"
-    notes: "MUNT recognizes this ROM when named CM32L_CONTROL.ROM"
+    note: "MUNT recognizes this ROM when named CM32L_CONTROL.ROM"

  # -- PCM ROMs --

@@ -132,7 +132,7 @@ files:
    size: 524288
    sha1: "f6b1eebc4b2d200ec6d3d21d51325d5b48c60252"
    source_ref: "midi_mt32.cpp:66, ROMInfo.cpp:81, dosbox_core_libretro.info:firmware1"
-    notes: "pairs with any MT-32 v1.x control ROM (md5: 89e42e386e82e0cacb4a2704a03706ca)"
+    note: "pairs with any MT-32 v1.x control ROM (md5: 89e42e386e82e0cacb4a2704a03706ca)"

  - name: "CM32L_PCM.ROM"
    description: "CM-32L/CM-64/LAPC-I PCM ROM"
@@ -141,7 +141,7 @@ files:
    size: 1048576
    sha1: "289cc298ad532b702461bfc738009d9ebe8025ea"
    source_ref: "midi_mt32.cpp:64, ROMInfo.cpp:85, dosbox_core_libretro.info:firmware3"
-    notes: "pairs with MT-32 v2.x or CM-32L control ROMs (md5: 08cdcfa0ed93e9cb16afa76e6ac5f0a4)"
+    note: "pairs with MT-32 v2.x or CM-32L control ROMs (md5: 08cdcfa0ed93e9cb16afa76e6ac5f0a4)"

  # -- BASS shared libraries (BASSMIDI driver) --
  # Downloaded from https://www.un4seen.com, placed in system directory.
@@ -152,42 +152,42 @@ files:
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:238, dosbox_core_libretro.info:firmware4"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  - name: "libbassmidi.so"
    description: "BASSMIDI addon library (Linux)"
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:239, dosbox_core_libretro.info:firmware5"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  - name: "bass.dll"
    description: "BASS audio library (Windows)"
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:232, dosbox_core_libretro.info:firmware6"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  - name: "bassmidi.dll"
    description: "BASSMIDI addon library (Windows)"
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:233, dosbox_core_libretro.info:firmware7"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  - name: "libbass.dylib"
    description: "BASS audio library (macOS)"
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:235, dosbox_core_libretro.info:firmware8"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  - name: "libbassmidi.dylib"
    description: "BASSMIDI addon library (macOS)"
    required: false
    hle_fallback: true
    source_ref: "midi_bassmidi.cpp:236, dosbox_core_libretro.info:firmware9"
-    notes: "proprietary library from un4seen.com, not a ROM"
+    note: "proprietary library from un4seen.com, not a ROM"

  # -- General MIDI SoundFont --
  # Placed in system/soundfonts/ directory. Core scans for .sf2/.sf3/.sfz/.dls/.gig.
--- a/emulators/dosbox_pure.yml
+++ b/emulators/dosbox_pure.yml
@@ -164,7 +164,7 @@ files:
    sha1: "f6b1eebc4b2d200ec6d3d21d51325d5b48c60252"
    validation: [sha1, size]
    source_ref: "mt32emu.h:5126,5143"
-    notes: "pairs with any MT-32 v1.x control ROM"
+    note: "pairs with any MT-32 v1.x control ROM"

  - name: "CM32L_PCM.ROM"
    description: "CM-32L/CM-64/LAPC-I PCM ROM"
@@ -174,7 +174,7 @@ files:
    sha1: "289cc298ad532b702461bfc738009d9ebe8025ea"
    validation: [sha1, size]
    source_ref: "mt32emu.h:5127,5144"
-    notes: "pairs with MT-32 v2.x or CM-32L control ROMs. Lower half aliases MT-32 PCM."
+    note: "pairs with MT-32 v2.x or CM-32L control ROMs. Lower half aliases MT-32 PCM."

  # -- General MIDI SoundFont --

@@ -183,7 +183,7 @@ files:
    required: false
    hle_fallback: true
    source_ref: "dosbox_pure_libretro.cpp:1375,2760"
-    notes: >
+    note: >
      Any .SF2 or .SF3 file in the system directory works. The core lists all
      found SoundFonts in the MIDI config dropdown. DOSBOX.SF2 is the conventional
      name and is also auto-detected when placed inside game content on C: drive.
--- a/emulators/duckstation.yml
+++ b/emulators/duckstation.yml
@@ -1080,7 +1080,7 @@ files:
    fast_boot: Type2
    priority: 150
    source_ref: "src/core/bios.cpp:138"
-    notes: "Sony Bravia TV with embedded PS2"
+    note: "Sony Bravia TV with embedded PS2"

  # -- OpenBIOS (signature-based detection, no fixed hash) --

@@ -1093,4 +1093,4 @@ files:
    fast_boot: unsupported
    priority: 200
    source_ref: "src/core/bios.cpp:144-146"
-    notes: "Detected by 'OpenBIOS' signature at offset 0x78, not by MD5 hash"
+    note: "Detected by 'OpenBIOS' signature at offset 0x78, not by MD5 hash"
--- a/emulators/ecwolf.yml
+++ b/emulators/ecwolf.yml
@@ -38,7 +38,7 @@ files:
    required: true
    md5: "c011b428819eea4a80b455c245a5a04d"
    source_ref: "version.h:12 (MAIN_PK3), wl_iwad.cpp:642-657 (open + fatal), libretro.cpp:831-832 (sysDir)"
-    notes: >
+    note: >
      Built from wadsrc/static/ via zipdir. Contains IWADINFO (game detection rules),
      palettes (wolfpal, spearpal, blakepal, noahpal), map lump remappers (wl6map,
      sodmap, etc.), DECORATE actor definitions, MAPINFO, SNDINFO, SNDSEQ, textures,
--- a/emulators/emux_chip8.yml
+++ b/emulators/emux_chip8.yml
@@ -43,7 +43,7 @@ platform_details:
  bios_mapping:
    target: "none"
    source_ref: "mach/chip8.c:40-57, mach/chip8.c:98-115"
-    notes: |
+    note: |
      No external BIOS. The 80-byte character font is compiled into the
      binary as char_mem[] and memcpy'd into RAM[0x000] on every reset.
      This is standard CHIP-8 behavior -- all interpreters embed the font.
--- a/emulators/fake08.yml
+++ b/emulators/fake08.yml
@@ -37,14 +37,14 @@ platform_details:
  cartridge_format:
    extensions: "p8, png"
    source_ref: "platform/libretro/libretro.cpp:258"
-    notes: |
+    note: |
      .p8 is the PICO-8 text cartridge format containing Lua code, gfx,
      gff, map, sfx, and music sections. .png is the cartridge-as-image
      format where cart data is steganographically encoded in the image.

  runtime:
    source_ref: "source/vm.h, source/p8GlobalLuaFunctions.h"
-    notes: |
+    note: |
      The FAKE-08 VM reimplements the PICO-8 API (128x128 screen, 16 colors,
      4-channel audio, Lua scripting) entirely in C++. The built-in BIOS
      provides a cart browser and error display. Audio runs at 22050 Hz
--- a/emulators/fceumm.yml
+++ b/emulators/fceumm.yml
@@ -29,7 +29,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "src/fds.c:636-667 (FDSLoad), src/general.c:64-66 (FCEUMKF_FDSROM)"
-    notes: "Loaded at 0xE000, mapped as 8 KB PRG bank 0. Load fails if missing or short read."
+    note: "Loaded at 0xE000, mapped as 8 KB PRG bank 0. Load fails if missing or short read."

  # --- Game Genie ROM (optional, core option fceumm_game_genie) ---
  - name: "gamegenie.nes"
@@ -37,7 +37,7 @@ files:
    description: "Game Genie add-on cartridge ROM"
    required: false
    source_ref: "src/cart.c:344-398 (FCEU_OpenGenie), src/general.c:60-62 (FCEUMKF_GGROM)"
-    notes: "iNES format ROM (4 KB PRG + 256 bytes CHR). Core option disabled by default. Only applies to cartridge games."
+    note: "iNES format ROM (4 KB PRG + 256 bytes CHR). Core option disabled by default. Only applies to cartridge games."

  # --- Custom palette (optional, core option fceumm_palette) ---
  - name: "nes.pal"
@@ -45,4 +45,4 @@ files:
    description: "External NES color palette"
    required: false
    source_ref: "src/palette.c:170-200 (FCEU_LoadGamePalette), src/general.c:68-70 (FCEUMKF_PALETTE), src/drivers/libretro/libretro.c:1789-1798"
-    notes: "RGB triplets (64 standard or 512 with de-emphasis). Only loaded when palette core option is set to Custom."
+    note: "RGB triplets (64 standard or 512 with de-emphasis). Only loaded when palette core option is set to Custom."
--- a/emulators/fixgb.yml
+++ b/emulators/fixgb.yml
@@ -35,4 +35,4 @@ files:
    md5: "dbfce9db9deaa2567f6a84fde55f9680"
    sha1: "1293d68bf9643bc4f36954c1e80e38f39864528d"
    source_ref: "libretro/libretro.c:246-254 (doOpenCGBBootrom), mem.c:567-586 (memInitCGBBootrom)"
-    notes: "Minimum 0x900 (2304) bytes. Only first 0x900 bytes read. Disabled via memDisableCGBBootrom() on register write."
+    note: "Minimum 0x900 (2304) bytes. Only first 0x900 bytes read. Disabled via memDisableCGBBootrom() on register write."
--- a/emulators/freechaf.yml
+++ b/emulators/freechaf.yml
@@ -58,7 +58,7 @@ platform_details:
  bios_mapping:
    target: "0x000-0x7FF in 64K memory space"
    source_ref: "src/memory.h:27-29, src/memory.c:29-61"
-    notes: |
+    note: |
      MEMORY_loadSysROM_libretro() reads the file and copies it into
      Memory[] at the given address offset. PSU1 is loaded at 0x000,
      PSU2 at 0x400. The loader caps file size to (MEMORY_SIZE - address)
@@ -67,7 +67,7 @@ platform_details:

  hle_fallback:
    source_ref: "src/channelf_hle.c"
-    notes: |
+    note: |
      When BIOS files are missing, FreeChaF uses HLE to emulate the
      PSU routines in software. This is marked as experimental and may
      cause compatibility issues with some games. Each PSU can
@@ -75,7 +75,7 @@ platform_details:

  load_priority:
    source_ref: "src/libretro.c:186-198"
-    notes: |
+    note: |
      PSU1 loading order: sl90025.bin (Channel F II) first, then
      sl31253.bin (original Channel F) as fallback. If both fail,
      HLE is used. sl90025.bin is the preferred BIOS as it includes
--- a/emulators/freej2me.yml
+++ b/emulators/freej2me.yml
@@ -25,4 +25,4 @@ files:
    description: "FreeJ2ME libretro Java application"
    required: true
    source_ref: "src/libretro/freej2me_libretro.c:483-486 (GET_SYSTEM_DIRECTORY + fill_pathname_join + java -jar)"
-    notes: "Not a BIOS dump. Java emulator loaded by the native core at startup via execvp('java', '-jar', path). Built from source via 'ant'. Must be in the system directory root."
+    note: "Not a BIOS dump. Java emulator loaded by the native core at startup via execvp('java', '-jar', path). Built from source via 'ant'. Must be in the system directory root."
--- a/emulators/fuse.yml
+++ b/emulators/fuse.yml
@@ -420,7 +420,7 @@ files:
 platform_details:
  bios_mapping:
    source_ref: "src/compat/file.c:55-89, 129-223"
-    notes: |
+    note: |
      ROM resolution order in compat_file_open():
      1. Check mem_entries[] (18 embedded ROMs compiled as .h arrays)
      2. If not found, try {system_dir}/fuse/{filename} on filesystem
@@ -429,7 +429,7 @@ platform_details:

  embedded_roms:
    source_ref: "src/compat/file.c:55-73"
-    notes: |
+    note: |
      18 ROMs embedded in the binary via .h headers generated from .rom files:
      48.rom, 128-0.rom, 128-1.rom, plus2-0.rom, plus2-1.rom,
      plus3-0/1/2/3.rom, plus3e-0/1/2/3.rom, se-0.rom, se-1.rom,
@@ -440,7 +440,7 @@ platform_details:

  machine_rom_map:
    source_ref: "fuse/settings.c:209-260, fuse/machines/*.c"
-    notes: |
+    note: |
      Spectrum 16K:       48.rom (1 ROM)
      Spectrum 48K:       48.rom (1 ROM)
      Spectrum 48K NTSC:  48.rom (1 ROM)
@@ -460,7 +460,7 @@ platform_details:

  rom_copyright:
    source_ref: "fuse/roms/README.copyright"
-    notes: |
+    note: |
      Most ROMs are copyright Amstrad. Amstrad allows free distribution but
      retains copyright. Selling ROMs standalone is not permitted. SE ROMs
      are GPLv2+. DISCiPLE/+D ROMs are copyright Datel, distribution allowed.
--- a/emulators/gam4980.yml
+++ b/emulators/gam4980.yml
@@ -54,7 +54,7 @@ platform_details:
  bios_mapping:
    target: "0x800000-0x9FFFFF (font), 0xE00000-0xFFFFFF (OS) in banked address space"
    source_ref: "src/libretro.c:109-110, 300-305"
-    notes: |
+    note: |
      sys.rom_8 and sys.rom_e are flat 2 MB arrays. The CPU accesses them
      through bank-switched memory (PA() macro resolves virtual to physical
      address). rom_8_vread and rom_e_vread handle indirect reads via
@@ -62,7 +62,7 @@ platform_details:

  load_path:
    source_ref: "src/libretro.c:1173-1175"
-    notes: |
+    note: |
      retro_init() builds the path as {system_directory}/gam4980/ and
      passes it to sys_init(). Files must be named exactly 8.BIN and
      E.BIN (case sensitive on Linux). No .info firmware declarations
--- a/emulators/gambatte.yml
+++ b/emulators/gambatte.yml
@@ -42,7 +42,7 @@ files:
    size: 256
    validation: {core: [size], upstream: [size, crc32]}
    source_ref: "libretro.cpp:1303-1363 (get_bootloader_from_file), bootloader.cpp:20-55 (load)"
-    notes: "Mapped at 0x0000-0x00FF, swapped out when register 0xFF50 is written."
+    note: "Mapped at 0x0000-0x00FF, swapped out when register 0xFF50 is written."

  - name: "gbc_bios.bin"
    system: nintendo-gbc
@@ -52,4 +52,4 @@ files:
    size: 2304
    validation: {core: [size], upstream: [size, crc32]}
    source_ref: "libretro.cpp:1303-1363 (get_bootloader_from_file), bootloader.cpp:20-55 (load)"
-    notes: "Mapped at 0x0000-0x08FF with cartridge data preserved at 0x0100-0x01FF. Also used for GBA mode with a patch at 0xF2. Presence required for FORCE_CGB flag when hw mode is GBC or GBA."
+    note: "Mapped at 0x0000-0x08FF with cartridge data preserved at 0x0100-0x01FF. Also used for GBA mode with a patch at 0xF2. Presence required for FORCE_CGB flag when hw mode is GBC or GBA."
--- a/emulators/geargrafx.yml
+++ b/emulators/geargrafx.yml
@@ -41,7 +41,7 @@ files:
    required: true
    validation: [size, crc32]
    source_ref: "libretro.cpp:453,471-473, media.cpp:241-307, defines.h:52, game_db.h:50,52"
-    notes: >
+    note: >
      Default BIOS for CD-ROM games (cdrom_bios Auto or System Card 3).
      game_db.h recognizes Japan (CRC32 6D9A73EF) and USA (CRC32 2B5B75FE)
      variants under the same filename.
@@ -52,7 +52,7 @@ files:
    required: false
    validation: [size, crc32]
    source_ref: "libretro.cpp:452,462-463, media.cpp:241-307, game_db.h:48-49,51"
-    notes: >
+    note: >
      cdrom_bios = 'System Card 2'. For older CD-ROM2 titles. game_db.h
      recognizes three variants: v2.0 Japan (CRC32 52520BC6), v2.1 Japan
      (CRC32 283B74E0), and USA (CRC32 FF2A5EC3).
@@ -63,7 +63,7 @@ files:
    required: false
    validation: [size, crc32]
    source_ref: "libretro.cpp:451,459-460, media.cpp:241-307, game_db.h:47"
-    notes: >
+    note: >
      cdrom_bios = 'System Card 1'. Very early CD-ROM2 games only.
      CRC32 3F9F95A4.

@@ -73,7 +73,7 @@ files:
    required: false
    validation: [size, crc32]
    source_ref: "libretro.cpp:454,468-469,481-482, media.cpp:241-307, defines.h:53, game_db.h:53-54"
-    notes: >
+    note: >
      Always loaded alongside the selected System Card BIOS (libretro.cpp:481).
      Required for Game Express CD-ROM titles. game_db.h recognizes Blue Version
      (CRC32 51A12D90) and Green Version (CRC32 16AAF05A).
--- a/emulators/gearlynx.yml
+++ b/emulators/gearlynx.yml
@@ -44,4 +44,4 @@ files:
    crc32: "0d973c9d"
    validation: [size, crc32]
    source_ref: "libretro.cpp:105-129 (load_bootroms), media.cpp:274-329 (LoadBios), defines.h:52 (GLYNX_BIOS_SIZE=0x200), game_db.h:38 (GLYNX_DB_BIOS_CRC=0x0D973C9D), gearlynx_core_inline.h:33-37 (no-bios guard)"
-    notes: "512-byte boot ROM validated by CRC32 after load. Invalid CRC logs a warning but still works. Missing or wrong-size file blocks emulation entirely (no HLE fallback)."
+    note: "512-byte boot ROM validated by CRC32 after load. Invalid CRC logs a warning but still works. Missing or wrong-size file blocks emulation entirely (no HLE fallback)."
--- a/emulators/gearsystem.yml
+++ b/emulators/gearsystem.yml
@@ -44,7 +44,7 @@ platform_details:
  mastersystem:
    bios_filename: "bios.sms"
    source_ref: "src/Memory.cpp:223-228"
-    notes: |
+    note: |
      Boot ROM loaded via LoadBootromSMS() -> LoadBootroom(path, false).
      Raw binary read, stored in m_pBootromSMS. Bank count computed as
      Pow2Ceil(size / 0x4000). Memory mapping controlled by port 3E bit 3.
@@ -52,13 +52,13 @@ platform_details:
  gamegear:
    bios_filename: "bios.gg"
    source_ref: "src/Memory.cpp:230-235"
-    notes: |
+    note: |
      Boot ROM loaded via LoadBootromGG() -> LoadBootroom(path, true).
      Raw binary read, stored in m_pBootromGG. Same bank computation.
      Supports standard GG BIOS and Majesco 1KB variant.

  sg1000:
    bios_filename: null
-    notes: |
+    note: |
      No BIOS support. Memory.cpp:291 returns false from IsBootromEnabled()
      when IsSG1000() or IsGameGearInSMSMode() is true.
--- a/emulators/genesis_plus_gx.yml
+++ b/emulators/genesis_plus_gx.yml
@@ -127,7 +127,7 @@ platform_details:
  megacd:
    bootrom_size: 131072      # 128 KB
    source_ref: "core/cd_hw/scd.h:73"
-    notes: |
+    note: |
      CD boot ROM region is auto-detected from disc image header.
      Hardware model detected from boot ROM string at offset 0x120:
        WONDER-MEGA BOOT -> Wondermega
@@ -137,14 +137,14 @@ platform_details:
  megadrive:
    tmss_rom_size: 2048       # 2 KB
    source_ref: "libretro/libretro.c:3648-3666"
-    notes: |
+    note: |
      TMSS boot ROM validated by checking "GENESIS OS" at offset 0x120.
      Only loaded when genesis_plus_gx_bios core option is enabled.

  mastersystem:
    bios_max_size: 4194304    # 4 MB (stored above cart ROM)
    source_ref: "core/loadrom.c:504-527"
-    notes: |
+    note: |
      BIOS ROM loaded into cart.rom + 0x400000. SEGA mapper assumed
      for ROMs larger than 48KB, otherwise no mapper.
      Region selected based on current region_code setting.
@@ -152,6 +152,6 @@ platform_details:
  gamegear:
    bios_max_size: 4194304    # 4 MB (stored above cart ROM)
    source_ref: "core/loadrom.c:467-489"
-    notes: |
+    note: |
      Handles 1KB Majesco GG BIOS (mapped to $0000-$03FF) and
      standard larger BIOS ROMs.
--- a/emulators/gpsp.yml
+++ b/emulators/gpsp.yml
@@ -50,7 +50,7 @@ platform_details:
    bios_size: 16384
    hle_bios: true
    source_ref: "libretro/libretro.c:1100-1131, bios/source/"
-    notes: |
+    note: |
      The built-in BIOS (open_gba_bios_rom, 16 KB) is an open-source
      reimplementation compiled from bios/source/. It implements most
      SWI calls (SoftReset, RegisterRamReset, Halt, VBlankIntrWait,
--- a/emulators/handy.yml
+++ b/emulators/handy.yml
@@ -45,11 +45,11 @@ files:
    crc32: "0d973c9d"
    validation: [size, crc32]
    source_ref: "rom.h:48-49 (ROM_SIZE=0x200, ROM_CRC32=0x0D973C9D), rom.cpp:76-129 (CRom constructor), libretro.cpp:1231-1258 (bios path + CSystem init)"
-    notes: "Validated by CRC32 at load time. If invalid or missing, core uses HLE fallback (system.cpp:303-361 HLE_BIOS_* functions, system.cpp:406-428 trap writes)."
+    note: "Validated by CRC32 at load time. If invalid or missing, core uses HLE fallback (system.cpp:303-361 HLE_BIOS_* functions, system.cpp:406-428 trap writes)."

  - name: "howard.o"
    system: atari-lynx
    description: "Epyx Howard bootloader for headerless cartridges"
    required: false
    source_ref: "system.cpp:197-238 (CartHeaderLess check, howard.o load via fill_pathname_resolve_relative)"
-    notes: "Loaded only for headerless carts (no LNX/BS93 header). Resolved relative to the BIOS file path (system directory). Passed to CRam for execution. Most commercial games have headers and skip this entirely."
+    note: "Loaded only for headerless carts (no LNX/BS93 header). Resolved relative to the BIOS file path (system directory). Passed to CRam for execution. Most commercial games have headers and skip this entirely."
--- a/emulators/jaxe.yml
+++ b/emulators/jaxe.yml
@@ -41,7 +41,7 @@ platform_details:
  bios_mapping:
    target: "none"
    source_ref: "jaxe_libretro.info:17, src/chip8.c:118-168"
-    notes: |
+    note: |
      All font/sprite data is compiled into the binary. The standard
      CHIP-8 hex font (5 bytes per character, 16 characters) and the
      SCHIP big hex font (10 bytes per character, 16 characters) are
--- a/emulators/jollycv.yml
+++ b/emulators/jollycv.yml
@@ -53,7 +53,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "libretro/libretro.c:701, src/jcv_coleco.c:402-406"
-    notes: "Mapped at 0x0000-0x1FFF. Replaced by SGM lower RAM when Super Game Module is active. Must be exactly 8192 bytes."
+    note: "Mapped at 0x0000-0x1FFF. Replaced by SGM lower RAM when Super Game Module is active. Must be exactly 8192 bytes."

  # --- CreatiVision BIOS (required for CreatiVision games) ---
  - name: "bioscv.rom"
@@ -63,7 +63,7 @@ files:
    size: 2048
    validation: [size]
    source_ref: "libretro/libretro.c:711, src/jcv_crvision.c:315-318"
-    notes: "Mapped at 0xF800-0xFFFF. Must be exactly 2048 bytes."
+    note: "Mapped at 0xF800-0xFFFF. Must be exactly 2048 bytes."

 platform_details:
  colecovision:
@@ -80,4 +80,4 @@ platform_details:

  myvision:
    bios_required: false
-    notes: "No BIOS needed. My Vision games run without any system ROM."
+    note: "No BIOS needed. My Vision games run without any system ROM."
--- a/emulators/mednafen_pce.yml
+++ b/emulators/mednafen_pce.yml
@@ -27,21 +27,21 @@ files:
    region: "NTSC-J"
    required: true
    source_ref: "libretro.cpp:1051-1052, settings.cpp:40"
-    notes: "Default value for pce_cdbios option."
+    note: "Default value for pce_cdbios option."

  - name: "syscard2.pce"
    description: "CD-ROM System Card 2.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:1053-1054"
-    notes: "pce_cdbios = 'System Card 2'."
+    note: "pce_cdbios = 'System Card 2'."

  - name: "syscard1.pce"
    description: "CD-ROM System Card 1.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:1055-1056"
-    notes: "pce_cdbios = 'System Card 1'."
+    note: "pce_cdbios = 'System Card 1'."

  - name: "gexpress.pce"
    description: "Games Express CD Card"
@@ -49,18 +49,18 @@ files:
    required: false
    aliases: ["gecard.pce"]
    source_ref: "libretro.cpp:1057-1058, settings.cpp:41, pce.cpp:373-411"
-    notes: "pce_cdbios = 'Games Express' or auto-detected via DetectGECD()."
+    note: "pce_cdbios = 'Games Express' or auto-detected via DetectGECD()."

  - name: "syscard3u.pce"
    description: "CD-ROM System Card 3.0 (US / TurboGrafx-CD)"
    region: "NTSC-U"
    required: false
    source_ref: "libretro.cpp:1059-1060"
-    notes: "pce_cdbios = 'System Card 3 US'. Not in .info."
+    note: "pce_cdbios = 'System Card 3 US'. Not in .info."

  - name: "syscard2u.pce"
    description: "CD-ROM System Card 2.0 (US / TurboGrafx-CD)"
    region: "NTSC-U"
    required: false
    source_ref: "libretro.cpp:1061-1062"
-    notes: "pce_cdbios = 'System Card 2 US'. Not in .info."
+    note: "pce_cdbios = 'System Card 2 US'. Not in .info."
--- a/emulators/mednafen_pce_fast.yml
+++ b/emulators/mednafen_pce_fast.yml
@@ -25,21 +25,21 @@ files:
    region: "NTSC-J"
    required: true
    source_ref: "libretro.cpp:67, libretro.cpp:1755-1760"
-    notes: "Default value for pce_fast_cdbios option."
+    note: "Default value for pce_fast_cdbios option."

  - name: "syscard2.pce"
    description: "CD-ROM System Card 2.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:1762"
-    notes: "pce_fast_cdbios = 'System Card 2'."
+    note: "pce_fast_cdbios = 'System Card 2'."

  - name: "syscard1.pce"
    description: "CD-ROM System Card 1.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:1764"
-    notes: "pce_fast_cdbios = 'System Card 1'."
+    note: "pce_fast_cdbios = 'System Card 1'."

  - name: "gexpress.pce"
    description: "Games Express CD Card"
@@ -47,18 +47,18 @@ files:
    required: false
    aliases: ["gecard.pce"]
    source_ref: "libretro.cpp:1765-1766"
-    notes: "pce_fast_cdbios = 'Games Express'. For unlicensed Games Express titles."
+    note: "pce_fast_cdbios = 'Games Express'. For unlicensed Games Express titles."

  - name: "syscard3u.pce"
    description: "CD-ROM System Card 3.0 (US / TurboGrafx-CD)"
    region: "NTSC-U"
    required: false
    source_ref: "libretro.cpp:1767-1768"
-    notes: "pce_fast_cdbios = 'System Card 3 US'. Not in .info."
+    note: "pce_fast_cdbios = 'System Card 3 US'. Not in .info."

  - name: "syscard2u.pce"
    description: "CD-ROM System Card 2.0 (US / TurboGrafx-CD)"
    region: "NTSC-U"
    required: false
    source_ref: "libretro.cpp:1769-1770"
-    notes: "pce_fast_cdbios = 'System Card 2 US'. Not in .info."
+    note: "pce_fast_cdbios = 'System Card 2 US'. Not in .info."
--- a/emulators/mednafen_supergrafx.yml
+++ b/emulators/mednafen_supergrafx.yml
@@ -29,25 +29,25 @@ files:
    region: "NTSC-J"
    required: true
    source_ref: "libretro.cpp:972-973, mednafen/settings.cpp:37"
-    notes: "Default value for sgx_cdbios option."
+    note: "Default value for sgx_cdbios option."

  - name: "syscard2.pce"
    description: "CD-ROM System Card 2.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:974-975"
-    notes: "sgx_cdbios = 'System Card 2'."
+    note: "sgx_cdbios = 'System Card 2'."

  - name: "syscard1.pce"
    description: "CD-ROM System Card 1.0 (Japan)"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:976-977"
-    notes: "sgx_cdbios = 'System Card 1'."
+    note: "sgx_cdbios = 'System Card 1'."

  - name: "gexpress.pce"
    description: "Games Express CD Card"
    region: "NTSC-J"
    required: false
    source_ref: "libretro.cpp:978-979, mednafen/pce_fast/pce.cpp:330-367,453-454"
-    notes: "sgx_cdbios = 'Games Express' or auto-detected via DetectGECD()."
+    note: "sgx_cdbios = 'Games Express' or auto-detected via DetectGECD()."
--- a/emulators/melonds.yml
+++ b/emulators/melonds.yml
@@ -26,7 +26,7 @@ files:
    validation: {core: [size], upstream: [size, crc32]}
    crc32: "0x2ab23573"
    source_ref: "src/NDS.h:196, src/NDS.cpp:467-477, src/frontend/Util_ROM.cpp:99-111"
-    notes: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 cartridge crypto"
+    note: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 cartridge crypto"

  - name: bios7.bin
    system: nintendo-ds
@@ -37,7 +37,7 @@ files:
    validation: {core: [size], upstream: [size, crc32]}
    crc32: "0x1280f0d5"
    source_ref: "src/NDS.h:197, src/NDS.cpp:482-492, src/frontend/Util_ROM.cpp:117-131"
-    notes: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 init at offset 0x0030"
+    note: "FreeBIOS fallback (src/FreeBIOS.h); native needed for Key1 init at offset 0x0030"

  - name: firmware.bin
    system: nintendo-ds
@@ -46,7 +46,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "src/SPI.cpp:192-211, src/frontend/Util_ROM.cpp:174-195"
-    notes: "Generated 128KB firmware as fallback; native must be 256KB or 512KB for boot"
+    note: "Generated 128KB firmware as fallback; native must be 256KB or 512KB for boot"

  # --- Nintendo DSi (TWL) ---
  - name: dsi_bios9.bin
@@ -66,7 +66,7 @@ files:
    validation: {core: [size], upstream: [size, crc32]}
    crc32: "0x4316CC42"
    source_ref: "src/DSi.h:34, src/DSi.cpp:604-620, src/frontend/Util_ROM.cpp:158-170"
-    notes: "Contains eMMC key-Y at offset 0x8308 for NAND init"
+    note: "Contains eMMC key-Y at offset 0x8308 for NAND init"

  - name: dsi_firmware.bin
    system: nintendo-dsi
@@ -81,11 +81,11 @@ files:
    description: "DSi NAND dump"
    required: true
    source_ref: "src/frontend/Util_ROM.cpp:224-235, src/DSi_NAND.cpp"
-    notes: "Uses AES keys from ARM7i BIOS offset 0x8308"
+    note: "Uses AES keys from ARM7i BIOS offset 0x8308"

  - name: dsi_sd_card.bin
    system: nintendo-dsi
    description: "DSi SD card image"
    required: false
    source_ref: "src/frontend/Util_ROM.cpp:237-243, src/libretro/libretro.cpp:837,553"
-    notes: "Created if missing; requires melonds_dsi_sdcard core option enabled"
+    note: "Created if missing; requires melonds_dsi_sdcard core option enabled"
--- a/emulators/melonds_ds.yml
+++ b/emulators/melonds_ds.yml
@@ -46,7 +46,7 @@ files:
    required: false
    hle_fallback: true
    source_ref: "src/libretro/config/console.cpp:184"
-    notes: "Filename configurable via core options; generated firmware used as fallback"
+    note: "Filename configurable via core options; generated firmware used as fallback"

  # --- Nintendo DSi (TWL) ---
  - name: dsi_bios7.bin
@@ -57,7 +57,7 @@ files:
    validation: [size]
    crc32: "0x4316CC42"
    source_ref: "src/libretro/config/console.cpp:333, melonDS:src/MemConstants.h:32,44"
-    notes: "Contains eMMC key-Y at offset 0x8308 for NAND init"
+    note: "Contains eMMC key-Y at offset 0x8308 for NAND init"

  - name: dsi_bios9.bin
    system: nintendo-dsi
@@ -73,11 +73,11 @@ files:
    description: "DSi firmware image"
    required: true
    source_ref: "src/libretro/config/console.cpp:352-358"
-    notes: "Filename configurable via core options; must have DSi firmware header"
+    note: "Filename configurable via core options; must have DSi firmware header"

  - name: dsi_nand.bin
    system: nintendo-dsi
    description: "DSi NAND dump"
    required: true
    source_ref: "src/libretro/config/console.cpp:378"
-    notes: "Filename configurable via core options; 240MB or 245.5MB with optional no$cash footer"
+    note: "Filename configurable via core options; 240MB or 245.5MB with optional no$cash footer"
--- a/emulators/mesen.yml
+++ b/emulators/mesen.yml
@@ -49,7 +49,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "Core/FdsLoader.cpp:45-59 (LoadBios tries FdsBios.bin then disksys.rom), Core/FdsLoader.cpp:143-146 (LoadRom validates size == 0x2000)"
-    notes: "Mapped at 0xE000-0xFFFF as PRG ROM bank 0. Core checks FdsBios.bin first, falls back to disksys.rom. Size must be exactly 8192 bytes or BiosMissing is set."
+    note: "Mapped at 0xE000-0xFFFF as PRG ROM bank 0. Core checks FdsBios.bin first, falls back to disksys.rom. Size must be exactly 8192 bytes or BiosMissing is set."

  - name: "StudyBox.bin"
    system: nintendo-nes
@@ -58,7 +58,7 @@ files:
    size: 262144
    validation: [size]
    source_ref: "Core/StudyBoxLoader.cpp:125-133 (LoadBios), Core/StudyBoxLoader.cpp:149-152 (LoadRom validates size == 0x40000)"
-    notes: "256 KB BIOS for the Study Box tape peripheral (mapper 186). Only needed for .stbx tape dumps. Size must be exactly 262144 bytes."
+    note: "256 KB BIOS for the Study Box tape peripheral (mapper 186). Only needed for .stbx tape dumps. Size must be exactly 262144 bytes."

  - name: "MesenPalette.pal"
    system: nintendo-nes
@@ -66,4 +66,4 @@ files:
    required: false
    source_ref: "Libretro/libretro.cpp:301-323 (load_custom_palette), Libretro/libretro.cpp:405-406 (called when mesen_palette == Custom)"
    validation: [size]
-    notes: "Loaded when mesen_palette core option is Custom. Accepts exactly 192 bytes (64 RGB triplets) or 1536 bytes (512 entries for emphasis combos). Falls back to built-in default palette if size doesn't match."
+    note: "Loaded when mesen_palette core option is Custom. Accepts exactly 192 bytes (64 RGB triplets) or 1536 bytes (512 entries for emphasis combos). Falls back to built-in default palette if size doesn't match."
--- a/emulators/meteor.yml
+++ b/emulators/meteor.yml
@@ -26,7 +26,7 @@ platform_details:
    bios_size: 16384
    hle_bios: true
    source_ref: "ameteor/source/bios.cpp, ameteor/source/cpu.cpp:245-311"
-    notes: |
+    note: |
      Full HLE BIOS. The libretro port never loads an external BIOS file.
      Cpu::SoftwareInterrupt() checks HasBios() — if false (always in
      libretro), SWI calls are routed to C++ reimplementations.
--- a/emulators/mgba.yml
+++ b/emulators/mgba.yml
@@ -96,7 +96,7 @@ platform_details:
    bios_size: 16384  # 16 KB
    hle_bios: true
    source_ref: "src/gba/hle-bios.c, src/gba/gba.c:520-551"
-    notes: |
+    note: |
      GBALoadBIOS() validates size (must be exactly 0x4000) then computes
      an internal checksum. Two official checksums are recognized:
        GBA_BIOS_CHECKSUM    = 0xBAAE187F (standard GBA)
@@ -107,7 +107,7 @@ platform_details:
    bios_size: 256  # 256 B
    hle_bios: false
    source_ref: "src/gb/gb.c:570-605"
-    notes: |
+    note: |
      GBIsBIOS() validates by CRC32. Accepted DMG-family checksums:
        DMG0 = 0xC2F5CC97, DMG = 0x59C8598E, MGB = 0xE6920754
      Files not matching any known checksum are rejected.
@@ -116,7 +116,7 @@ platform_details:
    bios_size: 2304  # 2304 B (0x900)
    hle_bios: false
    source_ref: "src/gb/gb.c:570-605"
-    notes: |
+    note: |
      Accepted CGB-family CRC32 checksums:
        CGB = 0x41884E46, CGB0 = 0xE8EF5318, CGBE = 0xE95DC95D
        AGB = 0xFFD6B0F1, AGB0 = 0x570337EA
@@ -125,7 +125,7 @@ platform_details:
    bios_size: 256  # 256 B
    hle_bios: false
    source_ref: "src/gb/gb.c:570-605, src/gb/core.c:642-644"
-    notes: |
+    note: |
      Accepted SGB CRC32 checksums:
        SGB = 0xEC8A83B9, SGB2 = 0x53D0DD63
      SGB2 maps here in standalone (marked TODO upstream). Libretro port
--- a/emulators/nestopia.yml
+++ b/emulators/nestopia.yml
@@ -43,7 +43,7 @@ files:
    md5: "ca30b50f880eb660a320674ed365ef7a"
    sha1: "57fe1bdee955bb48d357e463ccbf129496930b62"
    source_ref: "libretro/libretro.cpp:1608-1634 (FDS load), source/core/NstFds.cpp:61-131 (Bios class, CRC32 validation)"
-    notes: "Mapped at 0xE000-0xFFFF (8 KB). retro_load_game returns false if missing when loading .fds files. CRC32 checked: Famicom 0x5E607DCF, Twin Famicom 0x4DF24A6C."
+    note: "Mapped at 0xE000-0xFFFF (8 KB). retro_load_game returns false if missing when loading .fds files. CRC32 checked: Famicom 0x5E607DCF, Twin Famicom 0x4DF24A6C."

  # --- NES game database (optional, overrides baked-in copy) ---
  - name: "NstDatabase.xml"
@@ -52,7 +52,7 @@ files:
    required: false
    hle_fallback: true
    source_ref: "libretro/libretro.cpp:1561-1586 (database load), libretro/nstdatabase.hpp (baked-in fallback)"
-    notes: "XML database matching games by SHA1+CRC32. Used for region, mapper, mirroring, and 4-player adapter detection. Built-in fallback exists so this file is optional."
+    note: "XML database matching games by SHA1+CRC32. Used for region, mapper, mirroring, and 4-player adapter detection. Built-in fallback exists so this file is optional."

  # --- Custom palette (optional, core option nestopia_palette = Custom) ---
  - name: "custom.pal"
@@ -62,7 +62,7 @@ files:
    hle_fallback: true
    size: 192
    source_ref: "libretro/libretro.cpp:1540-1559 (palette load)"
-    notes: "64 RGB triplets (64 x 3 bytes = 192 bytes). Loaded unconditionally at startup; applied only when nestopia_palette core option is set to Custom. Falls back to built-in Royaltea palette. Multiple valid palettes exist so no canonical hash."
+    note: "64 RGB triplets (64 x 3 bytes = 192 bytes). Loaded unconditionally at startup; applied only when nestopia_palette core option is set to Custom. Falls back to built-in Royaltea palette. Multiple valid palettes exist so no canonical hash."

  # --- ADPCM audio samples (optional, game-specific) ---
  - name: "nestopia/samples/moepro/"
--- a/emulators/noods.yml
+++ b/emulators/noods.yml
@@ -28,7 +28,7 @@ files:
    hle_fallback: true
    size: 4096
    source_ref: "src/memory.cpp:130-141"
-    notes: "HLE fallback for all SWI calls; native needed for firmware boot and logo verification (copyBiosLogo)"
+    note: "HLE fallback for all SWI calls; native needed for firmware boot and logo verification (copyBiosLogo)"

  - name: "bios7.bin"
    system: nintendo-ds
@@ -37,7 +37,7 @@ files:
    hle_fallback: true
    size: 16384
    source_ref: "src/memory.cpp:144-155"
-    notes: "HLE fallback for all SWI calls; native needed for firmware boot"
+    note: "HLE fallback for all SWI calls; native needed for firmware boot"

  - name: "firmware.bin"
    system: nintendo-ds
@@ -45,7 +45,7 @@ files:
    required: false
    hle_fallback: true
    source_ref: "src/spi.cpp:62-160"
-    notes: "Auto-generated 128KB non-bootable firmware as fallback; native dump (>128KB) needed for firmware boot"
+    note: "Auto-generated 128KB non-bootable firmware as fallback; native dump (>128KB) needed for firmware boot"

  - name: "gba_bios.bin"
    system: nintendo-gba
@@ -54,11 +54,11 @@ files:
    hle_fallback: true
    size: 16384
    source_ref: "src/memory.cpp:158-168, src/core.cpp:252-256"
-    notes: "HLE fallback via swiTableGba; native BIOS disables HLE and enables real GBA boot"
+    note: "HLE fallback via swiTableGba; native BIOS disables HLE and enables real GBA boot"

  - name: "nds_sd_card.bin"
    system: nintendo-ds
    description: "DLDI SD card image for homebrew"
    required: false
    source_ref: "src/dldi.cpp:80-83, src/libretro/libretro.cpp:331"
-    notes: "Opened on DLDI startup() call from homebrew ROMs; user-created FAT image"
+    note: "Opened on DLDI startup() call from homebrew ROMs; user-created FAT image"
--- a/emulators/numero.yml
+++ b/emulators/numero.yml
@@ -40,18 +40,18 @@ files:
    description: "TI-83 Plus Silver Edition ROM dump"
    required: false
    source_ref: "libretronew.cpp:576-578"
-    notes: "Checked first. Recommended for largest storage capacity."
+    note: "Checked first. Recommended for largest storage capacity."

  - name: "ti83plus.rom"
    system: ti-83
    description: "TI-83 Plus ROM dump"
    required: false
    source_ref: "libretronew.cpp:583-585"
-    notes: "Checked second, used if ti83se.rom is missing."
+    note: "Checked second, used if ti83se.rom is missing."

  - name: "ti83.rom"
    system: ti-83
    description: "TI-83 ROM dump"
    required: false
    source_ref: "libretronew.cpp:591-593"
-    notes: "Checked last. Original TI-83 (non-Plus)."
+    note: "Checked last. Original TI-83 (non-Plus)."
--- a/emulators/nxengine.yml
+++ b/emulators/nxengine.yml
@@ -45,7 +45,7 @@ files:
    md5: "38695d3d69d7a0ada8178072dad4c58b"
    sha1: "bb2d0441e073da9c584f23c2ad8c7ab8aac293bf"
    source_ref: "main.cpp:77-78 (opened for extraction), libretro.cpp:258 (existence check)"
-    notes: "Placed in system/nxengine/. The core extracts ORG music, PXT sounds, stage tile attributes, BMP graphics, and wavetable from this binary at each launch."
+    note: "Placed in system/nxengine/. The core extracts ORG music, PXT sounds, stage tile attributes, BMP graphics, and wavetable from this binary at each launch."

  - name: "data/"
    path: "nxengine/data/"
@@ -54,7 +54,7 @@ files:
    description: "Full game asset directory tree (399 files: sprites, NPC sheets, stage maps, scripts, backgrounds)"
    required: true
    source_ref: "cachefiles.c:38-439 (filenames[] array loaded at init)"
-    notes: "Must contain root assets (Arms.pbm, MyChar.pbm, etc.), Npc/ (36 sprite sheets), and Stage/ (333 map/script/tileset files). All files from the original freeware release."
+    note: "Must contain root assets (Arms.pbm, MyChar.pbm, etc.), Npc/ (36 sprite sheets), and Stage/ (333 map/script/tileset files). All files from the original freeware release."

  - name: "data/npc.tbl"
    path: "nxengine/data/npc.tbl"
@@ -63,7 +63,7 @@ files:
    description: "NPC attribute table (entity behavior flags, HP, damage, display rect offsets)"
    required: true
    source_ref: "main.cpp:50 (existence check for data/ directory), ai/ai.cpp:56-59 (loaded for NPC properties)"
-    notes: "Located in system/nxengine/data/. Used to validate data directory presence and to load NPC behavior attributes."
+    note: "Located in system/nxengine/data/. Used to validate data directory presence and to load NPC behavior attributes."

  - name: "data/sprites.sif"
    path: "nxengine/data/sprites.sif"
@@ -73,7 +73,7 @@ files:
    required: false
    hle_fallback: true
    source_ref: "cachefiles.c:101 (in filenames[]), cachefiles.c:515-521 (compiled-in fallback from sprites_sif.h)"
-    notes: "Not shipped in the freeware distribution. If missing, the core uses a compiled-in copy (sprites_sif.h)."
+    note: "Not shipped in the freeware distribution. If missing, the core uses a compiled-in copy (sprites_sif.h)."

  - name: "tilekey.dat"
    path: "nxengine/tilekey.dat"
@@ -82,4 +82,4 @@ files:
    description: "Tile attribute lookup table (maps tile codes to collision/behavior attributes)"
    required: false
    source_ref: "map.cpp:290-303 (loaded at init, hardcoded default if missing)"
-    notes: "Not part of the freeware distribution. Generated by the standalone NXEngine extraction tool. The libretro core has hardcoded defaults in map.cpp:30."
+    note: "Not part of the freeware distribution. Generated by the standalone NXEngine extraction tool. The libretro core has hardcoded defaults in map.cpp:30."
--- a/emulators/panda3ds.yml
+++ b/emulators/panda3ds.yml
@@ -27,7 +27,7 @@ files:
    description: "AES encryption keys for decrypting encrypted ROMs"
    required: false
    source_ref: "src/emulator.cpp:229,237-238, src/core/crypto/aes_engine.cpp:13-92"
-    notes: |
+    note: |
      Loaded at ROM load time from appDataRoot/sysdata/aes_keys.txt.
      In libretro mode, appDataRoot = <save_dir>/Emulator Files/.
      Contains key slot entries (generator, keyX, keyY, normalKey).
@@ -39,7 +39,7 @@ files:
    description: "Seed database for seed-encrypted games"
    required: false
    source_ref: "src/emulator.cpp:230,241-242, src/core/loader/ncch.cpp:78-93"
-    notes: |
+    note: |
      Used for titles with seed encryption (firmware 9.6+).
      Placed alongside aes_keys.txt in the sysdata directory.
      Without it, seed-encrypted titles fail to load with a warning.
--- a/emulators/pcsx_rearmed.yml
+++ b/emulators/pcsx_rearmed.yml
@@ -29,7 +29,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[0])"
-    notes: "Preferred JP BIOS, searched first by exact filename."
+    note: "Preferred JP BIOS, searched first by exact filename."

  # -- Region: North America (PSX_REGION_US = 0) --

@@ -41,7 +41,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[1])"
-    notes: "Preferred US BIOS, searched first by exact filename."
+    note: "Preferred US BIOS, searched first by exact filename."

  # -- Region: Europe (PSX_REGION_EU = 2) --

@@ -53,7 +53,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[2])"
-    notes: "Preferred EU BIOS, searched first by exact filename."
+    note: "Preferred EU BIOS, searched first by exact filename."

  # -- Fallback BIOS filenames (searched in order after scph550x) --

@@ -65,7 +65,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[3])"
-    notes: "Region detected from content at runtime. Must be 512 KB in libretro context."
+    note: "Region detected from content at runtime. Must be 512 KB in libretro context."

  - name: "scph101.bin"
    description: "SCPH-101 (v4.4 03-24-00 A) - PSone US"
@@ -75,7 +75,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[4])"
-    notes: "PSone slim model."
+    note: "PSone slim model."

  - name: "scph7001.bin"
    description: "SCPH-7001 (v4.1 12-16-97 A)"
@@ -94,7 +94,7 @@ files:
    hle_fallback: true
    validation: [size]
    source_ref: "frontend/libretro.c:3721-3724 (listed_bios[6])"
-    notes: "Original US model. Last in the explicit filename search list."
+    note: "Original US model. Last in the explicit filename search list."

  # -- Dynamic scan fallback --
  # After exhausting listed_bios[], the core calls find_any_bios() which scans
--- a/emulators/pokemini.yml
+++ b/emulators/pokemini.yml
@@ -59,20 +59,20 @@ files:
    hle_fallback: true
    size: 4096
    source_ref: "source/PokeMini.c:189-206 (PokeMini_LoadBIOSFile), libretro/libretro.c:565 (path)"
-    notes: "Mapped at $000000-$000FFF (4 KB). Read via Hardware.c:144-145. Falls back to embedded FreeBIOS if missing."
+    note: "Mapped at $000000-$000FFF (4 KB). Read via Hardware.c:144-145. Falls back to embedded FreeBIOS if missing."

 platform_details:
  bios_mapping:
    target: "$000000-$000FFF in Pokemon Mini address space (4 KB)"
    source_ref: "source/PokeMini.h:38, source/Hardware.c:144-145"
-    notes: |
+    note: |
      PM_BIOS is a 4096-byte array. CPU reads from address range
      $000000-$000FFF are served directly from this buffer. The BIOS
      handles interrupt vectors, hardware init, and the startup logo.

  freebios_fallback:
    source_ref: "freebios/freebios.c, source/PokeMini.c:209-214"
-    notes: |
+    note: |
      FreeBIOS is a 4096-byte open-source replacement embedded in the
      binary as a C array. It provides basic interrupt vectors and
      startup code. Loaded by default at PokeMini_Create() and used
@@ -84,7 +84,7 @@ platform_details:

  load_priority:
    source_ref: "source/PokeMini.c:515-523"
-    notes: |
+    note: |
      During PokeMini_Reset(), the core first reloads FreeBIOS as a
      safe baseline, then attempts to load bios.min from disk. If
      the file exists and is exactly 4096 bytes, it replaces FreeBIOS.
--- a/emulators/prboom.yml
+++ b/emulators/prboom.yml
@@ -51,4 +51,4 @@ files:
    sha1: "5f4aed208301449c2e9514edfd325fe9dead76fa"
    crc32: "a5751b99"
    source_ref: "d_main.c:1069-1078 (PACKAGE .wad load), libretro.c:1742-1784 (I_FindFile search), config.h:46 (PACKAGE=prboom)"
-    notes: "Searched in system/prboom/ then system/. Falls back to internal defaults if missing, but menus and HUD may render incorrectly without it."
+    note: "Searched in system/prboom/ then system/. Falls back to internal defaults if missing, but menus and HUD may render incorrectly without it."
--- a/emulators/race.yml
+++ b/emulators/race.yml
@@ -35,7 +35,7 @@ analysis:
    source_ref: "race-memory.c:337-361"
    upstream_status: optional
    upstream_ref: "memory.cpp:346-365 (8bitpsp/race)"
-    notes: |
+    note: |
      loadBIOS() is wrapped in #if 0 and always returns 0 in the libretro port.
      In upstream (8bitpsp/race, alekmaul/race), the function is live and loads
      NPBIOS.BIN optionally, falling back to HLE if not found.
--- a/emulators/rustation.yml
+++ b/emulators/rustation.yml
@@ -95,7 +95,7 @@ files:
    validation: [size, sha256]
    sha256: "0c8359870cbac0ea091f1c87f188cd332dcc709753b91cafd9fd44a4a6188197"
    source_ref: "rustation/src/bios/db.rs:108-117 (v2.2 Japan)"
-    notes: "A known-bad v2.2 J dump also exists in the DB but is rejected."
+    note: "A known-bad v2.2 J dump also exists in the DB but is rejected."

  - name: "scph5000.bin"
    description: "v2.2 J (alt)"
--- a/emulators/sameboy.yml
+++ b/emulators/sameboy.yml
@@ -67,7 +67,7 @@ files:
    hle_fallback: true
    size: 256
    source_ref: "libretro.c:521,532,556; Core/gb.c:1600-1604"
-    notes: "Used for SGB_NTSC, SGB_PAL models. Also loaded when borrowing SGB border (Core/gb.c:264)."
+    note: "Used for SGB_NTSC, SGB_PAL models. Also loaded when borrowing SGB border (Core/gb.c:264)."

  - name: "sgb2_boot.bin"
    system: nintendo-sgb
@@ -84,7 +84,7 @@ files:
    hle_fallback: true
    size: 2304
    source_ref: "libretro.c:524,535,556; Core/gb.c:1613-1618"
-    notes: "Used for CGB revisions A through E in the libretro port."
+    note: "Used for CGB revisions A through E in the libretro port."

  - name: "agb_boot.bin"
    system: nintendo-gbc
@@ -93,7 +93,7 @@ files:
    hle_fallback: true
    size: 2304
    source_ref: "libretro.c:525,536,556; Core/gb.c:1621"
-    notes: "Enables GBA-enhanced palettes in compatible GBC games."
+    note: "Enables GBA-enhanced palettes in compatible GBC games."

 builtin_boot_roms:
  description: |
--- a/emulators/smsplus.yml
+++ b/emulators/smsplus.yml
@@ -39,7 +39,7 @@ files:
    required: false
    aliases: ["BIOS.sms"]
    source_ref: "smsplus_libretro.c:211-229"
-    notes: |
+    note: |
      Loaded into bios.rom (up to 1 MB allocated). Only active when core
      option smsplus_sms_bios is "auto". Displays SMS startup screen
      before game execution. Standalone ports use BIOS.sms (uppercase).
@@ -50,7 +50,7 @@ files:
    required: true
    size: 8192
    source_ref: "smsplus_libretro.c:232-248"
-    notes: |
+    note: |
      Required for ColecoVision games. Read as 0x2000 (8192) bytes into
      coleco.rom. Without this file, retro_load_game() returns false for
      .col files.
@@ -62,7 +62,7 @@ files:
    size: 8192
    mode: standalone
    source_ref: "ports/sdl/smsplus.c:321-329"
-    notes: |
+    note: |
      Read as 0x2000 (8192) bytes into coleco.rom (shared buffer). Only
      in standalone builds (SORDM5_EMU define). Not compiled in libretro.
      Code does not enforce presence but system needs BIOS to function.
--- a/emulators/snes9x.yml
+++ b/emulators/snes9x.yml
@@ -16,7 +16,7 @@ cores:
    source: "https://github.com/libretro/snes9x"
    firmware_loading: true
    hle_only: true
-    notes: |
+    note: |
      Loads BS-X.bin and STBIOS.bin via LoadBIOS() in libretro.cpp.
      BSX_LoadBIOS() in bsx.cpp tries BS-X.bios as fallback.
      Auto-detects Satellaview and Sufami Turbo carts on load.
@@ -33,7 +33,7 @@ files:
    validation: [size]
    source_ref: "libretro.cpp:1209, bsx.cpp:1209,1214"
    aliases: ["BS-X.bios"]
-    notes: "Needed for Satellaview (.bs) games."
+    note: "Needed for Satellaview (.bs) games."

  - name: "STBIOS.bin"
    system: nintendo-sufami-turbo
@@ -42,7 +42,7 @@ files:
    size: 262144
    validation: [size]
    source_ref: "libretro.cpp:1203,1317, memmap.cpp:1672"
-    notes: "Needed for Sufami Turbo multi-cart games."
+    note: "Needed for Sufami Turbo multi-cart games."

 notes:
  coprocessor_hle: |
--- a/emulators/snes9x2010.yml
+++ b/emulators/snes9x2010.yml
@@ -34,7 +34,7 @@ files:
    validation: [size]
    aliases: ["BS-X.bios"]
    source_ref: "src/bsx.c:959-993 (BSX_LoadBIOS), src/bsx.c:1068 (caller in S9xInitBSX)"
-    notes: |
+    note: |
      Loaded when a BS game is auto-detected (is_bsx checks ROM header at
      0x7FC0/0xFFC0). Without this file, BSX.bootup is set to FALSE and
      BIOSROM is zeroed. BS games still load but lack the boot menu.
--- a/emulators/tic80.yml
+++ b/emulators/tic80.yml
@@ -30,13 +30,13 @@ platform_details:
  cartridge_format:
    extensions: "tic, png"
    source_ref: "tic80_libretro.c:339"
-    notes: |
+    note: |
      .tic is the native cartridge format. .png loads cartridges
      encoded as cover images (code stored in PNG metadata).

  runtime:
    source_ref: "nesbox/TIC-80 (submodule at core/)"
-    notes: |
+    note: |
      Entire runtime compiled into the binary. No external dependencies.
      State serialization uses TIC_PERSISTENT_SIZE * 4 bytes of pmem()
      data (tic80_libretro.c:1203-1243).
--- a/emulators/vecx.yml
+++ b/emulators/vecx.yml
@@ -39,7 +39,7 @@ platform_details:
  bios_mapping:
    target: "0xE000-0xFFFF in Vectrex address space (8 KB)"
    source_ref: "vecx.c:40 (unsigned char rom[8192]), vecx.c:437-439 (read handler)"
-    notes: |
+    note: |
      CPU reads from 0xE000-0xFFFF are served from rom[] via
      address & 0x1FFF masking. The array is populated from the
      compiled-in bios_data at retro_load_game() time.
@@ -58,7 +58,7 @@ platform_details:
      md5: "05f32c2b18b6fb168ab976989e86dfb1"
      sha1: "6c891bd74acb201d54071b310bd6df6617cdf205"
      size: 8192
-    notes: |
+    note: |
      All three variants are 8192 bytes, compiled as C arrays in
      bios/*.h headers. STANDARD_BIOS is the authentic Vectrex ROM.
      FAST_BIOS and skip are modified versions for faster startup.
--- a/emulators/vemulator.yml
+++ b/emulators/vemulator.yml
@@ -43,7 +43,7 @@ platform_details:
      - "0x6E = 0xFF"
      - "P3 = 0xFF (no buttons pressed)"
      - "BCD date/time at 0x10-0x16, raw at 0x17-0x1D"
-    notes: |
+    note: |
      HLE skips the BIOS boot sequence and jumps directly into the loaded
      game. System clock, date, and button state are initialized in RAM.
      The EXT register is set to 1 to signal HLE mode to the CPU
@@ -56,7 +56,7 @@ platform_details:
    rom_load_size: 61440
    encryption: "XOR 0x37 after stripping 4-byte header"
    detection: "first byte 0x2A (JMPF) = unencrypted, otherwise encrypted"
-    notes: |
+    note: |
      The loadBIOS() method is fully implemented but unreachable from the
      libretro interface. No system directory query, no BIOS path construction,
      and no call site exists in main.cpp. A future update could wire this up
--- a/emulators/vice_x128.yml
+++ b/emulators/vice_x128.yml
@@ -25,28 +25,28 @@ files:
    description: "JiffyDOS C128 kernal replacement"
    required: false
    source_ref: "retrodep/ui.c:309-310"
-    notes: "Loaded into KernalIntName when vice_jiffydos option is enabled."
+    note: "Loaded into KernalIntName when vice_jiffydos option is enabled."

  - name: "JiffyDOS_C64.bin"
    description: "JiffyDOS C64 kernal replacement (GO64 mode)"
    required: false
    source_ref: "retrodep/ui.c:307-308"
-    notes: "Loaded into Kernal64Name when vice_jiffydos option is enabled."
+    note: "Loaded into Kernal64Name when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1541-II.bin"
    description: "JiffyDOS 1541-II drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1571_repl310654.bin"
    description: "JiffyDOS 1571 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1581.bin"
    description: "JiffyDOS 1581 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."
--- a/emulators/vice_x64.yml
+++ b/emulators/vice_x64.yml
@@ -25,31 +25,31 @@ files:
    description: "JiffyDOS C64 kernal replacement"
    required: false
    source_ref: "retrodep/ui.c:302-303"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."

  - name: "JiffyDOS_SX-64.bin"
    description: "JiffyDOS SX-64 kernal replacement"
    required: false
    source_ref: "retrodep/ui.c:295-296"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."

  - name: "JiffyDOS_1541-II.bin"
    description: "JiffyDOS 1541-II drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1571_repl310654.bin"
    description: "JiffyDOS 1571 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1581.bin"
    description: "JiffyDOS 1581 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."

  - name: "kernal-901227-01.bin"
    description: "C64 Kernal Rev 1"
@@ -57,7 +57,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "vice/src/c64/c64-resources.c:253, vice/src/c64/c64model.c:131"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."

  - name: "kernal-901227-02.bin"
    description: "C64 Kernal Rev 2"
@@ -65,4 +65,4 @@ files:
    size: 8192
    validation: [size]
    source_ref: "vice/src/c64/c64-resources.c:254, vice/src/c64/c64model.c:117"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
--- a/emulators/vice_x64dtv.yml
+++ b/emulators/vice_x64dtv.yml
@@ -25,7 +25,7 @@ files:
    hle_fallback: true
    size: 2097152
    source_ref: "vice/src/c64dtv/c64dtvflash.c:59-64,470-471,488-505"
-    notes: >
+    note: >
      Loaded via sysfile_load from system/vice/C64DTV/. All model variants
      (V2 PAL/NTSC, V3 PAL/NTSC, Hummer) default to this filename. If not
      found, the core copies embedded BASIC, kernal and chargen ROMs into
--- a/emulators/vice_x64sc.yml
+++ b/emulators/vice_x64sc.yml
@@ -26,31 +26,31 @@ files:
    description: "JiffyDOS C64 kernal replacement"
    required: false
    source_ref: "retrodep/ui.c:302-303"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled (non-SX64 models)."

  - name: "JiffyDOS_SX-64.bin"
    description: "JiffyDOS SX-64 kernal replacement"
    required: false
    source_ref: "retrodep/ui.c:295-296"
-    notes: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."
+    note: "Loaded into KernalName when vice_jiffydos option is enabled and SX-64 model selected."

  - name: "JiffyDOS_1541-II.bin"
    description: "JiffyDOS 1541-II drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:283-284"
-    notes: "Loaded into DosName1541ii when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1541ii when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1571_repl310654.bin"
    description: "JiffyDOS 1571 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded into DosName1571 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1571 when vice_jiffydos option is enabled."

  - name: "JiffyDOS_1581.bin"
    description: "JiffyDOS 1581 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded into DosName1581 when vice_jiffydos option is enabled."
+    note: "Loaded into DosName1581 when vice_jiffydos option is enabled."

  - name: "kernal-901227-01.bin"
    description: "C64 Kernal Rev 1"
@@ -58,7 +58,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "vice/src/c64/c64-resources.c:253, vice/src/c64/c64scmodel.c:141"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD NTSC model selected."

  - name: "kernal-901227-02.bin"
    description: "C64 Kernal Rev 2"
@@ -66,4 +66,4 @@ files:
    size: 8192
    validation: [size]
    source_ref: "vice/src/c64/c64-resources.c:254, vice/src/c64/c64scmodel.c:123"
-    notes: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
+    note: "Not embedded. Loaded via sysfile from system/vice/C64/ when C64 OLD PAL model selected."
--- a/emulators/vice_xscpu64.yml
+++ b/emulators/vice_xscpu64.yml
@@ -29,7 +29,7 @@ files:
    max_size: 524288
    validation: [size]
    source_ref: "retrodep/ui.c:262-263, vice/src/scpu64/scpu64rom.c:75-89"
-    notes: "Loaded as SCPU64Name when SuperCPU Kernal option set to 2.04. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
+    note: "Loaded as SCPU64Name when SuperCPU Kernal option set to 2.04. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."

  - name: "scpu-dos-1.4.bin"
    description: "CMD SuperCPU Kernal v1.4"
@@ -38,22 +38,22 @@ files:
    max_size: 524288
    validation: [size]
    source_ref: "retrodep/ui.c:265-266, vice/src/scpu64/scpu64rom.c:75-89"
-    notes: "Loaded as SCPU64Name when SuperCPU Kernal option set to 1.40. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."
+    note: "Loaded as SCPU64Name when SuperCPU Kernal option set to 1.40. Size must be power of 2 between 64 KB and 512 KB. Stored in system/vice/SCPU64/."

  - name: "JiffyDOS_1541-II.bin"
    description: "JiffyDOS 1541-II drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:282-283"
-    notes: "Loaded as DosName1541ii when JiffyDOS option enabled."
+    note: "Loaded as DosName1541ii when JiffyDOS option enabled."

  - name: "JiffyDOS_1571_repl310654.bin"
    description: "JiffyDOS 1571 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:285-286"
-    notes: "Loaded as DosName1571 when JiffyDOS option enabled."
+    note: "Loaded as DosName1571 when JiffyDOS option enabled."

  - name: "JiffyDOS_1581.bin"
    description: "JiffyDOS 1581 drive DOS replacement"
    required: false
    source_ref: "retrodep/ui.c:287-288"
-    notes: "Loaded as DosName1581 when JiffyDOS option enabled."
+    note: "Loaded as DosName1581 when JiffyDOS option enabled."
--- a/emulators/vice_xvic.yml
+++ b/emulators/vice_xvic.yml
@@ -25,7 +25,7 @@ files:
    size: 8192
    validation: [size]
    source_ref: "vice/src/vic20/vic20rom.h:49, vice/src/vic20/vic20model.c:60, vice/src/vic20/vic20rom.c:112-120"
-    notes: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
+    note: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."

  - name: "chargen-901460-02.bin"
    description: "VIC-1001 Character ROM (Japanese)"
@@ -33,4 +33,4 @@ files:
    size: 4096
    validation: [size]
    source_ref: "vice/src/vic20/vic20rom.h:53, vice/src/vic20/vic20model.c:60, vice/src/vic20/vic20rom.c:173-179"
-    notes: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
+    note: "Not embedded. Loaded via sysfile from system/vice/VIC20/ when VIC-1001 Japanese model selected via vicerc."
--- a/emulators/vircon32.yml
+++ b/emulators/vircon32.yml
@@ -47,7 +47,7 @@ files:
    md5: "73f04397cbb2dafcf2047b19a856153a"
    sha1: "67ddbcd018f03ed74b6e013074d92cc5f1f51c80"
    source_ref: "libretro.cpp:422-425"
-    notes: |
+    note: |
      Optional external BIOS placed in the system directory root.
      If present, overrides the embedded Standard BIOS v1.2.
      The hashes above correspond to the Standard BIOS v1.2 bundled
@@ -61,7 +61,7 @@ platform_details:
    file_size: 1073060
    md5: "73f04397cbb2dafcf2047b19a856153a"
    sha1: "67ddbcd018f03ed74b6e013074d92cc5f1f51c80"
-    notes: |
+    note: |
      The standard BIOS is compiled into the core binary as
      embedded_StandardBios[] via a generated header file. It provides
      the boot animation (Vircon32 logo + startup sound). LoadEmbeddedBios()
@@ -70,7 +70,7 @@ platform_details:

  bios_format:
    source_ref: "VirconDefinitions/FileFormats.hpp, V32Console.cpp:259-431"
-    notes: |
+    note: |
      A V32 BIOS ROM file must have:
      - BiosSignature in the header (distinct from CartridgeSignature)
      - Exactly 1 texture (boot screen graphics)
@@ -81,6 +81,6 @@ platform_details:
  cartridge_format:
    extensions: "v32"
    source_ref: "V32Console.cpp:468-696"
-    notes: |
+    note: |
      Cartridges use CartridgeSignature with up to 256 textures and
      1024 sounds. Program ROM can be up to 128M words (512 MB).
--- a/emulators/virtualjaguar.yml
+++ b/emulators/virtualjaguar.yml
@@ -111,7 +111,7 @@ analysis:
    source_ref: "libretro.c:902-904"
    selection_logic: "biosType == BT_K_SERIES ? jaguarBootROM : jaguarBootROM2"
    external_loading: false
-    notes: |
+    note: |
      jagBootPath and CDBootPath struct fields are never set in the libretro
      port. The standalone Virtual Jaguar GUI uses them but that code path
      is not compiled into the libretro core.
--- a/emulators/x64sdl.yml
+++ b/emulators/x64sdl.yml
@@ -46,7 +46,7 @@ files:
    size: 8192
    path: "data/C64/sxkernal"
    source_ref: "src/c64/c64model.c:142,147"
-    notes: "Loaded when SX64 PAL or SX64 NTSC model selected."
+    note: "Loaded when SX64 PAL or SX64 NTSC model selected."

  - name: "jpkernal"
    description: "Japanese C64 Kernal ROM"
@@ -54,7 +54,7 @@ files:
    size: 8192
    path: "data/C64/jpkernal"
    source_ref: "src/c64/c64model.c:152"
-    notes: "Loaded when C64 JAP NTSC model selected."
+    note: "Loaded when C64 JAP NTSC model selected."

  - name: "jpchrgen"
    description: "Japanese C64 character generator ROM"
@@ -62,7 +62,7 @@ files:
    size: 4096
    path: "data/C64/jpchrgen"
    source_ref: "src/c64/c64model.c:152"
-    notes: "Loaded when C64 JAP NTSC model selected."
+    note: "Loaded when C64 JAP NTSC model selected."

  - name: "gskernal"
    description: "C64 Games System Kernal ROM"
@@ -70,7 +70,7 @@ files:
    size: 8192
    path: "data/C64/gskernal"
    source_ref: "src/c64/c64model.c:157"
-    notes: "Loaded when C64 GS PAL model selected."
+    note: "Loaded when C64 GS PAL model selected."

  - name: "edkernal"
    description: "PET64/Educator64 Kernal ROM"
@@ -78,7 +78,7 @@ files:
    size: 8192
    path: "data/C64/edkernal"
    source_ref: "src/c64/c64model.c:162,167"
-    notes: "Loaded when PET64 PAL or PET64 NTSC model selected."
+    note: "Loaded when PET64 PAL or PET64 NTSC model selected."

  # IEC drive ROMs (optional, path: data/DRIVES/)
  - name: "dos1540"
@@ -86,14 +86,14 @@ files:
    required: false
    path: "data/DRIVES/dos1540"
    source_ref: "src/drive/iec/iecrom.c:99, src/drive/iec/iec-resources.c:182"
-    notes: "Hardware-level 1540 drive emulation. Absence disables this drive type."
+    note: "Hardware-level 1540 drive emulation. Absence disables this drive type."

  - name: "dos1541"
    description: "1541 floppy drive ROM"
    required: false
    path: "data/DRIVES/dos1541"
    source_ref: "src/drive/iec/iecrom.c:106, src/drive/iec/iec-resources.c:185"
-    notes: "Hardware-level 1541 drive emulation. Most common C64 drive."
+    note: "Hardware-level 1541 drive emulation. Most common C64 drive."

  - name: "d1541II"
    description: "1541-II floppy drive ROM"
@@ -124,14 +124,14 @@ files:
    required: false
    path: "data/DRIVES/dos2000"
    source_ref: "src/drive/iec/iecrom.c:139, src/drive/iec/iec-resources.c:195"
-    notes: "Not shipped with VICE 3.1 data files."
+    note: "Not shipped with VICE 3.1 data files."

  - name: "dos4000"
    description: "CMD FD-4000 drive ROM"
    required: false
    path: "data/DRIVES/dos4000"
    source_ref: "src/drive/iec/iecrom.c:145, src/drive/iec/iec-resources.c:197"
-    notes: "Not shipped with VICE 3.1 data files."
+    note: "Not shipped with VICE 3.1 data files."

  # IEEE drive ROMs (optional, path: data/DRIVES/)
  - name: "dos2031"
@@ -139,7 +139,7 @@ files:
    required: false
    path: "data/DRIVES/dos2031"
    source_ref: "src/drive/ieee/ieee.c:115, src/drive/ieee/ieee-resources.c:93"
-    notes: "IEEE488 interface drive. Requires parallel IEEE488 extension."
+    note: "IEEE488 interface drive. Requires parallel IEEE488 extension."

  - name: "dos2040"
    description: "2040 IEEE drive ROM"
@@ -171,11 +171,11 @@ files:
    required: false
    path: "data/PRINTER/mps803"
    source_ref: "src/printerdrv/drv-mps803.c:420"
-    notes: "Loaded on demand when MPS-803 printer opened."
+    note: "Loaded on demand when MPS-803 printer opened."

  - name: "nl10-cbm"
    description: "NL10 printer ROM"
    required: false
    path: "data/PRINTER/nl10-cbm"
    source_ref: "src/printerdrv/drv-nl10.c:2210"
-    notes: "Loaded on demand when NL10 printer opened."
+    note: "Loaded on demand when NL10 printer opened."
--- a/emulators/xemu.yml
+++ b/emulators/xemu.yml
@@ -21,7 +21,7 @@ files:
    size: 512
    source_ref: "hw/xbox/xbox.c:151 (bootrom_size != 512 -> error)"
    config_key: "sys.files.bootrom_path"
-    notes: |
+    note: |
      Overlaid on the last 512 bytes of the flash ROM region at boot.
      Mapped to 0xFFFFFE00-0xFFFFFFFF. Disabled after early init
      via LPC config register write (hw/xbox/xbox_pci.c:362).
@@ -34,7 +34,7 @@ files:
    size_note: "Must be a multiple of 64 KB. Default 256 KB."
    source_ref: "hw/xbox/xbox.c:70-81 (bios_name, bios_size validation)"
    config_key: "sys.files.flashrom_path"
-    notes: |
+    note: |
      Loaded as -bios argument (system/vl.c:3052-3053).
      Mapped to 0xFF000000-0xFFFFFFFF with mirroring.
      Common variants: Complex_4627 (1.0), Complex_4034 (debug),
@@ -47,7 +47,7 @@ files:
    size: 256
    source_ref: "system/vl.c:2939 (size != 256 -> error)"
    config_key: "sys.files.eeprom_path"
-    notes: |
+    note: |
      Loaded via smbus-storage device (hw/xbox/smbus_storage.c:157).
      Auto-generated as XBOX_EEPROM_VERSION_R1 if missing
      (system/vl.c:2918-2919). Default path: <config_dir>/eeprom.bin.
@@ -59,7 +59,7 @@ files:
    required: true
    source_ref: "system/vl.c:3060-3073 (hdd_path loading)"
    config_key: "sys.files.hdd_path"
-    notes: |
+    note: |
      Attached as IDE drive index=0 with locked=on.
      Must contain Xbox partitions (C, E, X, Y, Z).
      Pre-built images available from xemu project.
--- a/emulators/xrick.yml
+++ b/emulators/xrick.yml
@@ -59,7 +59,7 @@ files:
    md5: "a471e64e9f69afbe59c10cc94ed1b184"
    sha1: "ecfc092fe6371dbf38e238a8ba5f90785b5db52d"
    source_ref: "libretro-core.c:324-326 (path construction), libretro-core.c:328-357 (missing file error), libretro-core.c:359 (final path confirmation)"
-    notes: "Placed in system/xrick/data.zip. Contains sounds/ directory with 29 WAV files from the original xrick 0.21212 release. Without this file, standalone mode fails with 'XRick game files missing from frontend system directory'. Ships in the libretro repo root."
+    note: "Placed in system/xrick/data.zip. Contains sounds/ directory with 29 WAV files from the original xrick 0.21212 release. Without this file, standalone mode fails with 'XRick game files missing from frontend system directory'. Ships in the libretro repo root."

 analysis:
  content_type: game_engine
--- a/emulators/xroar.yml
+++ b/emulators/xroar.yml
@@ -41,7 +41,7 @@ files:
    validation: [crc32]
    aliases: [dragon32, d32rom, "Dragon Data Ltd - Dragon 32 - IC17"]
    source_ref: "xroar.c:643 (romlist d32), dragon.c:792,798-803,820-821 (load + CRC)"
-    notes: "Combined 16K ROM. Loaded into a single 16384-byte rombank slot."
+    note: "Combined 16K ROM. Loaded into a single 16384-byte rombank slot."

  # ---- Dragon 64 ----

@@ -54,7 +54,7 @@ files:
    validation: [crc32]
    aliases: [d64rom1, dragrom, "Dragon Data Ltd - Dragon 64 - IC17", "Dragon Data Ltd - TANO IC18", "Eurohard S.A. - Dragon 200 IC18"]
    source_ref: "xroar.c:641 (romlist d64_1), xroar.c:647 (romlist dragon64), dragon64.c:138-141,155-157 (load + CRC)"
-    notes: "IC17 ROM. Required for the machine to start."
+    note: "IC17 ROM. Required for the machine to start."

  - name: "d64_2.rom"
    system: dragon64
@@ -65,7 +65,7 @@ files:
    validation: [crc32]
    aliases: [d64rom2, "Dragon Data Ltd - Dragon 64 - IC18", "Dragon Data Ltd - TANO IC17", "Eurohard S.A. - Dragon 200 IC17"]
    source_ref: "xroar.c:642 (romlist d64_2), xroar.c:648 (romlist dragon64_alt), dragon64.c:146-152,160-162 (load + CRC)"
-    notes: "IC18 ROM. 64K mode alternate BASIC. Machine starts without it (32K mode only)."
+    note: "IC18 ROM. 64K mode alternate BASIC. Machine starts without it (32K mode only)."

  # ---- Dragon 200-E ----

@@ -78,7 +78,7 @@ files:
    validation: [crc32]
    aliases: [d200e_rom1, ic18_v1.4e.ic34]
    source_ref: "xroar.c:644 (romlist d200e_1), xroar.c:650 (romlist dragon200e), xroar.c:735 (crclist)"
-    notes: "Required for Dragon 200-E. Falls back to d64_1 then generic dragon if not found."
+    note: "Required for Dragon 200-E. Falls back to d64_1 then generic dragon if not found."

  - name: "d200e_2.rom"
    system: dragon64
@@ -87,7 +87,7 @@ files:
    size: 16384
    aliases: [d200e_rom2, ic17_v1.4e.ic37]
    source_ref: "xroar.c:645 (romlist d200e_2), xroar.c:651 (romlist dragon200e_alt)"
-    notes: "64K mode alternate. Falls back to d64_2 if not found."
+    note: "64K mode alternate. Falls back to d64_2 if not found."

  - name: "d200e_26.rom"
    system: dragon64
@@ -96,7 +96,7 @@ files:
    size: 4096
    aliases: [rom26.ic1]
    source_ref: "xroar.c:652 (romlist dragon200e_charset), dragon.c:523-539 (ext_charset load)"
-    notes: "Spanish character set. Loaded into a 4096-byte rombank. Machine works without it (uses standard charset)."
+    note: "Spanish character set. Loaded into a 4096-byte rombank. Machine works without it (uses standard charset)."

  # ---- Dragon Professional (Alpha) ----

@@ -108,7 +108,7 @@ files:
    validation: [crc32]
    aliases: [alpha_bt_10, "Dragon Data Ltd - Dragon Alpha Boot v1.0 150584"]
    source_ref: "xroar.c:654 (romlist dragonpro_boot), xroar.c:741 (crclist), dragonpro.c:231-234 (load)"
-    notes: "Required for Dragon Professional machine. Loaded as extbas_rom (boot ROM)."
+    note: "Required for Dragon Professional machine. Loaded as extbas_rom (boot ROM)."

  - name: "alpha-basic.rom"
    system: dragon64
@@ -116,7 +116,7 @@ files:
    required: true
    aliases: [alpha_ba, "Dragon Data Ltd - Dragon Alpga Basic"]
    source_ref: "xroar.c:655 (romlist dragonpro_basic), dragonpro.c:240-243 (load)"
-    notes: "Loaded as altbas_rom. Falls back to d64_1 if not found."
+    note: "Loaded as altbas_rom. Falls back to d64_1 if not found."

  # ---- Tandy CoCo (Colour BASIC) ----

@@ -128,7 +128,7 @@ files:
    crc32: "d8f4d15e"
    validation: [crc32]
    source_ref: "xroar.c:657 (romlist coco), xroar.c:747 (crclist bas13), dragon.c:807-812,824-826 (load + CRC)"
-    notes: "Default Colour BASIC. First tried in the @coco romlist. 8K ROM loaded into slot 1 of a 2-slot rombank."
+    note: "Default Colour BASIC. First tried in the @coco romlist. 8K ROM loaded into slot 1 of a 2-slot rombank."

  - name: "bas12.rom"
    system: coco
@@ -139,7 +139,7 @@ files:
    validation: [crc32]
    aliases: ["Color Basic v1.2 (1982)(Tandy)"]
    source_ref: "xroar.c:657 (romlist coco), xroar.c:746 (crclist bas12)"
-    notes: "Alternative to bas13. Second in fallback order."
+    note: "Alternative to bas13. Second in fallback order."

  - name: "bas11.rom"
    system: coco
@@ -149,7 +149,7 @@ files:
    crc32: "6270955a"
    validation: [crc32]
    source_ref: "xroar.c:657 (romlist coco), xroar.c:745 (crclist bas11)"
-    notes: "Used by CoCo 1E. Third in fallback order."
+    note: "Used by CoCo 1E. Third in fallback order."

  - name: "bas10.rom"
    system: coco
@@ -159,7 +159,7 @@ files:
    crc32: "00b50aaa"
    validation: [crc32]
    source_ref: "xroar.c:657 (romlist coco), xroar.c:744 (crclist bas10)"
-    notes: "Earliest version. Used by original CoCo 1. Last in fallback order."
+    note: "Earliest version. Used by original CoCo 1. Last in fallback order."

  # ---- Tandy CoCo (Extended Colour BASIC) ----

@@ -171,7 +171,7 @@ files:
    crc32: "a82a6254"
    validation: [crc32]
    source_ref: "xroar.c:658 (romlist coco_ext), xroar.c:752 (crclist extbas11), dragon.c:798-803,828-829 (load + CRC)"
-    notes: "Default Extended BASIC. 8K ROM loaded into slot 0 of a 2-slot rombank."
+    note: "Default Extended BASIC. 8K ROM loaded into slot 0 of a 2-slot rombank."

  - name: "extbas10.rom"
    system: coco
@@ -181,7 +181,7 @@ files:
    crc32: "e031d076"
    validation: [crc32]
    source_ref: "xroar.c:658 (romlist coco_ext), xroar.c:751 (crclist extbas10)"
-    notes: "Earlier version. Second in fallback order."
+    note: "Earlier version. Second in fallback order."

  # ---- Tandy CoCo 3 ----

@@ -193,7 +193,7 @@ files:
    crc32: "b4c88d6c"
    validation: [crc32]
    source_ref: "xroar.c:688 (romlist coco3), xroar.c:762 (crclist coco3), coco3.c:254-256,512-526 (load + CRC)"
-    notes: "32K combined ROM. Single required ROM for CoCo 3 NTSC."
+    note: "32K combined ROM. Single required ROM for CoCo 3 NTSC."

  - name: "coco3p.rom"
    system: coco3
@@ -201,7 +201,7 @@ files:
    required: true
    size: 32768
    source_ref: "xroar.c:689 (romlist coco3p), xroar.c:505,514 (machine config), coco3.c:254-256"
-    notes: "PAL variant of the CoCo 3 ROM. Required for PAL CoCo 3 machines."
+    note: "PAL variant of the CoCo 3 ROM. Required for PAL CoCo 3 machines."

  # ---- Tandy MC-10 ----

@@ -213,7 +213,7 @@ files:
    crc32: "11fda97e"
    validation: [crc32]
    source_ref: "xroar.c:695 (romlist mc10), xroar.c:767 (crclist mc10), mc10.c:157-158,397-407 (load + CRC)"
-    notes: "Single required ROM for MC-10."
+    note: "Single required ROM for MC-10."

  - name: "alice.rom"
    system: mc10
@@ -223,7 +223,7 @@ files:
    crc32: "f876abe9"
    validation: [crc32]
    source_ref: "xroar.c:697 (romlist alice), xroar.c:769 (crclist alice), mc10.c:157-158"
-    notes: "French Alice variant. Required for Alice machine. MC-10 compatible."
+    note: "French Alice variant. Required for Alice machine. MC-10 compatible."

  # ---- Deluxe CoCo (prototype) ----

@@ -235,7 +235,7 @@ files:
    validation: [crc32]
    aliases: [adv070_u24]
    source_ref: "xroar.c:673 (romlist deluxecoco), xroar.c:757 (crclist), deluxecoco.c:191-194 (load)"
-    notes: "Primary ROM for the Deluxe CoCo prototype. Loaded as extbas_rom."
+    note: "Primary ROM for the Deluxe CoCo prototype. Loaded as extbas_rom."

  - name: "adv071_u24.rom"
    system: coco
@@ -266,7 +266,7 @@ files:
    validation: [crc32]
    aliases: [mx1600bas_zephyr]
    source_ref: "xroar.c:679 (romlist mx1600), xroar.c:748 (crclist mx1600)"
-    notes: "Required for MX-1600. Zephyr-patched variant (CRC32 d11b1c96) is an alias."
+    note: "Required for MX-1600. Zephyr-patched variant (CRC32 d11b1c96) is an alias."

  - name: "mx1600extbas.rom"
    system: coco
@@ -301,28 +301,28 @@ files:
    description: "Tandy RS-DOS 1.1 (CoCo floppy disk controller)"
    required: false
    source_ref: "xroar.c:708 (romlist rsdos), rsdos.c:176 (default @rsdos)"
-    notes: "Primary CoCo disk controller ROM. disk10.rom (RS-DOS 1.0) is an earlier version used as fallback."
+    note: "Primary CoCo disk controller ROM. disk10.rom (RS-DOS 1.0) is an earlier version used as fallback."

  - name: "hdbdw3bck.rom"
    system: coco
    description: "RS-DOS with Becker port (DriveWire)"
    required: false
    source_ref: "xroar.c:718 (romlist rsdos_becker), xroar.c:572-574 (cart becker)"
-    notes: "For CoCo with Becker port hardware. Enables DriveWire connectivity."
+    note: "For CoCo with Becker port hardware. Enables DriveWire connectivity."

  - name: "ddos12a.rom"
    system: dragon64
    description: "DragonDOS 1.2a (Dragon floppy disk controller)"
    required: false
    source_ref: "xroar.c:702 (romlist dragondos), dragondos.c:173 (default @dragondos_compat)"
-    notes: "Latest DragonDOS version. Fallback chain tries DOSPlus -> SuperDOS -> DragonDOS -> Cumana. Older versions: ddos12, ddos40, ddos15, ddos10."
+    note: "Latest DragonDOS version. Fallback chain tries DOSPlus -> SuperDOS -> DragonDOS -> Cumana. Older versions: ddos12, ddos40, ddos15, ddos10."

  - name: "dplus49b.rom"
    system: dragon64
    description: "DOSPlus 4.9b (Dragon compatible DOS)"
    required: false
    source_ref: "xroar.c:703 (romlist dosplus)"
-    notes: "First tried in DragonDOS-compatible cartridge. Enhanced Dragon DOS. Older version: dplus48 (alias: dosplus-4.8, DOSPLUS)."
+    note: "First tried in DragonDOS-compatible cartridge. Enhanced Dragon DOS. Older version: dplus48 (alias: dosplus-4.8, DOSPLUS)."

  - name: "sdose6.rom"
    system: dragon64
@@ -330,7 +330,7 @@ files:
    required: false
    aliases: ["PNP - SuperDOS E6"]
    source_ref: "xroar.c:704 (romlist superdos)"
-    notes: "Latest SuperDOS. Older versions: sdose5, sdose4."
+    note: "Latest SuperDOS. Older versions: sdose5, sdose4."

  - name: "cdos20.rom"
    system: dragon64
@@ -345,14 +345,14 @@ files:
    required: false
    aliases: ["Premier Micros - DeltaDOS"]
    source_ref: "xroar.c:711 (romlist delta), deltados.c:160 (default @delta)"
-    notes: "Latest Delta version. Older versions: delta1a, delta19, delta, deltados."
+    note: "Latest Delta version. Older versions: delta1a, delta19, delta, deltados."

  - name: "cp450dsk.rom"
    system: coco
    description: "Prologica CP-450 DOS cartridge"
    required: false
    source_ref: "xroar.c:709 (romlist cp450)"
-    notes: "Falls back to RS-DOS if not found."
+    note: "Falls back to RS-DOS if not found."

  # ---- Other cartridge ROMs (all optional) ----

@@ -361,7 +361,7 @@ files:
    description: "Orchestra-90 CC sound cartridge ROM"
    required: false
    source_ref: "orch90.c:122 (default rom = orch90)"
-    notes: "Sound synthesis cartridge. Loaded directly (no romlist fallback)."
+    note: "Sound synthesis cartridge. Loaded directly (no romlist fallback)."

  - name: "mcx128.rom"
    system: mc10
@@ -369,7 +369,7 @@ files:
    required: false
    aliases: [MCX_Basic_21]
    source_ref: "xroar.c:724 (romlist mcx128), mcx128.c:208 (default @mcx128)"
-    notes: "128K memory expansion for MC-10. Adds enhanced BASIC."
+    note: "128K memory expansion for MC-10. Adds enhanced BASIC."

  - name: "mcx128a.rom"
    system: mc10
@@ -377,25 +377,25 @@ files:
    required: false
    aliases: [MCX_Basic_21_AZERTY]
    source_ref: "xroar.c:725 (romlist mcx128_azerty), xroar.c:632-633 (cart mcx128a)"
-    notes: "AZERTY keyboard variant for Alice. Same MCX128 hardware."
+    note: "AZERTY keyboard variant for Alice. Same MCX128 hardware."

  - name: "yados.rom"
    system: coco
    description: "YADOS (Glenside IDE interface ROM)"
    required: false
    source_ref: "xroar.c:690 (romlist glenside_ide), idecart.c:204 (default @glenside_ide)"
-    notes: "IDE hard disk interface. Fallback: hdblba.rom (alternative IDE ROM)."
+    note: "IDE hard disk interface. Fallback: hdblba.rom (alternative IDE ROM)."

  - name: "sdbdos.rom"
    system: dragon64
    description: "SDBDOS (MOOH memory cartridge ROM)"
    required: false
    source_ref: "mooh.c:254 (default rom = sdbdos)"
-    notes: "SD card boot DOS for MOOH cartridge. Loaded directly."
+    note: "SD card boot DOS for MOOH cartridge. Loaded directly."

  - name: "dragonfly-2.3.rom"
    system: dragon64
    description: "Ikon Ultra Drive Dragonfly ROM 2.3"
    required: false
    source_ref: "xroar.c:715 (romlist ikon), ikon.c:151 (default @ikon)"
-    notes: "Experimental. Ikon Ultra Drive storage interface. Older version: dragonfly-1.3."
+    note: "Experimental. Ikon Ultra Drive storage interface. Older version: dragonfly-1.3."