Sylpheed/authored/audio.json

{
 "format": "sylpheed.audio/1",
 "_": [
  "Menu audio. EVERY VALUE IN THIS FILE IS MEASURED OR CHOSEN -- none of it is",
  "in a data file the exporter can read, which is why it is here and not in the",
  "exporter. `measured` and `chosen` are NOT the same thing and this file keeps",
  "them apart: a measurement is deleted when the disc states it, a choice is",
  "deleted when somebody measures it.",
  "",
  "Two different kinds of not-on-the-disc live in this file and they are not",
  "interchangeable:",
  "",
  "  * `se` -- MEASURED. `Static.slb` is a delimiter-less run of whole 2048-byte",
  "    XMA1 packets: no RIFF, no seek chunk, no XACT container. A wave is defined",
  "    ONLY by (offset, packet_count), and both numbers come from the running",
  "    game, not from the file. HANDOFF Q8. Delete a row the day a table on the",
  "    disc states the same thing.",
  "",
  "  * `bgm` -- MEASURED, and only the LOOP POLICY beside it is chosen. HANDOFF",
  "    Q10's negative is about the TABLES: `SOUNDS`, `FILES` and the bank headers",
  "    name no screen. The executable does -- cue 1103 = `BGM_103`, corroborated",
  "    by a byte-for-byte match against what the XMA probe saw at the main menu.",
  "    An earlier draft read the negative as unbounded, picked a track at random",
  "    and called it authored. See the `bgm._` block for what that cost.",
  "",
  "The exporter reads this file and emits `export/audio/**` from it. It holds no",
  "cue table of its own: a measured offset compiled into a Rust `const` is a",
  "measurement wearing the costume of a decoded field, and MISSION section 3 is",
  "explicit that measured values live here."
 ],
 "se": {
  "_": [
   "MEASURED, HANDOFF Q8, and the RE agent retracted an earlier 'cannot be",
   "extracted' to publish these. The waves were located BY PLAYING THEM: Canary",
   "with `--xma_param_probe=true` prints a stream's packet count and first 32",
   "bytes when it is played, and searching those bytes in the bank gives the",
   "offset.",
   "",
   "WARNING, from the same finding: the file order is NOT cue-id order. These",
   "cannot be counted out, and an index here would be a fabrication.",
   "",
   "`name_match` is the authors' own identifier GUESSED BY NAME. It is carried",
   "so the guess is not lost and is never presented as the measurement. Where",
   "the RE agent did not separate two candidates, there is no name at all --",
   "an absent `name_match` means nobody has claimed one, never that the",
   "BINDING is unknown. The binding is the measured part.",
   "",
   "All three are mono 48 kHz; that is the RE agent's statement in",
   "`sylpheed_formats::media::se_wave_riff`, not something re-derived here."
  ],
  "move": {
   "bank": "Static.slb",
   "offset": "0x1ec0",
   "packets": 4,
   "channels": 1,
   "rate": 48000,
   "name_match": "SE_UI_CURSOR",
   "why": "HANDOFF Q8, measured: the d-pad move cue, 8 192 B / 0.533 s, reproduced across two boots. Left/right play nothing at all, which is a measurement too and is why there is no `left`/`right` row here rather than a silent file."
  },
  "confirm": {
   "bank": "Static.slb",
   "offset": "0x5d6c0",
   "packets": 6,
   "channels": 1,
   "rate": 48000,
   "why": "HANDOFF Q8, measured: the (A) confirm cue, 12 288 B / 1.016 s. NO `name_match`: Q8 is explicit that (A)'s wave was not separated between `SE_UI_DECIDE` and `SE_UI_SUB_WIN_OPN`, so naming it would invent the one thing the measurement did not settle."
  },
  "back": {
   "bank": "Static.slb",
   "offset": "0x0ec0",
   "packets": 2,
   "channels": 1,
   "rate": 48000,
   "why": "HANDOFF Q8, measured: the (B) back cue, 4 096 B / 0.344 s, reproduced across two boots. No `name_match` for the same reason as `confirm` -- Q8 names no identifier for it."
  }
 },
 "bgm": {
  "_": [
   "MEASURED, NOT CHOSEN -- and the port got this wrong for one iteration.",
   "",
   "`docs/port/BLOCKED.md` carried a row reading 'not on the disc ... the port",
   "is choosing a track, and that choice is authored', and the first draft of",
   "this file duly picked BGM_001 and labelled it arbitrary. That row was not",
   "stale: `BGM_103` is in HANDOFF at `9ca1eb5`, which is the exact commit the",
   "row says it was reconciled against. It was WRONG WHEN WRITTEN.",
   "",
   "What HANDOFF actually says is a negative with a stated reach, and the reach",
   "is what the port dropped: the *tables* cannot say which BGM a screen plays",
   "-- `SOUNDS`, `FILES` and the bank headers name no screen. The EXECUTABLE",
   "can. `GamePart_Title`'s phase handler `sub_821C5580` carries `li r5, 1103`",
   "into a sound call, cue 1103 is `BGM_103`, and `BGM_103.slb`'s two declared",
   "waves (3 876 864 / 3 930 112 B) are byte-for-byte the two streams the XMA",
   "probe saw decoding at the main menu. Static code, disc census and runtime",
   "agree. HANDOFF's own words: 'The port does not have to choose a track.'",
   "",
   "So this section is a CITATION, not a decision. It lives in `authored/`",
   "only because the binding is in the .xex and the exporter reads data files,",
   "not code -- and it must be deleted the day something the exporter can read",
   "states it. The loop policy below IS still a decision."
  ],
  "main_menu": {
   "bank": "BGM_103.slb",
   "loop": "restart",
   "kind": "measured",
   "why": "MEASURED, HANDOFF Q10 -- NOT a port choice. `GamePart_Title`'s phase handler `sub_821C5580` plays cue 1103 = `BGM_103`, and `BGM_103.slb`'s two declared waves (3 876 864 / 3 930 112 B) are byte-for-byte the two streams the XMA probe saw decoding at the main menu. Static code, disc census and runtime all agree; see docs/re/menu-audio-cues.md and docs/re/structures/bgm-two-stems.md. The name carries its `.slb` extension because that is what `sound.pak` hashes -- `BGM_103` alone resolves to nothing, which is how the first draft of this file failed.",
   "loop_why": "AUTHORED, and it will be AUDIBLY WRONG AT THE SEAM. HANDOFF Q10: no loop-point field has been identified anywhere, so the file carries no marked restart. `restart` replays from sample 0, which means the listener hears the track's own fade-out and the silence after it before the music comes back. Trimming to the fade would sound better and would be worse: it would INVENT a loop point, and an invented one is indistinguishable from a decoded one a month later. The seam stays ugly until a loop point is measured or a capture of the real menu looping settles it. ⚠️ MEASURED 2026-08-29, and it is worse than 'ugly': the bed loops at 87.8 s against the track's own 87.7 s, and the gap before the music returns is about 3.4 SECONDS of near-silence (36 consecutive 50 ms windows below peak 300, spanning 84.40-87.80 s, after a fade from RMS 2057 to 431). Recorded off the port's own Master bus, so it is what a player hears, not a property of the file. That is long enough to read as the music having stopped rather than looped. The number is here to make the cost of the missing loop point concrete; it does NOT license trimming to the fade, which would still invent a loop point. See docs/port/DECISIONS.md.",
   "stems": "sum",
   "stems_why": "MEASURED, HANDOFF Q10: a bank is exactly TWO waves of identical duration (32/32 banks on the disc), sample-synchronous -- transient correlation peaks at lag 0.00 s over +/-5 s and both stop at the same millisecond. Concatenating them plays the piece twice, the second time as a bass-less stem; that was the previous reading and it is refuted. Emitting two files would be wrong for a second reason: MODDING rule 1 is one logical asset, one file, and handing a modder two stems to line up by hand is the reassembly the exporter exists to have already done. WHAT IS SUMMED IS SETTLED; WHAT WAVE 1 IS, IS NOT -- HANDOFF calls it quieter, far more L/R-decorrelated and almost bass-free, so it reads as a surround-rear pair OR a second intensity layer, and `ChannelMask` is 0x0002 on both so the file will not say. A unity sum is right under either reading; a weighting would only be justified once that is settled."
  }
 },
 "voice": {
  "_": [
   "🔴 KNOWN WRONG, HELD DELIBERATELY. Which of a voice region's streams to",
   "export. The premise this entry was built on has been REFUTED BY THE RUNNING",
   "GAME and the entry is kept, escalated, rather than swapped for another guess.",
   "",
   "The premise was: a region carries THREE PRESENTATIONS OF ONE TAKE, so the",
   "exporter picks one. The Decoder booted with `--xma_param_probe=true` -- the",
   "cvar that reports which sub-wave the game decodes -- and the game decodes",
   "ALL THREE, CONCURRENTLY, in three separate XMA contexts, with byte sizes",
   "matching the three disc payloads exactly (1294336 / 1118208 / 1171456",
   "against RIFF size - 60 of 1294396 / 1118268 / 1171516).",
   "",
   "SO THERE IS NO 'WHICH ONE' TO ANSWER. `presentation` below discards two of",
   "three streams the game plays. It is not a preference between rules any more;",
   "it is a known-incomplete export.",
   "",
   "WHY IT IS NOT CHANGED TODAY. Reverting to the 1/n sum is not obviously less",
   "wrong: an equal-gain sum of channel pairs is not a downmix -- MISSION",
   "section 6 makes exactly that point when it pins an explicit matrix for the",
   "movies' 5.1 fold rather than letting ffmpeg default -- and the 6.02 dB the",
   "sum cost S00A was a real defect. Swapping one guess for another on a message",
   "is what produced this entry twice already.",
   "",
   "🟡 HYPOTHESIS, NOT A RESULT, and it is the Decoder's: three concurrent stereo",
   "streams is six channels, and N stereo streams is how XMA carries",
   "multichannel on the 360, so 5.1 would explain the differing byte rates, the",
   "near-silent stream and why cues are 1-stream or 3-stream and never 2. AGAINST",
   "IT: all three declare ChannelMask = 0x0002 identically, which is odd for",
   "distinct channel roles. Do not build on it.",
   "",
   "WHAT SETTLES IT: a recording of the game's own output over the intro,",
   "through the PulseAudio null sink (AUDIO-VERIFICATION section 3). Candidate",
   "combinations of the three decoded streams can then be correlated against",
   "what the game actually played. Asked 2026-08-29."
  ],
  "presentation": "loudest",
  "presentation_why": [
   "`loudest` = the full-length stream whose peak is nearest full scale.",
   "",
   "🔴 READ THE BLOCK ABOVE FIRST. This selects one of three streams the game",
   "decodes concurrently, so whatever it selects, two are missing. The",
   "paragraphs below are the history of how the value was arrived at, kept",
   "because the reasoning is what makes the error checkable -- NOT because the",
   "choice is defensible on its own terms any more.",
   "",
   "It was `highest_rate`, on a recommendation withdrawn as self-contradictory:",
   "'the highest-rate, highest-gain one is chunk 1' selects different streams --",
   "ADV stream 2 is 1118268 B at 0.0 dBFS, stream 3 is 1171516 B at -8.3.",
   "",
   "A structural argument for `loudest` was offered and withdrawn too: ADV",
   "stream 2 is mono-in-stereo and stream 3 is dual-mono, so the extra bytes",
   "looked like a duplicated channel rather than fidelity. The CHANNEL",
   "MEASUREMENT stands and now reads differently -- these are channel pairs, and",
   "0.60x with the residual 26.8 dB down is what a correlated pair at a lower",
   "level looks like. The GENERALISATION was refuted by census: the stream-3 /",
   "stream-2 size ratio over the 28 three-stream cues runs 0.0778 to 2.9163.",
   "",
   "⚠️ THE FAILURE MODE HERE IS THAT IT SOUNDS FINE. A single stream decodes to",
   "clean audible dialogue, so nothing in the output reveals that two streams",
   "are missing. That is why the manifest says it in words on every voice entry",
   "rather than leaving it to this file."
  ]
 }
}