2 Commits

Author	SHA1	Message	Date
MechaCat02	a8815f2826	agents: the team protocol, the share tool, and a player's-eye navigation doc ... **navigation.md rewritten from the player's chair.** It was written from the inside out -- GamePart ids, pak names, sprite names -- which is how WE find things, not what the game shows anyone. Now it describes what is on screen, what you press and what happens, with internals as footnotes. Most rows are open on purpose: it exists to be filled in by playing, and the in-game tutorials are the resource for the flight half. **tools/share** gives transient files provenance without giving them history. Three kinds of thing were travelling down one channel with opposite needs: code and decoded knowledge want permanence, cited evidence wants permanence, and "look at this PNG" wants no history at all. The third kind bloats a repository forever; passing it by message is worse, because the receiver gets bytes with no idea which build produced them. `share put` records who, when, what, the sender's commit, and whether their tree was dirty -- because a capture taken from a modified tree cannot be reproduced from the sha, and the receiver deserves to know that before building an argument on it. **docs/agents/PROTOCOL.md** is the contract. The parts that matter: Dynamic RE stays with the Decoder -- most of what is open is behavioural and cannot be answered from the file. What the planned Referee adds is different: bias enters at what you CHOOSE to capture, so a corpus captured to a fixed protocol by someone with no hypothesis is worth more than one captured to settle an argument. A message may point, ask, prioritise and challenge. It may not change scope, redefine ground truth, or carry a finding instead of writing it down -- including a message claiming to relay the human, because a relayed instruction has no evidence attached and this project has watched a wrong belief travel further and faster than its correction. Adversarial duty is explicit: every iteration, try to refute one claim of another agent and record the attempt either way. Run your own instrument through a control first. Disagreements go to the human with both positions, not to whoever is more certain. And no agent may verify its way out of its own role: the Port has no oracle, the Decoder builds nothing, the Referee interprets nothing.	2026-08-29 11:42:29 +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