Function_2_C_Decompiler 0.12.0

0.12.0 lets N64 code grow (experimental), installs without a clone, and lets installed apps be told about releases. It collects 0.11.1 to 0.11.6, which are the history below.

New, experimental: N64 projects whose code can grow. Everything here is verified on the demo ROM only, and the README says so.

• decomp shift-audit PROJECT reads an exported N64 project and reports what is pinned to an absolute address, so that growing code would break it: address loads and calls that are symbols against numbers, jump tables, and what each number points at. It changes nothing.
• decomp shift-prep PROJECT makes the jump tables and function pointers symbolic without changing what the project builds (a preview unless you give --apply; it writes shift-prep.json listing every change). On the demo: 39 labels inserted, 39 table entries rewritten, and the project still rebuilds byte for byte, and C functions still match.
• decomp shift-prep PROJECT --layout switches the build to a layout in which code can grow, and recomputes the ROM's header checksums (the 6102 family only; it checks that against the original and writes nothing for a boot chip it cannot verify). An unchanged project still rebuilds the identical ROM; growing the first function by 16 bytes grows the ROM by exactly 16, and an independent check accounts
  for all 8,108 instructions (the 96 functions and the start-up stub) and every data word after the code.
• It refuses, with the reason, a game with a global pointer, symbols pinned inside the program, or C functions that keep their own data. Not verified: any real game. The demo has no padding, no pointers into data or bss, no overlays and no compression, so Super Mario 64, GoldenEye and Perfect Dark may well fail; pointers into data and bss are not handled yet. Try it on a copy, and a project you have changed cannot be compared with the original,
  so the build can say what moved but not that it is right.

New: install without cloning, and updates that follow releases. curl -fsSL https://raw.githubusercontent.com/FlyPhantomFly/Function_2_C_Decompiler/main/site/public/install.sh | bash installs the latest published release, and an app installed that way (or from any release) is told about newer ones and updates itself on request (decomp update). Until 0.11.6 the installer refused
without a clone and no app could be told about a release at all. It installs the tag's source archive; it does not check a checksum while installing, and releases are not signed.

Smaller. The README's animated demo has the product's name in its title bar, and its caption says it is a scripted simulation from upstream rather than a recording of a real run. Upstream's discontinuation notice is no longer in the README (the credit and links to the original project are); the test that guards the original author's words now only requires
that they are never rewritten.

Upgrading from 0.11.0: nothing to do, and no database changes (the schema is still 3).

Still not verified, so you know what to try first

• Any real N64 game with the shifting tools (above).
• decomp run with a real agent matching functions. There was no agent or API key where it was built. Start small: decomp run PROJECT --agent claude --until 5%.
• The eval harness against a real provider. PlayStation 2, GBA, DS, GameCube and Windows are unmeasured.
• Releases are not signed: the checksums beside them detect a damaged file, not who made it.

Checked: this version, with the CI checks job's own commands and the optional tools hidden as on a bare runner: 733 passed, 170 skipped, 0 failed, the wheel builds and checks clean, actionlint clean. CI has run green on GitHub since 0.11.4, and the Release workflow built and published 0.11.0 on its first run; its files verify against their checksums and install into a clean home.

---

The downloads are checksummed in SHA256SUMS: put it beside them and run sha256sum -c SHA256SUMS.

Function_2_C_Decompiler 0.11.0 - ROMday

ROMday is the first release of Function_2_C_Decompiler, a maintained fork of decomp.wtf (MIT, by sam wolfs; the original was discontinued at 0.10.6), maintained by PhantomThreads.
It points your AI agents at a game you own and turns its functions into C that compiles to the exact same bytes. This release collects everything done since the fork: 47 versioned changes (0.10.7 to 0.10.53), each in the history below.

Safer

• The updater, the installers, the app's links, the plugin and the generated files point at this repository only; nothing contacts the original project. The Windows installer refuses (Windows is not maintained here).
• Agent-written C is compiled only inside a sandbox (bubblewrap on Linux: sudo apt install bubblewrap). Running without one needs an explicit opt-out.
• A match is accepted only when the function itself is identical, not when a short fingerprint of it happens to be. Two real defects the new tests found in the original are fixed (an x86 crash on a relocation, and a hash treated as an identity).
• The hosted-network layer (a coordinator server, signup, donated compute) is removed: 42 files, 4,245 lines.

Your work is protected

• The database format is versioned. The first time an old database is opened a copy is kept beside it, with a checksum; a database from a newer version is refused untouched.
• Daily automatic backups (3 daily, 2 weekly, 1 monthly), each with a checksum, and a weekly check that the newest one really restores. decomp backup and decomp restore do the same by hand. They share your disk: copy ~/Decomp/backups/ elsewhere now and then.

New

• decomp run PROJECT --until 50% works until half of the project's starting functions are matched, stops gracefully, and --resume carries on without redoing or re-paying for anything. --until-budget USD is a separate limit. It keeps running if you close the terminal.
• A provider-aware budget: give each model endpoint its prices (OpenAI and DeepSeek charge less for cached tokens, and both are handled), and spend is logged by provider, agent and model, with subtotals in the app and one global cap.
• The built-in API agent retries a busy or briefly broken server in place instead of losing its conversation.
• decomp toolchain list|install|path; an eval harness to measure a model on the demo ROM (maintenance/tools/eval_agent.py); a new banner; releases built by CI with a SHA256SUMS file.
• The product is named Function_2_C_Decompiler wherever you read it. The command is still decomp, the package decompnet, and the names on disk that existing projects use are unchanged.

Tested: the original's own tests plus this fork's, 782 passed and 0 failed with every free compiler installed, and 679 passed on a bare machine with none; the same suite also passes from a fresh unpacked copy with no git. Every new feature was also broken on purpose to confirm its tests fail.

Not verified, so you know what to try first

• GitHub CI has not run before this release. This push is its first real run.
• decomp run has never run with a real agent matching functions: there was no agent or API key where it was built. Start small: decomp run PROJECT --agent claude --until 5%.
• The eval harness has not run against a real provider. PlayStation 2, GBA, DS, GameCube and Windows are unmeasured.
• The N64 shiftable export is not built (an analysis and a plan are in maintenance/SHIFTABLE_EXPORT.md). Today a rebuilt game matches the original byte for byte, at its original addresses.
• Checksums beside the downloads detect a damaged file; they do not prove who made it. Releases are not signed.
• The animated demo in the README still shows the old name in its title bar.

Download and check: put SHA256SUMS beside the files and run sha256sum -c SHA256SUMS. To install from a checkout, see "Install" in the README.

---

The downloads are checksummed in SHA256SUMS: put it beside them and run sha256sum -c SHA256SUMS.