This branch holds freesce's meta-information: reconstruction trackers,
methodology notes, findings logs, and review writeups. None of it is
specific to one SDK vintage, so it lives here once instead of being
duplicated (and drifting) across sdk-1.0, sdk-2.0, sdk-2.4 and
sdk-3.0.3.
The source itself lives on those four branches — see the top-level
README.md there for build instructions. A convenient way to have both
open at once is a second worktree:
git worktree add ../freesce-docs docs
| branch | libkernl | libgraph/dma/pc/pad | libcdvd | libvu0 |
|---|---|---|---|---|
sdk-1.0 |
done | not started (currently 3.0.3-shaped, needs backport) | doesn't exist at 1.0 | not started |
sdk-2.0 |
done | not started (ditto) | deferred (2.0 ships a structurally different monolithic eecdvd.o) |
not started |
sdk-2.4 |
Milestone 2 SOURCE-COMPLETE (2026-08-26) against the genuine 2.4.2 archive (DTL-S2324), 11 members fully byte-exact, relocaudit-clean | libpc done, libgraph done except graph018 (a real ~400-ins member), libdma/libpad ERX-dropped, body diffs pending | 3.0.3-shaped, verified 2.4-IOP-compatible (47/49 members byte-identical); honest pass = cdvd000/021 backport | scoped: fresh build needed, no free ride from 2.0 |
sdk-3.0.3 |
Milestone 2+3 still owed | done | done | not started |
Current priority (2026-08-24): sdk-2.4. The goal is one branch
that's a fairly complete, working SDK vintage against freesce's own
compiler — meet in the middle by evolving libkernl forward from 2.0
and the other libraries backward from 3.0.3, both already-done
starting points one hop away from 2.4. sdk-2.4 branches directly off
sdk-3.0.3's tip rather than off sdk-2.0, since finishing sdk-2.0
first isn't on the critical path to it. sdk-1.0 and a standalone
finished sdk-2.0 are real goals but lower priority — later work, not
blocking. Dedicated worktree: ~/src/freesce_24.
Status 2026-08-26: libkernl's Milestone 2 is source-complete against the genuine 2.4.2 archive, and the librw demoreel's CD build boots end-to-end in pcsx2 against the 2.4.2 IOP pieces (IOPRP242 reboot, sio2man/padman 2.03).
See SDK24-PLAN.md for the full convergence plan (per-library status,
work order, methodology gotcha found while scoping it) and
LIBKERNL-PLAN.md's new "STATUS TABLE — SDK 2.4 / Milestone 2"
section for libkernl's exact 22-member breakdown.
LIBKERNL-PLAN.md— the libkernl reconstruction tracker: per-member status, work order, detailed RESULTS writeups.SDK24-PLAN.md— the sdk-2.4 convergence plan covering the other five libraries (libgraph/dma/pc/pad/cdvd/vu0): per-library status, work order.issues.txt/SKY-ISSUES.md— findings logs (freesce-as-SDK bugs, and SKY-simulator-vs-hardware deviations), sameS#/#numbering scheme.REVERSING.md— the accumulated RE method: idioms, traps, the rules that came out of real mistakes.MISSING.md— header completeness tracking vs the SDK originals.REVIEW-NOTES.md,claude_review.txt,notes/— session review and verification writeups.old_ps2toolchain_bugs— scratch notes, upstream links..hermes/plans/— planning docs for the project as a whole.