chore(release): v0.8.1 - M9 Known Issues Resolution 85% Complete

doublegate · claude · doublegate · commit 38125f4725eb · 2025-12-28T18:03:14.000-05:00
Version bump to v0.8.1 capturing M9 Known Issues Resolution progress: ## Phase 1 - Version Updates - Workspace Cargo.toml: 0.8.0 -> 0.8.1 - rustynes-apu Cargo.toml: 0.8.0 -> 0.8.1 - rustynes-desktop Cargo.toml: 0.8.0 -> 0.8.1 - GUI About dialog: Version 0.8.0 -> Version 0.8.1 ## Phase 2 - Documentation Updates - CLAUDE.md: Updated status, version, milestones, added v0.8.1 accomplishments - README.md: Updated status, Quick Start, milestone table, citation - CHANGELOG.md: Added comprehensive v0.8.1 entry with sprint details - ROADMAP.md: Added v0.8.1 to Recent Updates and version history - PHASE-1.5-OVERVIEW.md: Updated status and current version - M9-OVERVIEW.md: Added current version field ## M9 Sprint Status (85% Complete) - S1: Audio Improvements - COMPLETE - Two-stage decimation via rubato (1.79MHz -> 192kHz -> 48kHz) - A/V sync with adaptive speed adjustment (0.99x-1.01x) - Dynamic buffer sizing (2048-16384 samples) - S2: PPU Edge Cases - COMPLETE - Sprite overflow bug with hardware-accurate false positive/negative - Palette RAM mirroring at $3F10/$3F14/$3F18/$3F1C - Mid-scanline write detection for split-screen effects - S3: Performance Optimization - CORE COMPLETE - CPU: #[inline] on step(), execute_opcode(), handle_nmi(), handle_irq() - PPU: #[inline] on step(), step_with_chr() - 68+ existing inline annotations verified - S4: Bug Fixes & Polish - PENDING ## Test Results - 508+ tests passing (0 failures, 0 ignored) - 100% Blargg pass rate (90/90 tests) - Zero accuracy regressions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,6 +11,74 @@ No unreleased changes.
 
 ---
 
