RustyN64 v0.4.1
v0.4.1 — Phase-3-close documentation reconciliation
A documentation-only patch over v0.4.0 "Rasteriser". No code changed; the emulator
behaves byte-identically to v0.4.0. This release exists to reconcile the planning and
status documents with the reality that Phase 3 (the LLE RDP + VI) shipped in v0.4.0 —
the phase-close documentation pass had been skipped, so several docs still described a
pre-v0.4.0 world.
What changed
- docs/STATUS.md: the RDP is no longer described as a stub (the chip-crate skeleton
line, the DPC-registers row, and the "RDP LLE" roadmap row now record the working
rasteriser); the release-infrastructure lines record v0.1.0-v0.4.1 as tagged and
released instead of "no tag has been cut". - README.md: the Compatibility & Accuracy table adds the two passing Phase 3 gates
(RDP conformance vs Angrylion across 164 vectors, and the real-ROM golden frame) and
reclassifies real-game visual goldens to Phase 7; the Performance rationale, the
"Current Release" next-rung (now v0.5.0), and the Roadmap phase list (Phases 0-3
complete, Phase 4 next) are corrected; version badge and bibtex bumped. - to-dos/ROADMAP.md: the phase matrix marks Phase 2 (v0.3.0) and Phase 3 (v0.4.0)
COMPLETE, the Status block advances to Phase 4, and the v1.0.0 milestone records the
tags cut so far. v0.4.1 is noted as a documentation-only patch (no new scope). - to-dos/VERSION-PLAN.md, docs/rdp.md, docs/architecture.md: the RDP / rasteriser /
RDP tick methods are marked implemented rather than stubbed. - Phase 0-3 plan files: completion banners added; Phase 2's nine met exit criteria and
the Sprint 1/Sprint 4 checklists checked off (the SU/VU dual-issue timing box stays an
honest, ledgered deferral); Phase 0's golden-trace and release-tag boxes marked
resolved and the superseded ADR 0001 3:2-clock criterion annotated; Phase 3's exit
criteria and Sprint 3 review checklist reconciled with their R-9/R-10/R-11 residuals.
Known limitations (unchanged from v0.4.0)
- AI audio (Phase 4) and cartridge boot / saves (Phase 5) are not implemented; the
rustyn64 binary opens a shell and presents a test pattern. A greencargo testdoes
not mean a subsystem works — see docs/STATUS.md. - RDP residuals carried to Phase 7: attribute interpolation (R-9), exotic combiner
inputs (R-10), and the coverage / AA / alpha-compare / dither paths (R-11).
Verification
No behavioural gates changed. All accuracy oracles remain as of v0.4.0: n64-systemtest
Failed: 0 on CPU/COP0/TLB/COP1 and RSP; the CPU golden-log 0-diff against ares; the RDP
conformance suite bit-matching Angrylion across 164 committed vectors; and the real-ROM
golden frame (T-33-006). CI green across the full release matrix (ubuntu/macOS/windows +
test-roms), rustdoc (-D warnings), the no_std cross-build, the commercial-ROM guard, and
markdownlint.
Install: download the per-target archive, verify against SHA256SUMS, and extract. Each
archive carries both licences (MIT OR Apache-2.0), NOTICE, README, and CHANGELOG.