Drew T
0c29c9e16b
- decomp-architect/corpus/record/: the how-to (13), decision-log, accelerators, retrospective, story, wave-playbook, effort-map, gen3-standards, gen3-handoff, DIGEST and every PhaseEnd (34) verbatim behind an authored front page (what each is, how to read it, what is NOT there — the phase logs, R19 — and that the mining pass is their distillation); tool_census: RECORD_SOURCES + record_dest + the third corpus in plan/write/check (358 copies + 28 pointers, --check OK); kit_lint exempts corpus/record; SETUP Step 6 gains 2c docs/inherited-record.md (+ the verify line; expected-manifest +1); ops-setup/README/tree/methodology/ wiki page/Home/Tools page/README bullet/SETUP row: "two dictionaries" → three - tools/kit_coverage.py (+ config/kit_coverage_map.tsv): derives R1..R83 from DIGEST §3 (asserted contiguous) and the 58 accelerator entries (headings + numbered items), asserts each is cited by a provenance line of the registry seed / the kernels or dispositioned (G / DK / FOLDED:G / ENV / PA / SEED: / KIT: / RECORD / COOKBOOK / NOT-PORTABLE; unknown ids refused); first run: 26 uncited rules + 21 uncited entries → DK-66 (a ledger's tie-break, a checker's widening and a blanket commit are part of the instrument — R70/R80/R52), DK-67 (the ignore file's directory-form wall — S91 (1)), DK-68 (a summarised signal is a claim, not ground truth — R14/R66) in a new kernels section 8 (the museum is 9; "In all" 68) + 41 dispositions (15 PA, 3 ENV, folds into G6/G18/G38/G66/DK-12/19/20/22/25/26/31/35/44/45/46/57/61, 1 KIT template, 1 COOKBOOK); now 0 UNCOVERED on both populations; wired into tools-health after tool_census --check; SETUP row + dictionary row - verify: tool_census --check OK; kit_coverage OK (rules 57 cited + 26 dispositioned / 83; accelerators 41 + 15 / 58); kit_lint OK; doc_links --strict OK; wiki_render --selftest 32 pages / 0 unlisted
{{PROJECT_NAME}}
A matching decompilation of {{GAME_TITLE}} ({{PLATFORM}}, {{GAME_SERIAL}}): C source that, compiled with the original era's toolchain and linked in the original order, reproduces every shipped binary byte for byte, verified by a hash check inside every build.
{{PROJECT_GOALS}}
Status
Progress numbers are generated by tools/progress.py and appear here once Phase 5 wires it (TODO(phase-5)).
Building from your own copy of the game
This repository contains no byte of the game: no executable, no disc or cartridge data, no disassembly listing, no memory image, no vendor SDK. To build, you need your own legally obtained copy.
- TODO(phase-1): stage your dump under
disks/(ignored by git) and run the extractor; it verifies your extraction against the committed manifest of hashes. - TODO(phase-3):
make buildreproduces each binary and checks its hash; the clean fleet verification is indocs/ops-setup.md. - TODO(phase-9): the fresh-clone proof — a stranger with their own copy can extract, build and verify from this README alone.
The no-ROM policy
Nothing derived from the game enters git — from the first commit, whether the repository is public or private. The
.gitignore is the firewall; tools/audit_public.py (its sources in config/firewall.txt) is the gate, run in CI on every
push; a pasted listing of the target's instructions counts too. See docs/wiki/The-ROM-firewall.md (TODO: created when
the wiki is set up) and src/NOTICE.md.
How this project is made
{{AI_DISCLOSURE}}
The standard it holds itself to: a function is "matched" only when the whole binary still hashes with it compiled from source; names and types are evidence-based, never guessed (an address-named placeholder is honest); every outward message to another project is written by a person; the project makes no automated requests to community services. The record — the phase syntheses, the decision log, the cookbook of byte-proven idioms — is what makes the work auditable.
Repository visibility
{{PUBLIC_OR_PRIVATE}}
Acknowledgements
Prior community work this project builds on or was checked against: {{COMMUNITY_WORK}}. The governance and method come from ProjectArchitect 2.0 and the decomp-architect kit distilled from a finished matching decompilation.
License
The project's own work — the tooling, the build system, the documentation — is licensed under {{LICENSE_CHOICE}}
(LICENSE). No license is asserted over the reimplemented sources under src/ (src/NOTICE.md). Third-party
components keep their own licenses (THIRD_PARTY.md). {{GAME_TITLE}} is the property of its rights holder.
Contributing
See CONTRIBUTING.md: bring your own copy of the game, never commit anything derived from it, and read the AI-use
conduct section before your first pull request.