+## [0.8.1] - 2025-12-28 - M9 Known Issues Resolution (85% Complete)
+
+**Status**: Phase 1.5 Stabilization - M9 Sprints 1-3 Core Implementation Complete
+
+This release advances M9 Known Issues Resolution to 85% complete, implementing core improvements for audio quality, PPU edge cases, and performance optimization while maintaining zero test regressions.
+
+### Highlights
+
+- **Audio Improvements (S1 Complete):** Two-stage decimation via rubato, A/V sync with adaptive speed adjustment
+- **PPU Edge Cases (S2 Complete):** Sprite overflow bug emulation, palette RAM mirroring, mid-scanline writes
+- **Performance Optimization (S3 Core Complete):** `#[inline]` hints on CPU/PPU hot paths
+- **Zero Regressions:** 508+ tests passing, 100% Blargg pass rate maintained
+
+### Added
+
+- **CPU Inline Hints:** `#[inline]` attributes on step(), execute_opcode(), handle_nmi(), handle_irq()
+- **PPU Inline Hints:** `#[inline]` attributes on step(), step_with_chr()
+- **M9 Progress Tracking:** Current version field in M9-OVERVIEW.md
+
+### Changed
+
+#### Audio Improvements (Sprint 1)
+
+- Two-stage decimation via rubato: 1.79MHz -> 192kHz -> 48kHz
+- A/V sync with adaptive speed adjustment (0.99x-1.01x)
+- Dynamic buffer sizing (2048-16384 samples)
+- Hardware-accurate mixer with NES filter chain
+
+#### PPU Edge Cases (Sprint 2)
+
+- Sprite overflow bug with false positive/negative matching hardware behavior
+- Palette RAM mirroring at $3F10/$3F14/$3F18/$3F1C verified
+- Mid-scanline write detection for split-screen effects
+- Attribute byte extraction verified for all quadrants
+
+#### Performance Optimization (Sprint 3)
+
+- Added `#[inline]` to CPU hot paths: step(), execute_opcode(), handle_nmi(), handle_irq()
+- Added `#[inline]` to PPU hot paths: step(), step_with_chr()
+- Verified 68+ existing inline annotations in CPU/PPU crates
+- Zero accuracy regressions confirmed
+
+### Technical Specifications
+
+**M9 Sprint Status:**
+
+| Sprint | Status | Core Tasks |
+|--------|--------|------------|
+| S1: Audio | COMPLETE | Dynamic resampling, A/V sync, buffer management |
+| S2: PPU | COMPLETE | Sprite overflow, palette RAM, mid-scanline, attributes |
+| S3: Performance | CORE COMPLETE | Inline hints, hot path optimization |
+| S4: Bug Fixes | PENDING | GitHub issues, release prep |
+
+**Test Results:**
+
+- Total tests: 508+ passing
+- Failures: 0
+- Ignored: 0
+- Blargg pass rate: 100% (90/90 tests)
+
+### What's Next
+
+- **Sprint 4:** GitHub issue triage and resolution
+- **v0.9.0:** Full M9 completion with all bug fixes
+- **M10:** Final polish and v1.0.0-alpha.1 preparation
+
+---
+
 ## [0.8.0] - 2025-12-28 - Rust 2024 Edition & Dependency Modernization
 
 **Status**: Phase 1.5 Stabilization - M9 Sprint 0 Complete (Dependency Upgrade)
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -6,11 +6,20 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 RustyNES is a next-generation Nintendo Entertainment System (NES) emulator written in Rust. Target: 100% TASVideos accuracy test pass rate, 300+ mappers, RetroAchievements, GGPO netplay, TAS tools, Lua scripting.
 
-**Status:** v0.8.0 - Phase 1.5 Stabilization In Progress (M7-M8 Complete, M9-M10 Planned). All Phase 1 milestones (M1-M6) done.
+**Status:** v0.8.1 - Phase 1.5 Stabilization In Progress (M7-M8 Complete, M9 85% Complete). All Phase 1 milestones (M1-M6) done.
 
 **Test Status:** 508+ tests passing (0 failures, 0 ignored). 100% Blargg pass rate (90/90 tests)
 
-**Current Version:** v0.8.0 (December 28, 2025)
+**Current Version:** v0.8.1 (December 28, 2025)
+- M9 Known Issues Resolution: Core implementation 85% complete
+- CPU performance: #[inline] hints on step(), execute_opcode(), handle_nmi(), handle_irq()
+- PPU performance: #[inline] hints on step(), step_with_chr()
+- Audio improvements: Dynamic resampling, A/V sync, buffer management (S1 complete)
+- PPU edge cases: Sprite overflow, palette RAM, mid-scanline writes (S2 complete)
+- Performance optimization: Hot path inline hints (S3 core complete)
+- Zero accuracy regressions (508+ tests passing)
+
+**Previous Version:** v0.8.0 (December 28, 2025)
 - Rust 2024 Edition adoption (MSRV 1.88)
 - Comprehensive dependency modernization
 - eframe 0.33 + egui 0.33 immediate mode GUI
@@ -275,10 +284,41 @@ Cloned emulators for study and pattern reference:
 | **M8: Test ROMs** | ✅ v0.7.0 | 100% Blargg pass rate (90/90 tests) |
 | **GUI Migration** | ✅ v0.7.1 | eframe + egui desktop reimplementation |
 | **Dependency Upgrade** | ✅ v0.8.0 | Rust 2024, eframe 0.33, egui 0.33, cpal 0.16, ron 0.12 |
