3 Commits

Author	SHA1	Message	Date
Sylpheed port agent	2ad839460c	port: P6 -- the menu has sound, and the BGM I "chose" was decoded all along ... The three Static.slb cues and the menu bed now export to Ogg Vorbis and play. `sylpheed_formats::media` does the assembly; nothing in port/ has heard of XMA. Three things this milestone got wrong before it got right, all recorded in docs/port/DECISIONS.md because the corrections are the useful part: 1. The cue offsets were a Rust `const` in the exporter. They are MEASURED, not decoded -- a measured value compiled into the exporter is a measurement wearing the costume of a decoded field, and nobody deletes it because nobody can see it. They are authored/audio.json now. 2. I picked BGM_001 and wrote a careful `why` calling the choice arbitrary. The menu's music is BGM_103, and it is in HANDOFF at 9ca1eb5 -- the exact commit BLOCKED.md says that row was reconciled against. Not stale: wrong when written. I had summarised a negative without its reach, so "the TABLES cannot say which BGM a screen plays" became "it is not on the disc". One word of scope was the whole answer, and the export failed only because BGM_001 without its .slb extension hashes to nothing. That is luck, not design. 3. The comment above the BGM sum argued for unity gain "because halving is a mix decision nobody made". It clipped at +1.8 dBFS. 1/n is the smallest constant that provably cannot clip -- the same reasoning video.rs already carried for its 5.1 downmix, in this repository, unread. Unsettled and shipped as such: media::sound_bank_riffs returns THREE sub-waves for BGM_103.slb where HANDOFF Q10's census says exactly two (the third is the leading headerless region slb.rs emits for the voice path). The exporter sums all three and writes a manifest warning, because which bytes belong together is the decoders' question, not this exporter's -- and dropping one would destroy the evidence, since a corrected export looks exactly like a correct one. Raised with the Decoder; row in BLOCKED.md. The gate is a null control, not a peak reading. A master-bus WAV that is non-silent proves nothing -- the bed alone would look identical. So the same scripted walk was run with <- in place of <v>, which fires no cue (Q5, measured), and the difference is one 0.55 s burst at t=1.10 s and silence everywhere else. The first attempt at that control returned bit-identical zero and I nearly filed it as "cues never reach the bus": both runs ended at 1.115 s and the first press lands at 1.17 s. A null result from an instrument that was not running is not a null result. Refutation attempt: HANDOFF Q8's three cue durations. They looked attackable -- 0.133/0.172/0.169 s per packet, no shared rate -- but an XMA1 packet carries a variable number of 512-sample frames, and the three come to 50.0/32.3/95.3 frames. Measured off the decoded Ogg: 0.533, 0.344, 1.016 s, every published digit. SURVIVES, with its reach stated -- it confirms the assembly path and my transcription, not the event bindings, which only an oracle can retake. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WM5XL4HfrHuxz8RiMWdCMC	2026-08-29 12:29:13 +00:00
MechaCat02	a8d2491366	audio: actually install the capture path I kept deferring ... The audio work was three parts and I shipped two. The transcode-fidelity method and the pinned 5.1 downmix landed; the null sink -- the only one that answers "what does the GAME play" -- I deferred to "the next natural rebuild window" and then rebuilt both images four times without doing it. pulseaudio-utils is now in both, with tools/audio-capture wrapping it: a null sink is a real device as far as an application is concerned, so Canary and Godot open it normally and parec records what they emit. This unblocks the decoder's Q8. The cue-to-event bindings are currently a name match against the authors' own identifiers -- a plausible guess, not a measurement -- and capturing what the game plays on a menu move converts them. `audio-capture run` reports the peak level and warns when the capture is silent, because silence is the failure that looks like success: a WAV of exactly the right duration, full of zeroes, because the application opened a different sink. A duration check alone passes it, which is how a confident wrong number gets made.	2026-08-29 13:41:02 +02:00
MechaCat02	65cefa74c3	monorepo: one repository for the decoders, the port and the corpus ... Merges the Godot port into the reverse-engineering repository, preserving both histories -- 1019 commits of corpus plus the port's 31, brought in by subtree merge and then moved into place so git can follow each file across the rename. The reason is not tidiness. The two-repo split forced the exporter to depend on the decoders by pinned revision, and that created a whole class of failure that now disappears: a sha reachable only from a topic branch, orphaned by a squash-merge, breaking a fresh checkout silently at build time. It also forced a live read-only mount of one agent's working tree into another's container, which is why a contract file could move mid-iteration. With a path dependency, a decoder change and the exporter change it requires land in the same commit or not at all. Canary stays separate: it is a fork tracking upstream. New structure for the long term: docs/game/ how the game is NAVIGATED -- menus, modals, prompts, alerts, and in-game flight. Written so nobody rediscovers it. Mostly open questions on purpose; the in-game tutorials are the resource for the flight half. docs/port/MODDING.md modding as a constraint on the exporter TODAY, not a later feature: one logical asset in one file (the disc splits nearly everything, and resolving that is the exporter's job), names a person recognises, PNG/OGG/OGV/JSON only, base-and-overrides so re-exporting is always safe, provenance in every file. data/base + data/mods generated tree and drop-in overrides, both gitignored exchange/ transient inter-agent files, deliberately outside history docs/agents/ the team protocol Both the README and the navigation doc lead with the correction that cost the most: the oracle is the real game under Xenia Canary. Reborn's renderer is a hypothesis under test, it has been wrong, and treating it as ground truth propagated into three documents and both agents before a human caught it. Scripted modding stays possible without being built: no screen name is hardcoded in GDScript and there is no native code in port/, which is what Godot Mod Loader needs to be able to substitute behaviour later.	2026-08-29 11:34:46 +02:00