feat(reconstruction): complete binary-backed C recovery

Replace the partial mechanics transcriptions with a separate, readable C11
reconstruction of the complete Win16 image while preserving the original raw
Ghidra export as immutable evidence. Cover all ordinary and overlapping entry
points, Borland runtime behavior, Win16 imports, segmented data, callbacks,
resources, indirect control flow, physics, rendering, persistence, and
startup/shutdown lifecycles.

Add deterministic extraction and audit tooling plus address-linked ledgers for
functions, imports, DGROUP ranges and objects, relocations, resources, and
callbacks. The final gate records zero raw, partial, restored, unknown,
blocked, or unclassified required units. Keep the semantic-fidelity boundary
explicit: the portable C is not claimed to reproduce a byte-identical Borland
NE build.

Add strict focused harnesses for every reconstructed C unit, exact resource
round-trip checks, and a 16-bit Borland Real48 reference probe. No Rust source
or Cargo metadata is changed in this phase.

Test Plan:
- `bash original/tools/test_reconstructed_c.sh` -- passed
- `bash original/tools/probe_real48_reference.sh` -- passed bit-for-bit
- `python3 original/tools/audit_reconstruction.py --require-complete` -- passed
- `git diff --cached --check` -- passed
- `git diff HEAD -- '*.rs' Cargo.toml Cargo.lock` -- empty
This commit is contained in:
2026-08-23 16:41:17 +02:00
parent aef404c834
commit 8b99e9607c
253 changed files with 79031 additions and 51 deletions
+6 -5
View File
@@ -1,13 +1,14 @@
/*
* Readable mechanics transcription for TDKPIN.EXE.
* HISTORICAL PARTIAL mechanics transcription for TDKPIN.EXE.
*
* Target SHA-256:
* a9022f1894e3e6e21fc42e8f6c932f7c549ca77f63aaa0c488bb9d55d9d0174c
*
* This is a named, reviewable companion to TDKPIN_GHIDRA_RAW.c. It is not
* claimed to be the vendor's source or a buildable replacement. Every
* restored routine below names its raw address, and unresolved conversions
* stay explicit instead of being filled with guessed values.
* This superseded intermediate is retained only as provenance for the earlier
* live-probe work. It is not part of the completed readable-C deliverable.
* The authoritative complete address-linked implementations are under
* reconstructed/, especially tdkpin_flipper_collision.c,
* tdkpin_flipper_bitmap_geometry.c, tdkpin_physics.c, and tdkpin_timer_tick.c.
*/
#include <stdbool.h>