-| **M9-10: Phase 1.5** | 🔄 PLANNED | Known issues resolution, polish, documentation |
+| **M9: Known Issues** | 🔄 v0.8.1 (85%) | Audio S1, PPU S2, Performance S3 complete; S4 pending |
+| **M10: Final Polish** | 📋 PLANNED | UI/UX improvements, documentation, v1.0.0-alpha.1 |
 | **Phase 2+** | 📋 TBD | Advanced features |
 
-## Recent Accomplishments (v0.8.0 - Dec 28, 2025)
+## Recent Accomplishments (v0.8.1 - Dec 28, 2025)
+
+### M9 Known Issues Resolution (85% Complete)
+
+Systematic resolution of known issues identified during Phase 1.5 development:
+
+#### Sprint 1: Audio Improvements (Complete)
+- Two-stage decimation via rubato: 1.79MHz -> 192kHz -> 48kHz
+- A/V sync with adaptive speed adjustment (0.99x-1.01x)
+- Dynamic buffer sizing (2048-16384 samples)
+- Hardware-accurate mixer with NES filter chain
+
+#### Sprint 2: PPU Edge Cases (Complete)
+- Sprite overflow bug with false positive/negative matching hardware
+- Palette RAM mirroring at $3F10/$3F14/$3F18/$3F1C
+- Mid-scanline write detection for split-screen effects
+- Attribute byte extraction verified for all quadrants
+
+#### Sprint 3: Performance Optimization (Core Complete)
+- Added `#[inline]` to CPU hot paths: step(), execute_opcode(), handle_nmi(), handle_irq()
+- Added `#[inline]` to PPU hot paths: step(), step_with_chr()
+- Verified 68+ existing inline annotations in CPU/PPU crates
+- Zero accuracy regressions (508+ tests passing)
+
+#### Sprint 4: Bug Fixes & Polish (Pending)
+- GitHub issue triage and resolution
+- Release preparation for v0.9.0
+
+---
+
+## Previous Accomplishments (v0.8.0 - Dec 28, 2025)
 
 ### Comprehensive Dependency Modernization
 
diff --git a/Cargo.toml b/Cargo.toml
@@ -15,7 +15,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.8.0"
+version = "0.8.1"
 edition = "2024"
 rust-version = "1.88"
 authors = ["doublegate"]
diff --git a/README.md b/README.md
@@ -28,7 +28,7 @@ A next-generation NES emulator written in pure Rust — targeting 100% accuracy,
 
 ---
 
-> **Status:** v0.8.0 Released - Rust 2024 Edition & Dependency Modernization Complete
+> **Status:** v0.8.1 Released - M9 Known Issues Resolution 85% Complete
 >
 > **Milestones Completed:**
 >
@@ -41,6 +41,7 @@ A next-generation NES emulator written in pure Rust — targeting 100% accuracy,
 > - ✅ **M7: Accuracy** - CPU/PPU/APU timing refinements, OAM DMA 513/514 cycle precision, hardware-accurate mixer
 > - ✅ **M8: Test ROMs** - 100% Pass Rate on all integrated test suites (CPU, PPU, APU, Mappers)
 > - ✅ **M9-S0: Dependencies** - Rust 2024 Edition, eframe 0.33, egui 0.33, cpal 0.16, ron 0.12
+> - 🔄 **M9: Known Issues** (85%) - Audio S1, PPU S2, Performance S3 complete; Bug fixes S4 pending
 >
 > **Test Suite:** 508+ tests passing (0 failures, 0 ignored)
 >
@@ -88,22 +89,20 @@ RustyNES combines **accuracy-first emulation** with **modern features** and the
 
 ## Quick Start
 
-### Recent Release: v0.8.0 (December 28, 2025)
+### Recent Release: v0.8.1 (December 28, 2025)
 
-RustyNES v0.8.0 completes comprehensive dependency modernization and adopts Rust 2024 Edition:
+RustyNES v0.8.1 advances M9 Known Issues Resolution to 85% complete with core implementation work:
 
-**What's New in v0.8.0:**
+**What's New in v0.8.1:**
 
-- **Rust 2024 Edition:** Latest Rust language features and improvements (MSRV 1.88)
-- **eframe 0.33 + egui 0.33:** Latest immediate mode GUI with improved widget system
-- **cpal 0.16:** Audio device improvements and better cross-platform support
-- **rubato 0.16:** High-quality audio resampling for flexible sample rate support
-- **ron 0.12:** Configuration format improvements
-- **thiserror 2.0:** Error handling modernization
-- **Performance:** Inline hints on critical paths, buffer reuse patterns
+- **Audio Improvements (S1):** Two-stage decimation via rubato, A/V sync with adaptive speed adjustment
+- **PPU Edge Cases (S2):** Sprite overflow, palette RAM mirroring, mid-scanline write detection
+- **Performance Optimization (S3):** `#[inline]` hints on CPU/PPU hot paths (step, execute_opcode, handle_nmi/irq)
+- **Zero Regressions:** 508+ tests passing, 100% Blargg pass rate maintained
 
 **Previous Releases:**
 
+- **v0.8.0** - Dependency Modernization: Rust 2024 Edition, eframe 0.33, egui 0.33, cpal 0.16, ron 0.12
 - **v0.7.1** - GUI Framework Migration: eframe 0.29/egui 0.29, immediate mode GUI, debug windows
 - **v0.7.0** - Milestone 8: 100% Blargg test pass rate, cycle-accurate CPU tick(), PPU open bus, CHR-RAM routing
 - **v0.6.0** - Milestone 7: APU frame counter precision, hardware-accurate mixer, OAM DMA 513/514 cycles
@@ -302,7 +301,7 @@ Controls will be fully configurable through the configuration system.
 
 ## Features
 
-### Current Status (v0.8.0 - December 2025)
+### Current Status (v0.8.1 - December 2025)
 
 - [x] **Architecture Design** - Complete modular crate structure with 10 component crates
 - [x] **Documentation** - 40+ comprehensive specification and implementation guides covering CPU, PPU, APU, mappers, testing, and development
@@ -853,9 +852,9 @@ If you use RustyNES in academic research, please cite:
   author = {RustyNES Contributors},
   title = {RustyNES: A Next-Generation NES Emulator in Rust},
   year = {2025},
-  version = {0.8.0},
+  version = {0.8.1},
   url = {https://github.com/doublegate/RustyNES},
-  note = {Cycle-accurate NES emulator with 100\% Blargg test pass rate, Rust 2024 Edition, eframe/egui desktop GUI, and hardware-accurate emulation}
+  note = {Cycle-accurate NES emulator with 100\% Blargg test pass rate, M9 Known Issues Resolution 85\% complete, Rust 2024 Edition, eframe/egui desktop GUI}
 }
 ```
 
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -21,7 +21,17 @@
 
 ---
 
-## Recent Updates (v2.9.0 - December 2025)
+## Recent Updates (v2.10.0 - December 2025)
+
+**v0.8.1 Released - December 28, 2025** - M9 Known Issues Resolution 85% Complete!
+
+**M9 Sprint Achievements:**
+
+- **Audio Improvements (S1):** Two-stage decimation via rubato, A/V sync with adaptive speed adjustment
+- **PPU Edge Cases (S2):** Sprite overflow, palette RAM mirroring, mid-scanline write detection
+- **Performance Optimization (S3):** `#[inline]` hints on CPU/PPU hot paths (step, execute_opcode, handle_nmi/irq)
+- **Zero Regressions:** 508+ tests passing, 100% Blargg pass rate maintained
+- **Documentation:** Updated all project files with v0.8.1 version references
 
 **v0.8.0 Released - December 28, 2025** - Rust 2024 Edition & Dependency Modernization!
 
@@ -31,8 +41,6 @@
 - **Dependency Upgrades:** eframe 0.33, egui 0.33, cpal 0.16, ron 0.12, rfd 0.15
 - **Audio Resampling:** rubato 0.16 integration for high-quality sample rate conversion
 - **Performance:** Inline hints and buffer reuse optimizations across APU subsystem
-- **Test Suite:** 508+ tests passing (0 failures, 0 ignored)
-- **Documentation:** Complete version reference updates across all project files
 
 **v0.7.1 Released - December 27, 2025** - Desktop GUI Framework Migration Complete!
 
@@ -98,6 +106,7 @@
 - v0.7.0 (December 21, 2025): M8 Test ROM Validation - 100% Blargg pass rate (90/90 tests)
 - v0.7.1 (December 27, 2025): GUI Framework Migration - Complete rewrite from Iced+wgpu to eframe+egui
 - v0.8.0 (December 28, 2025): Rust 2024 Edition - MSRV 1.88+, dependency modernization, audio resampling
+- v0.8.1 (December 28, 2025): M9 Known Issues (85%) - Audio S1, PPU S2, Performance S3 complete
 
 **Project Status Change:**
 
diff --git a/crates/rustynes-apu/Cargo.toml b/crates/rustynes-apu/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "rustynes-apu"
-version = "0.8.0"
+version = "0.8.1"
 edition = "2024"
 rust-version = "1.88"
 authors = ["RustyNES Contributors"]
diff --git a/crates/rustynes-desktop/Cargo.toml b/crates/rustynes-desktop/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "rustynes-desktop"
-version = "0.8.0"
+version = "0.8.1"
 edition = "2024"
 rust-version = "1.88"
 authors = ["doublegate"]
diff --git a/crates/rustynes-desktop/src/gui/mod.rs b/crates/rustynes-desktop/src/gui/mod.rs
@@ -178,7 +178,7 @@ fn render_about_window(ctx: &Context, open: &mut bool) {
         .show(ctx, |ui| {
             ui.vertical_centered(|ui| {
                 ui.heading("RustyNES");
-                ui.label("Version 0.8.0");
+                ui.label("Version 0.8.1");
                 ui.add_space(10.0);
                 ui.label("A cycle-accurate NES emulator written in Rust");
                 ui.add_space(10.0);
diff --git a/to-dos/phase-1.5-stabilization/PHASE-1.5-OVERVIEW.md b/to-dos/phase-1.5-stabilization/PHASE-1.5-OVERVIEW.md
@@ -2,9 +2,9 @@
 
 **Phase:** 1.5 (Stabilization & Accuracy)
 **Duration:** ~12 weeks / 3 months (January 2026 - April 2026)
-**Status:** In Progress (M7-M8 Complete, M10-S0 Complete)
+**Status:** In Progress (M7-M8 Complete, M9 85% Complete, M10-S0 Complete)
 **Goal:** Bridge MVP to production-quality emulator with 95%+ test ROM pass rate
-**Current Version:** v0.8.0 (December 2025)
+**Current Version:** v0.8.1 (December 2025)
 **Test Status:** 508+ unit tests passing, 100% Blargg pass rate (90/90 ROMs)
 
 ---
diff --git a/to-dos/phase-1.5-stabilization/milestone-9-known-issues/M9-OVERVIEW.md b/to-dos/phase-1.5-stabilization/milestone-9-known-issues/M9-OVERVIEW.md
@@ -6,6 +6,7 @@
 **Status:** CORE IMPLEMENTATION COMPLETE
 **Version Target:** v0.9.0
 **Progress:** 85%
+**Current Version:** v0.8.1 (Interim release with S1-S3 core work complete)
 **Baseline:** v0.8.0 (Rust 2024 Edition, Dependency Modernization Complete)
 **Last Updated:** December 28, 2025
 

Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ members = [`
`15`	`15`	`]`
`16`	`16`
`17`	`17`	`[workspace.package]`
`18`		`-version = "0.8.0"`
	`18`	`+version = "0.8.1"`
`19`	`19`	`edition = "2024"`
`20`	`20`	`rust-version = "1.88"`
`21`	`21`	`authors = ["doublegate"]`