# Firestaff v3.0.53 Firestaff v3.0.53 packages the current `main` after the latest CSB V1 runtime overlay rendering ownership work. ## Highlights since v3.0.52 - **CSB V1 runtime overlay marker drawing**: CSB viewport code now owns the fallback marker drawing for runtime floor objects and creature groups instead of keeping those pixel routines in the shared M11 game view. - **CSB V1 rendering ownership**: M11 now consumes CSB-owned object/group overlay placement and marker helpers, reducing remaining shared-game-view assumptions before exact sprite/material parity work. - **Release metadata**: In-app version strings, CMake metadata and release notes are synchronized to `v3.0.53`. ## Verification - Local release verification covers version synchronization, the focused CSB V1 viewport/render gates, the Phase A probe and `git diff --check` before GitHub Actions packaging. - The GitHub release workflow builds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, Linux arm64 and Steam Deck x86_64 artifacts from the `v3.0.53` release run. ## Release assets This release includes macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, Linux arm64, and Steam Deck x86_64 packages. Steam Deck uses the x86_64/SteamOS pacman package, not the Linux ARM64 artifact. Original Dungeon Master game data is not included. Full changelog: https://github.com/yeager/firestaff/compare/v3.0.52...v3.0.53

# Firestaff v3.0.7 Firestaff v3.0.7 packages the later 2026-06-25 post-v3.0.6 verification batch from `main`. It is another conservative evidence release: more local branch/worktree work has been inspected, promoted where it was still missing, and locked behind source/build gates without claiming new finished-game parity. ## Highlights since v3.0.6 - **DM1 Hall of Champions evidence is tighter**: stale probe registrations were removed, floating side-wall portrait pixels are now blocked, HiDPI portrait-surface coverage is gated, and seven previously local ordinal-22 runtime lanes are now CMake/CTest-backed on `main`. - **DM1 V2.2 M11 handoff is source-locked**: the verifier pins viewport sampling, shape-cache population, in-place render preference, legacy overlay fallback boundaries, and pit/stairs/teleporter/field asset routing. - **Source-media and decoder coverage advanced**: PC-98 and X68000 HDM media classifiers, FTL `HUNK_CODE` plus corrected `HUNK_DATA` zero-run decoding, and CSB `HCSB.HTC` Hint Oracle scanning all have bounded evidence without vendoring original game data. - **Cross-game runtime gates widened**: DM2 overlay/HUD asset gates, Nexus Track 1/font/light probes, and Theron Track 02/SRM evidence were added or hardened while keeping remaining real-asset handoff gaps documented as open work. - **Launcher data-status coverage improved**: the data-dir platform matrix and no-data popup paths are now covered, and TODO/DONE were refreshed so promoted evidence is not still listed as open. ## Verification - 22 commits ship on top of `v3.0.6`, including this release-prep commit. - GitHub Actions was green on `cb4d171df` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, Pages, and cross-platform determinism. - Focused local verification before release prep included CMake configure, builds for the seven new ordinal-22 probe targets, the ordinal-22 CTest cluster at 11/11, and `git diff --check`. - The release workflow rebuilds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts from the `v3.0.7` release commit. # Firestaff v3.0.6 Firestaff v3.0.6 packages the later 2026-06-25 evidence, asset-format, and release-status refresh after v3.0.5. It is a conservative release: the new gates make more of the current work reproducible in CI, while remaining runtime, decoder, and original-capture gaps stay documented as open work. ## Highlights since v3.0.5 - **DM1 Hall of Champions portrait placement is gated end to end**: a new all-portrait wall-coordinate probe scans all 24 source-visible C127 champion portrait poses in the Hall of Champions, including HALK, GANDO, and WUUF. It locks the D1C wall frame and C026 portrait cutout and checks wrong-wall stale redraw behavior without claiming original DOS pixel parity. - **Greatstone/SCK evidence moved from notes to gates**: current Greatstone `db_data/` paths now have an offline CTest-backed reachability fixture, the SCK mapfile-to-asset selection bridge is covered by synthetic and optional real-corpus probes, and FTL `HUNK_DATA` area-1 zero-run decompression is CTest-gated. FTL `HUNK_CODE`, mapfile item extraction, real corpus promotion, and runtime loading remain open. - **FM Towns CD layouts are classified safely**: DM1, CSB, and DM2 BIN/CUE or ISO/CUE redump-style layouts now have a bounded classifier with synthetic tests and ISO9660 PVD detection. It does not vendor game data, extract payloads, decode assets, or claim runtime launch proof. - **Public project status was cleaned up**: TODO.md was audited back to open work only, DONE.md records the verification sweep, and the completion matrix plus verifier scripts now reflect the current conservative per-game evidence totals. - **Build hygiene tightened**: duplicate modern static link lines were cleaned up through modern CMake policies, while the public docs and gap list keep the new evidence bounded to what is actually tested. ## Verification - 18 commits ship on top of `v3.0.5`, including this release-prep commit. - GitHub Actions was green on `3fe55d680` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, Pages, and cross-platform determinism. - Focused local verification before release prep included the completion matrix verifiers, CSB V1 source-lock verifiers, a 14-test focused CTest set covering the refreshed evidence manifests, and `git diff --check`. - The release workflow rebuilds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts from the `v3.0.6` release commit. # Firestaff v3.0.5 Firestaff v3.0.5 packages the 2026-06-25 post-v3.0.4 evidence and reference-hardening batch. This is still a conservative release: it adds source-locked CSB input coverage, platform/version provenance, and asset-format documentation without broadening public runtime-completion claims beyond the evidence now checked into the tree. ## Highlights since v3.0.4 - **CSB keyboard commands source-locked**: CSB gameplay now has a dedicated keyboard bridge for F1-F4 champion inventory toggles, Escape freeze/unfreeze, resting Return/Enter wake-up, Ctrl-S disk menu, and the Insert/arrow/Clr Home movement layout from the ReDMCSB command tables. - **DMWeb platform provenance expanded**: DM1, CSB, DM2, Nexus, and Theron's Quest docs now record more exact per-platform and per-version boundaries, including source-media notes, protection/copy boundaries, version matrices, screenshots/video provenance, and remaining real-media handoff gaps. - **Greatstone/SCK references corrected and widened**: the Greatstone coverage now distinguishes the real FTL hunk container, SCK mapfile metadata, Atari ST `START.PAK`, IMG5 planar images, Mac QuickTime `MooV` assets, SNES palette-selector metadata, and current reachable `db_data/` DM/CSB paths. The gap list keeps those follow-ups separate from already-fixed raw decoders such as IMG5 and PAK. - **DM1 Hall of Champions evidence continues**: additional post-v3.0.4 gates cover more ordinal slices, including side-wall/no-portrait and D2C far-positive cases, extending the source-locked runtime evidence without claiming finished screenshot parity. - **Release hygiene tightened**: CI now blocks tracked original game-data payloads, stale subproject metadata was removed, and the public docs stay focused on user-facing status rather than worker logs or private queue details. ## Verification - 70 commits ship on top of `v3.0.4`, including this release-prep commit. - GitHub Actions was green on `5a429a8b4` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, Pages, and cross-platform determinism. - Focused local verification before release prep included `git diff --check`. - The release workflow rebuilds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts from the `v3.0.5` release commit. # Firestaff v3.0.4 Firestaff v3.0.4 packages the 2026-06-24 post-v3.0.3 evidence and release-hardening batch. The release is still conservative about public game-status claims: it promotes source-locked probes, launcher data-path fixes, and packaging confidence without claiming complete parity for DM1, CSB, DM2, Nexus, or Theron's Quest beyond the evidence now covered. ## Highlights since v3.0.3 - **DM1 Hall of Champions coverage fills out the ordinal sweep**: new real-asset runtime probes cover more portrait routes across front entries, side entries, walkpaths, redraw-after-candidate flows, panel-open/cancel behavior, fullscreen scaling, HiDPI mouse mapping, transparent-pixel checks, and no-floating side-wall pixels. Ordinal 22 now has dedicated front and walkpath lanes instead of remaining only an indirect coverage note. - **Launcher data defaults corrected for real installs**: macOS and Linux now resolve game data from `~/.firestaff/data`, while Windows resolves beside the installed executable. The old `/tmp/firestaff-test-no-assets` path remains only as an explicit test fixture and is guarded by the portable filesystem probe. - **Asset scanner and launcher gates widened**: nested ZIP cache handoff, ISO/BIN duplicate-hash handling, data-dir cache invalidation, no-data popup behavior, and M12 language-cycle layout are now covered by focused tests or probes. - **Cross-game runtime evidence expanded**: the batch adds DM2 creature/save gates, Nexus DMDF and save-slot checks, Theron Track 02 and shop/progression gates, and DM1 V2 actual-render screenshot coverage. ## Verification - 174 commits ship on top of `v3.0.3`, including this release-prep commit. - GitHub Actions was green on `b9a9d8095` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, and cross-platform determinism. - Focused local verification before release prep included `git diff --check`, CMake configure, and targeted DM1 Hall of Champions probe builds/CTest runs with `--parallel 4`. - The release workflow rebuilds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts from the `v3.0.4` release commit. # Firestaff v3.0.3 Firestaff v3.0.3 packages the post-v3.0.2 hardening batch from 2026-06-23. It is a focused verification and launcher-polish release: more source-locked runtime gates, stronger data-status behavior in the launcher, and package builds for all supported desktop targets. It does not change the public game-status claims beyond the evidence now covered by tests and probes. ## Highlights since v3.0.2 - **DM1 Hall of Champions coverage expanded again**: new real-asset cancel/reopen portrait-rectangle probes cover additional champion ordinals, including row-2 C026 atlas cases. These gates verify the D1C portrait destination rectangle, panel reopen behavior, champion-count rollback, and stale side-wall pixel absence without claiming DOS pixel parity. - **DM1 V1 regression coverage widened**: focused CTest gates now cover intro/title skip cleanup, HiDPI chest-slot hit zones, open-pit transition chains, single-tick food/water warnings, door-bash no-open state, projectile/portcullis behavior, chest hand-swap and nested-container weight handling, C146 sleep/wake repaint, disabled champion-panel icons, and mana-bar repaint. - **CSB and DM2 gates added**: new checks cover CSB boot-to-first viewport readiness, save-runtime boundaries, DSA trigger bounds, DM2 projectile/creature collision, minimap persistence across level transitions, and door/button toggle boundaries. - **Launcher data UX hardened**: M12 now uses the scanned data-status value in settings, shows clearer scan feedback, retains popup focus context, covers extras mouse-hit flow, supports save-manifest export/import, and exposes manual docs from the launcher. - **Nexus/shared parser coverage improved**: the release includes bounded BPX/BPK archive parsing, S2D font render coverage, Greatstone row parser hardening, custom dungeon scanner gates, FTL container checksum parsing, CSB HTC hint-oracle parsing, and CSB Utility Disk AMG SND2 decoding. ## Verification - 52 commits ship on top of `v3.0.2`, including this release-prep commit. - GitHub Actions was green on `8566c5a2` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, and cross-platform determinism. - Focused local verification before release prep included `git diff --check`. The release workflow rebuilds and packages macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts from the `v3.0.3` release commit. # Firestaff v3.0.2 Firestaff v3.0.2 packages the 2026-06-23 DM1/CSB hardening batch on top of the v3.0.1 readiness release. The release is intentionally conservative: it promotes source-locked probes, launch-readiness verifiers, and public status wording without claiming finished parity for DM1 V1, CSB, DM2, Nexus, or Theron's Quest beyond the evidence now in CI. ## Highlights since v3.0.1 - **DM1 FTL swoosh intro fixed**: the launcher now unpacks the PC `SWOOSH` LZEXE file before extracting the logo, then decodes the source IMG2 stream and rejects false 320x200 matches. The animated FTL logo now uses the original silhouette instead of a corrupted filled frame. - **Hall of Champions probe coverage expanded**: new real-asset DM1 runtime gates lock additional champion portrait rectangles and redraw paths, including DAROOU/HALK ownership checks, ordinal 20-23 redraw probes, cancel/reopen behavior, and stale side-pose pixel absence. - **CSB launch-readiness verifier anchors refreshed**: the `csb_v1_m11_runtime_capture_boundary` and `pass547_csb_v1_runtime_readiness_backfill` gates now track the current `M12_StartupMenu_GetLaunchIntent()` source span after the supported-game/assets expression moved to line 7513. - **Public gap list refreshed**: `docs/FIRESTAFF_GAP_LIST.md` now records the 2026-06-23 Hall of Champions probe evidence, CSB anchor refreshes, focused queue progress, and current limits without exposing worker logs or failed-job counters as release copy. - **V1 inventory/status gate drift fixed**: the source-gate ranges were refreshed after code motion so the existing V1 inventory/status evidence is checked against the current source layout. ## Verification - 54 commits ship on top of `v3.0.1`, including this release-prep commit. - GitHub Actions was green on `fff924d0` before release prep: M10 verify, CMake build on macOS/Windows/Linux, strict warnings, asset hygiene, and cross-platform determinism. - Focused local verification before release prep included `git diff --check`, full CMake build, Phase A `23/23`, four Hall of Champions real-asset CTests `4/4`, V1 inventory/status gates `4/4`, FTL swoosh/source-animation CTests `3/3`, and the CSB launch-readiness verifier refreshes. - The release workflow builds the public macOS, Windows, Linux x86_64, and Linux ARM64 packages from the `v3.0.2` tag. # Firestaff v2.8.0 Nexus V2 smooth-movement tick (Phase 5) lands as a first-class feature in the V2 render pipeline, the strict-warnings CI matrix goes green, and a long-standing set of Theron V1 linker gaps is closed. 9 commits ship on top of v2.7.25; ctest baseline is 440/447 with the same 7 pre-existing parity-evidence line-drift failures and one missing test binary (`test_nexus_v2_lighting`) as the previous release. ## Development since v2.8.0 (2026-06-21) - **v3.0.0 release-prep version sync**: the launcher, changelog API, public version header, and CMake project version now agree on `v3.0.0` / `3.0.0`. The in-app changelog summarizes the DM1 pass1052-1070 gap cascade, Tier 1 strict boot-probe cleanup, V2.2 renderer/readback gates, and the current bounded remaining DM1 V2 screenshot/material work. - **Tier 1 #5 strict boot-probe per path** (`a84a9d42`, `033edf66`, `f3018e72`, `a736a04d`): new `firestaff_tier1_strict_boot_probe` ctest entry (`tier1_strict_boot_probe`, 90s timeout) runs the firestaff launcher with `--game <id> --data-dir <path> --duration 1500` under `SDL_VIDEODRIVER=dummy` for every EXTRACTED + VERIFIED path `--scan-data` marks READY, and asserts the per-game boot milestone (DM1 `LOADING DUNGEON`, CSB `CSB READY`, Theron `TQR level load: status=OK`). Current status: all present in-scope paths PASS (DM1 canonical, DM1 legacy-dos, CSB canonical, CSB Amiga 3.3 Meynaf FR, Theron JP canonical, Theron JP extras, and Theron US extras). The Theron US extras case exercises the new `M12_AssetStatus_GetFirstMatchedVersion` + first-matched-version fallback in `M11_GameView_OpenSelectedMenuEntry` so direct launch via `--data-dir` no longer fails when user-selected versionIndex doesn't match the supplied variant. Nexus (`Merged.iso::DM.BIN` / `Track 1.bin::DM.BIN` mount without extract step) remains out-of-scope and is tracked as a Tier 4 / diagnostic gap in `docs/FIRESTAFF_GAP_LIST.md` Section H + Section L1. Hash-fallback table in `m11_resolve_builtin_dungeon_path` extended with Nexus DM.BIN (`e88d6085...`) + Theron US Track 02 (`f2360110...`) for callers that resolve the dungeon path explicitly. - **Tier 2 #4 LZW Atari ST decoder** (`a736a04d`): gap-list entry previously marked PARTIAL with stale "BLOCKED-DATA" wording is now marked DONE. The decoder is in `src/dm1/dm1_v1_graphics_loader_pc34_compat.c` (`m11_gfx_lzw_decompress`), round-trip-tested via `test_dm1_lzw_round_trip.c` 8/8 PASS, and consumed by `src/csb/csb_v1_graphics_atari_st_loader_pc34_compat.c` for the CSB Atari ST GRAPHICS.DAT path. Source-locked to ReDMCSB `LZW.C F0495_GetNextInputCode`, `G0666 max=4096`, 12-bit codes. - **DM1 24h readiness roll-up** (`tools/dm1_24h_readiness.py`): continues to report PASS — DM1 is the strongest playable target today, with Firestaff-side route, collision, pairing, keypad, playable-route, closed-door, Phase A, and V1/V2 seed gates inside the roll-up. Original-vs-Firestaff capture rows remain bounded evidence work rather than broad parity claims; see `parity-evidence/verification/dm1_24h_readiness/manifest.json` for the per-criterion breakdown. ## Headline features - **Nexus V2 render-pipeline smooth-movement tick (commit `7ca73871`)**: `Nexus_V2_RenderPipeline` now owns a `Nexus_V2_SmoothState`, `nexus_v2_pipeline_init()` calls `nexus_v2_smooth_init()` and logs the `smooth_movement` mode, the new `nexus_v2_pipeline_tick(pipe, game_x, game_y, game_angle)` records raw V1 game state per tick (55ms) and auto-triggers walk/turn animations on position/angle deltas, and `nexus_v2_pipeline_render()` derives the camera position and angle from the smooth state when `smooth_movement` is enabled and falls back to the raw V1 state otherwise. The render signature changed from explicit `(cam_x, cam_y, cam_z, cam_dir)` to `(game_x, game_y, game_angle)` so the pipeline contract is explicit that interpolation is owned by the pipeline, not the host. Builds clean in Release and Debug with zero warnings. ## Build and CI health - **Strict-warnings CI matrix goes green (commit `47f7bb8c`)**: silenced 270+ Clang and GCC warnings across all targets so the `-Wall -Wextra -Werror` matrix on `macos-14`, `ubuntu-24.04`, and `windows-2022` stays clean. Categories fixed: - `-Wunused-variable / -Wunused-const-variable / -Wunused-parameter / -Wunused-but-set-variable / -Wunused-local-typedef` (documentation arrays, stub function bodies, four leftover `AssetMd5*` typedefs in `csb_v1_runtime_pc34_compat.c`). - `-Wswitch` for the 10 CSB-specific view-square cases in `dm1_v1_viewport_3d_pc34_compat.c` (D3L2/D3R2/D2L2/D2R2 macros), applied via `set_source_files_properties` to avoid offsetting the line counter that parity-evidence source-lock verifiers pin. - `-Wcomment` for two missing `*/` closings in `memory_creature_ai_pc34_compat.c` and the DM1 special-square interaction probe, plus two nested-`/*` cases in `cloud_sync_m12.h` and the launcher menu text. - `-Wincompatible-pointer-types-discards-qualifiers` for the const-mismatch on `F0735_COMBAT_ResolveChampionMelee_Compat` (declaration in `memory_combat_pc34_compat.h` was wrong — the function mutates `statisticLuck`) and the 3 Theron viewport call sites that passed a const leader to a non-const accessor (switched to the existing `_c` variants of `theron_v1_party_leader` / `theron_v1_party_getChampion`). - `-Wmissing-field-initializers` for `g_config.source_light_floor` on `DM2_V2_AssetPipelineConfig` and `CSB_V2_AssetPipelineConfig`. - `-Wsign-compare` in `theron_v1_dungeon_progression_test.c`. - CMake `-Wno-maybe-uninitialized` and `-Wno-restrict` are now guarded behind `CMAKE_C_COMPILER_ID STREQUAL "GNU"` so Clang and MSVC do not warn about unknown warning options. - Verification: Release and Debug builds both produce zero code warnings and zero errors; ctest reports the same 7 pre-existing failures (parity-evidence line-drift from prior watchdog passes, not caused by this commit). - **Theron V1 linker gaps closed (commit `0d3f0cf5`)**: three pre-existing linker gaps exposed by the unified `firestaff` binary build are closed. Test binaries that previously linked against the wrong helper lib now resolve the Theron static library symbols directly. `DONE.md` and `TODO.md` are refreshed in the same commit. ## Notes for packagers and downstream users - `Nexus_V2_RenderPipeline` API change: `nexus_v2_pipeline_render` callers must pass `(game_x, game_y, game_angle)` instead of the previous `(cam_x, cam_y, cam_z, cam_dir)`. The pipeline now interpolates the camera from the raw V1 game state. Hosts that want a non-interpolated render can pass the same V1 state on every tick; the pipeline falls back to the raw state when no smooth-movement animation is active. - All five supported games (DM1, CSB, DM2, Nexus, Theron's Quest) build and run on macOS (arm64, x86_64), Windows x86_64, Linux x86_64, and Linux arm64. Original game data files are not included in the packages. - The 7 pre-existing ctest failures listed in `TODO.md` → Cross-Cutting → Build and CI Health are parity-evidence line-drift and a missing test binary, not caused by this release; they will be addressed in a follow-up. # Firestaff v2.7.25 DM1 V1 Group 8 (functional-divergence-report.md) bounded-fix batch. 4 commits land 4 Group 8 items as source-locked regressions tests or runtime helpers; CSB launch path verified end-to-end. ## DM1 V1 Group 8 fixes (this release) - **CHM-04 (Minor → Fixed)**: F0319_CHAMPION_Kill auto-close-chest ordering. New runtime helper `m11_inventory_chest_auto_close_on_leader_death_pc34_compat_run` drives the F0319 → F0355 → F0334 → F0318 chain against a live M11_InventoryState. Source-locked to ReDMCSB CHAMPION.C:1552-1607, PANEL.C:2244-2310, CHEST.C:79-130, CHAMPION.C:1527-1551. Test: `m11_inventory_chest_auto_close_on_leader_death_pc34_compat` (3 scenarios, all PASS). - **MOV-05 (Major → Fixed with bounded approximation)**: F0284_CHAMPION_SetPartyDirection cell-rotation. New public `F0284_CHAMPION_SetPartyDirection_Compat` rotates Direction + Cell (per-present-list mapping, empty slots preserved) and tracks activeChampionIndex. 13/13 test scenarios PASS. Source-locked to ReDMCSB CHAMPION.C:117-130. Bounded approximation: uses slot-position as cell proxy; a full fix would add a `cell` field to `ChampionState_Compat` (structural change tracked separately). - **MOV-06 (Minor → Fixed for V2)**: F0316/F0317 scent add/delete compat stub for the V2 presentation path. New `M11_ChampionScentRing_Compat` (16-slot bounded ring) plus `m11_champion_scent_ring_add` (F0317) and `m11_champion_scent_ring_delete` (F0316). 11/11 test scenarios PASS. Source-locked to ReDMCSB CHAMPION.C F0316+F0317. - **DUN-01 (Minor → Pin)**: F0150_DUNGEON_UpdateMapCoordinates step-delta source-lock pin. Pins `F0701_MOVEMENT_GetStepDelta_Compat` against the F0150 source-locked G0233/G0234 tables (DUNGEON.C:1318-1338). 7/7 test scenarios PASS. No source change — freezes the invariant so the two parallel implementations cannot drift. ## CSB launch verification End-to-end check confirms CSB starts correctly from the startup menu (and via `--game csb` direct-launch): ``` $ firestaff --scan-data ... Chaos Strikes Back READY GRAPHICS.DAT FOUND /Users/bosse/.firestaff/data/csb/GRAPHICS.DAT DUNGEON.DAT FOUND /Users/bosse/.firestaff/data/csb/DUNGEON.DAT ... ``` Test regressions: - `csb_v1_required_complete_launches` PASS (launches when required files complete, reaches boot runtime boundary) - `csb_v1_boot_runtime_handoff` PASS (V2 profile labels don't alter V1 runtime handoff) - `csb_v1_boot_viewport_render_gate` PASS (224x136 viewport region, column-major thing data preserved) - `csb_v1_boot_profile_smoke` 51/51 PASS - `csb_v1_launch_blocker_m12` PASS (no bypass of missing-data gating — safety test) CLI: `firestaff --game csb --menu --duration 1000` opens the M12 menu with CSB highlighted, then `firestaff --game csb` direct-launches without the menu. ## Test regressions (this release) - DM1 V1 critical suite: 11/11 PASS (creature_ai_behavior, magic_thieves_eye, champion_needs, f0128_viewport, f0306_stamina, savegame_native_export, hall_of_champions, f0192_projectile, monster_poison_cloud, etc.) - Phase A probe: 23/23 invariants PASS - m12_extras_views_smoke: PASS (7s) - m12_extras_views_visual_capture: subtitle text verified in all 3 views (95/91/181 white px) - csb_v1_champions_left_click_inventory: PASS (10/10) - firestaff_po_loader_multi_domain: PASS (7/7) - m11_inventory_chest_auto_close_on_leader_death: PASS (3/3) - m11_champion_scent: PASS (11/11) - dm1_v1_mov05_f0284_cell_rotation: PASS (13/13) - dm1_v1_dun01_f0150_f0701_step_delta: PASS (7/7) - csb_v1_boot_profile_smoke: 51/51 PASS ## Commits (this release) - 9fd532d1 fix: DM1 V1 F0319_CHAMPION_Kill chest auto-close-on-leader-death runtime helper (CHM-04) - 02220c53 feat: DM1 V1 F0316/F0317 scent add/delete compat stub for V2 path (MOV-06) - fb43647c feat: DM1 V1 F0284_CHAMPION_SetPartyDirection cell-rotation invariants (MOV-05) - b94f4c17 test: DM1 V1 DUN-01 F0150/F0701 step-delta source-lock pin (Group 8) # Firestaff v2.7.24 DM1 V1 i18n / l10n expansion release — fixes the silent truncation of DM1 strings on load, adds a multi-domain PO loader so dm1, csb, and startup-menu catalogs can co-exist, and ships 17 new DM1 translation catalogs ready for translator fill-in. ## DM1 i18n / l10n - **firestaff_po_loader FS_PO_MAX_STRINGS 128 → 1024**: DM1 ships 548 `msgid` strings in `po/dm1.pot`. The previous 128-entry limit silently dropped 420 of them. Now all 547 non-empty entries in `po/dm1.sv.po` load, verified with `"NORTH"` → `"NORD"`, `"STAIRS"` → `"TRAPPA"`, `"NO FOCUS"` → `"INGET FOKUS"`. - **Multi-domain PO loader**: each domain (`dm1`, `csb`, `dm2`, `startup-menu`, `firestaff`, `nexus`) now loads into its own slot (`FS_PO_DOMAIN_COUNT=8`) so callers can co-load `dm1+csb+startup-menu` catalogs without one overwriting the other. New API: `fs_po_gettext_in_domain(domain, msgid)`, `fs_po_set_active_domain(name)`, `fs_po_get_loaded_count_in_domain(name)`. Path → domain auto-derivation (`po/dm1.sv.po` → `dm1`). - **17 new `po/dm1.<lang>.po` catalogs** (de, fr, es, it, pt, nl, pl, cs, ru, ja, ko, zh, da, no, fi, hu, tr) generated via `msginit -i po/dm1.pot -l <lang> --no-translator`. All carry the full 548-msgid template with empty `msgstr` so the runtime falls back to the English source string. Translators can now fill `msgstr` incrementally. - **`m11_game_view.c` language picker** now tries a 19-language candidate list (`po/dm1.<lang>.po`) and picks the first that exists, instead of hard-coding `sv` then `en`. This means DM1 strings now translate on the fly in FR/DE/JA/ZH (and 13 other locales with empty translations) the moment a translator publishes a `dm1.<lang>.po` with non-empty `msgstr` entries. - **Regression test** `test_firestaff_po_loader_multi_domain_pc34_compat` verifies cross-domain isolation, active-domain switching, pass-through on missing keys, and the legacy `fs_po_load_for_language` API. 7/7 CHECKs pass. ## Test fixes - **`test_dm1_v2_launch_smoke_pc34`** and **`test_csb_v2_resolution_selector_gate_m12`**: the V2.1/V2.2 "auto-bump" from 320×200 to 640×400 was intentionally removed (it broke `INV_M12_18` by pre-empting the row cycle). Both tests now expect the 320×200 user-chosen value to stay as-is, matching the current design. # Firestaff v2.7.14 DM1 V1 source-lock and CSB V1 bounded-gap release — closes 6 DM1 V1 v1-simplifications documented in v2.7.13, fixes 2 pre-existing test regressions, and adds 3 CSB V1 implementations (NEOPHYTE rank, projectile speed normalization, reincarnation penalty). ## DM1 V1 parity work - **F0308 CHAMPION_IsLucky** (CHAMPION.C:1123-1155): the 50% short-circuit, luck×2 roll, ±2 bounded update, and BUG0_38 negative-luck path are now implemented. Wired into the dex-duel via a new `luckyHit` field on CombatResult_Compat. - **F0202 FAKEWALL non-material pass** (GROUP.C:1503-1505): added `adjacencyFakeWallMask` + `adjacencyFakeWallOpenMask` to CreatureTickInput_Compat. F0798 now correctly opens the door for FAKEWALL with the OPEN or IMAGINARY+allow bits. - **F0229 cell ordering** (PROJEXPL.C:1284-1305): the per-primaryDir cell permutation table `kCellOrder[4][4]` is now consulted; the F0228 visibility parity flip (CellSource + 1 when LoS is blocked) is honoured. - **C80..C83 magic-map per-champion counters** (CHAMDRAW.C:1069): added `magicMapRefresh[4]` to ChampionLifecycleState_Compat. The C80..C83 timeline handler decrements the counter and reschedules the next refresh. - **Teleporter direction rotation** (PROJEXPL.C:1260-1310): the digest's `destTeleporterNewDirection` is now populated from the destination square's first THING_TYPE_TELEPORTER rotation when entering a teleporter. - **Kinetic pass-through** (PROJEXPL.C:490-500): `launcherStrength` added to ProjectileInstance_Compat; F0816 now rolls `M002_RANDOM(100) < launcherStrength` for KINETIC projectiles. - **F0321 fire/spell shield subtraction** (CHAMPION.C:1880-1882): F0321 C1 and C5 cases subtract `defender->partyShieldDefense` after the F0307 statistic adjustment. Bounded to 0. - **F0321 C6 wisdom factor** (CHAMPION.C:1908-1932): the F0762 psychic adjustment now correctly sources `champ->statisticWisdom` (was passing `magic->luckCurrent`). - **F0822 poison cloud group damage** (PROJEXPL.C:858-866): removed the F0192 over-scaling; the call site now passes `attackApplied` straight through to F0191 (which does the resistance adjustment internally). - **Trolin F0823 anti-mage palette**: added the `DM1_CREATURE_TYPE_TROLIN` case to F0823 — 50% FIREBALL, else LIGHTNING_BOLT / HARM_NON_MATERIAL / OPEN_DOOR 3-way split. Note: Trolin's AttackRange=1 (DUNGEON.C G0243[16]) makes F0823 a no-op for melee — the anti-mage palette is wired but inert. - **DM_SAVE_HEADER Noise[]/Keys[]/Checksums[]** (SAVEHEAD.C:44,97,104): added `noise[10]`, `sectionKeys[16]`, `sectionChecksums[16]` to SaveGameHeader_Compat. F0417_SAVEUTIL_Port_Hint_Compat derives 16 per-section XOR keys via FNV-1a fold; F0417_SAVEUTIL_GetChecksumAndObfuscate_Compat runs a minimal XOR pass. Full CPSC checksum derivation deferred to post-M10. ## DM1 V1 documentation - **29 NEEDS DISASSEMBLY REVIEW markers** replaced with precise ReDMCSB source citations (CHAMPION.C, GROUP.C, PROJEXPL.C, MOVESENS.C, etc.). Each marker now points to the exact function name, file, and line range so disassembly confirmation can be tracked against the ReDMCSB decompilation. ## Test infrastructure - **Hall of Champions 4-mirror zones** (60/60 PASS): pixel-proves that all 4 endgame champion mirrors are drawn at the source-locked C412..C415 destinations with correct portrait cutouts, name origins, and 48px row pitch. - **Hall of Champions wall-mirror zones** (18/18 PASS): pixel-proves the D1C champion mirror on the (1,3) and (1,4) wall routes — wall ornament box at (96, 36, 32, 28), portrait cutout at (96, 35, 32, 29), 100% / 97% pixel match, no bleed. - **Hall of Champions panel-guard probe** (5/5 PASS): real pixel-probe for the BUG-120/121 panel-active guard via D1C zone diff (2961 bytes when panel is on, portrait still 1024 pixels). - **M12 extras view smoke probe + visual capture** (11/11 PASS): Bestiary, Item Encyclopedia, and Screenshot Gallery render non-trivial framebuffers. - **F0827/F0828 launcherStrength** fix: serialiser now writes the new field at the right slot (25 fields total, 100 bytes — was 24 fields / 96 bytes, causing the world-hash to fail). Brought test_m11_inventory_full_panel from 21 sub-failures down to 2 (panel-render bleeds, pre-existing and not related to this fix). - **M11_GameView_HandlePointer** now refreshes `lastWorldHash` on every REDRAW-returning click so the inventory test's deterministic world-hash assertions see the post-click snapshot. ## CSB V1 bounded-gap implementations - **Champions GAP 1 — NEOPHYTE rank** (PANEL.C:26, CEDT006.C:141, Character.cpp:665): added `csb_v1_neophyte_skills_mode_get/set` and `csb_v1_neophyte_display_for_level` helpers. m11_dm1_v1_skill_level_name_pc34 now returns "NEOPHYTE" for level 0 in CSB mode (was returning NULL for level <= 1, making both NEOPHYTE and NOVICE display as empty). 8/8 PASS. - **Combat GAP 1 — Projectile Speed Normalization** (PROJEXPL.C CHANGE7_20): added `csb_v1_projectile_speed_normalization_get/set` flag. F0825 uses delay=1 on every map when CSB mode is on (was delay=1 on party map, 3 on other maps in DM1). 7/7 PASS. - **Champions GAP 2 — Reincarnation Penalty** (CSB:REVIVE.C CHANGE7_24, Character.cpp:14): added `csb_v1_reincarnation_mode_get/set` plus 3 globals (attributePenalty=2, statPenalty=8, randomPoints=3). F0610_PARTY_AddChampionFromMirrorTextString applies the penalty in place when the mode is on — HP/STA/MANA halved, each non-Luck stat reduced by attributePenalty, clamped to 0. 16/16 PASS. ## Verification - Full CMake build: 0 errors - Phase A probe: 23/23 invariants - CSB V1 gates: 31/31 PASS (8 neophyte + 7 projectile-speed + 16 reincarnation) - DM1 V1 wall-mirror zones: 18/18 PASS - DM1 V1 endgame 4-mirror zones: 60/60 PASS - DM1 V1 panel-guard: 5/5 PASS - test_dm1_v1_combat_pc34_compat_integration: 31/31 PASS - test_dm1_v1_projectile_explosion_render_pc34_compat: PASS - Pre-existing failure unchanged: `m11_inventory_full_panel_runtime_source_lock` has 2 panel-render bleed failures in C025 open-chest transparency (root cause: C025 red-transparency path; documented in docs/FINAL_GAPS.md Group 4). ## Known gaps - DM1 V1: 2 panel-render bleed sub-tests in test_m11_inventory_full_panel_runtime (CHEST.C F0333 red-transparency path; not closed in this release). - DM1 V1: BUG-106 (creature flee F0201 negated direction), BUG-108 (light amount table G0039 16-entry), BUG-109 (champion stat gain F0303 cycle), BUG-111 (sub-cell hit mask), BUG-116 (runtime dynamics adjacency). Documented in docs/FINAL_GAPS.md Group 3. - CSB V1: 24 of 27 implementation gaps remain (see docs/FINAL_CSB_GAPS.md). 3 bounded gaps closed in this release (NEOPHYTE, projectile speed, reincarnation). - DM2 / CSB / Nexus / Theron: separate milestones, not parity targets for this release. --- ## v2.7.13 (previous release, kept for reference) DM1 V1 combat fidelity and bug audit release — systematic audit of the DM1 V1 runtime against the ReDMCSB decompilation with targeted fixes for the highest-impact issues. ## Fixes - **Armor defense overhaul:** Replaced the simplified skill-level armor approximation with a proper ReDMCSB F0321 wound defense calculation that iterates equipped armor slots, applies per-slot defense values with G0050 wound defense factors, and scales attack by (130 − avgDefense) / 64. - **Fire/Spell Shield defense:** Fire Shield and Spell Shield spells now correctly reduce incoming damage. Fire attacks subtract FireShieldDefense before armor scaling. Magic attacks subtract SpellShieldDefense and skip armor scaling (matching F0321's goto T0321024). Psychic attacks skip armor scaling entirely. - **Creature poison:** Creature melee attacks now apply poison when the creature has a non-zero poison attack value, with a 50% chance per hit and vitality-adjusted damage via F0307. - **Luck and stamina adjustments:** F0308-style luck bias now influences melee hit/miss at the damage dispatch boundary, and the F0306 stamina-adjusted value compiler order hazard is routed through a single helper. - **Creature AI promotion:** 7 creature types promoted from STUB to FULL tier with per-type behaviour bias: Giant Scorpion (C00, poison sting), Giggler (C02, steal-then-flee), Screamer (C06, cowardly group-fleer), Vexirk (C14, ranged magic), Magenta Worm (C15, 30pt venom), Animated Armour (C18, cursed fixed drops), Red Dragon (C24, flame stream). 10 of 27 types now FULL. - **Combat mechanics:** Creature attack target ordering respects F0229 direction weighting. Creatures below HP threshold can now flee. Projectile sub-cell hit mask narrows from 0xFF to the actually-targeted sub-cell. C6_PSYCHIC damage type applies from the spell descriptor. - **Source-locked tables:** Thieves Eye duration uses the F0394 interval table. Light amount uses G0116 graphic559 light factors. Champion stat gain cycle uses F0303. Magic map is per-champion tracked. Runtime dynamics table uses the exact timing constants. - **Savegame field mask:** Bit layout now matches LOADSAVE.C for all champion fields. - **Test infrastructure:** Added FIRESTAFF_BUILD_DIR environment variable support to Python verification scripts for out-of-tree builds. - **Viewport readiness:** The pass434 viewport crop readiness gate is now wired to the pass610 wall-collision runtime capture evidence path. - **DM1 V1 audit divergence observability (MNU-02, DUN-05, PJE-05):** Three ReDMCSB-original divergence sites that were previously silent defensive divergences are now observable. - **MNU-02 (F0757 Thieves Eye duration):** Default is source-locked 0 ticks (the original PC 3.4 broken-by-uninitialised-stack-residue behaviour). Opt-in to the defensive envelope (`spellPower * 40`, 64-224 s) via build flag `-DFIRESTAFF_PC34_LEGACY_THIEVES_EYE=1` or env var `FIRESTAFF_DM1_THIEVES_EYE_LEGACY=1`. - **DUN-05 (F0163 BUG0_08 SFT overfill):** A new `F0502b_DUNGEON_CheckBug0_08SftOverfill_Compat` helper runs at dungeon load. If a hand-crafted or modded dungeon contains more thing-bearing squares than the SFT buffer can hold, a one-shot warning is emitted to stderr with the overfill count. Defensive behaviour is preserved. - **PJE-05 (F0220 BUG0_16 projectile list overfill):** `F0810_PROJECTILE_Create_Compat` now emits a one-shot stderr warning when the per-dungeon projectile list is full and the overflow is dropped. Cap behaviour unchanged. - See `docs/dm1-v1-functional-divergence-report.md` for full audit context. ## Bug Audit A comprehensive bug audit document is now available at `docs/DM1_V1_BUG_AUDIT.md` covering 18 identified issues across mechanics, rendering, data, and testing categories. ## Verification - Full CMake build passed with zero errors. - Phase A probe passed 23/23 invariants. - `git diff --check` clean. --- # Firestaff v2.7.12 Patch release focused on the post-v2.7.11 DM1 V1 hardening batch. ## Fixes - Added the original-DOS in-dungeon movement capture route using VGA mode, no sound, keyboard simulation of digital joystick, and source-locked Keypad-5 movement after dungeon entry. - Expanded DM1 V1 viewport source-lock coverage across additional F0108, F0111, and F0115 wall, door, side-wall, ornament, stairs/pit, and thing-pass slices. - Hardened DM1 V1 chest, mirror-candidate, champion-panel, door-bash, sleep/wakeup, projectile, creature, and inventory runtime regressions. - Fixed the newest D1L/D1R viewport-gate release wiring before packaging. ## Verification - GitHub Actions verify workflow passed on `main` at `ed244b866` before release prep. - Local release-prep verification passed: full CMake build, focused DM1 viewport/runtime gates, Phase A probe, and `git diff --check`. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.11 Patch release for DM1 V1 regressions reported after v2.7.10. ## Fixes - Fixed Hall of Champions movement/survival timing so champions no longer drain or die while walking the Hall. - Fixed mirror-candidate slot ownership during confirm/cancel and saved the runtime movement timestamp in quick-resume sidecars. - Reduced normal gameplay CPU load by making the disk-backed accessibility manifest opt-in instead of writing it every frame. - Corrected the FTL/SWSH PC palette mapping and made palette mutations visible immediately, restoring the intended swoosh cadence and colors. - Corrected the Dungeon Master title palette base so the DM title animation uses the PC 3.4 palette instead of a blacked-out fallback. ## Verification - Full local CMake build completed. - Focused Hall/mirror/title/swoosh/starvation/quick-resume CTest suite passed 90/90, then the post-fix runtime subset passed 11/11. - Direct dummy-driver runtime probes passed for Hall walkaround and champion mirror walk-path using local DM1 data. - Phase A probe passed 23/23 and `git diff --check` passed. --- # Firestaff v2.7.10 Patch release focused on the large DM1 V1 hardening batch after v2.7.9. ## What's New - Expanded DM1 V1 source-lock and pixel coverage across additional viewport front, side, door, wall-ornament, floor, ceiling, pit, teleporter, and thing-pass paths. - Hardened DM1 V1 runtime behavior around chests, mirror-candidate handoff, champion-panel routing, projectiles, creatures, poison clouds, fake walls, teleporters, keyholes, pits, fountains, skill progression, food/water timing, and Vi altar resurrection. - Tightened the original-capture workflow with DOSBox rawshot fallback, rawshot freshness checks, single-row transcript validation, and 320x200 plus viewport-crop guards. - Kept the public release scope honest: this packages a broad DM1 V1 parity/regression step, while CSB, DM2, Nexus, and Theron remain active hardening targets. ## Verification - GitHub Actions verify workflow passed on `main` before release prep. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.9 Patch release for two DM1 launch regressions found in v2.7.8 on MacBook Pro. ## Fixes - Fixed Entrance door buttons on Retina/HiDPI macOS displays by keeping SDL3 pixel-size events separate from logical mouse coordinates. - Fixed the FTL/SWSH swoosh cadence by matching ReDMCSB's immediate `Setcolor()` batching and `DBF` VBlank wait semantics. ## Verification - Local high-DPI presentation/mouse mapping regression passed. - Local SWSH source-animation timing gate passed with 30 effective palette VBlanks. - Local Entrance button click runtime probe passed 17/17. - Local Phase A probe passed 23/23. --- # Firestaff v2.7.8 Patch release focused on DM1 V1 viewport, inventory, mirror-candidate, and CSB V1 source-lock/runtime hardening after v2.7.7. ## What's New - Added DM1 V1 source-lock coverage for D1L2/D1R2, D3L2/D3R2, D2L2/D2R2, D0L2/D0R2, and D0C viewport floor, ceiling, ornament, door-front, and thing-pass paths. - Hardened DM1 V1 inventory and mirror-candidate runtime behavior around occupied-slot swaps, scroll pickup/drop, C040 panel-live handoff, reshuffle, cancel, candidate-close, and non-leader routes. - Expanded CSB V1 viewport/runtime evidence for D1L2/D1R2 and D2C/D0L2/D0R2 door, floor, ceiling, CustomBackgrounds, movement-command, and command-chain behavior. - Kept the public status honest: these are source-lock and regression-hardening slices, not new claims of finished CSB/DM2/Nexus/Theron end-to-end parity. ## Verification - GitHub Actions verify workflow passed on `main` at `cf0501377` before release. - Local focused pass712/pass713/pass714/pass715 gates and Phase A probe passed before release prep. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.7 Patch release focused on DM1 V1 viewport, inventory, champion-panel, and runtime regression hardening after v2.7.6. ## What's New - Expanded DM1 V1 source-lock and pixel coverage for viewport side walls, stairs/pit dispatch, floor/ceiling fallback, door fronts, wall ornaments, champion mirror paths, and projectile side-cell behavior. - Hardened DM1 V1 inventory and champion-panel behavior around chest routing, close/reopen edges, pickup/swap paths, mirror-candidate handoff, hand-slot priority, held-item icons, portraits, wounds, and stale-pixel redraws. - Locked V2.0 filtered presentation to a 640x400 2x runtime surface across games while preserving original 320x200 game/input coordinates. - Added selectable V2.1/V2.2 presentation resolutions from 640x400 through 3840x2160, with launch intent and M11 input mapping preserving original 320x200 gameplay coordinates. - Added a DM1 V2 side-by-side manifest pixel gate for full V1/V2 lanes plus D1C wall and portrait regions, keeping enhanced-presentation diffs anchored to source-locked V1 rectangles. - Wired Theron's Quest direct launch so M11 can consume the launcher catalog's hash-verified Track 02 path/MD5 without re-walking the game-data root. - Added focused runtime gates for spell-rune preservation, poison/cloud timing, room-transition pickup ordering, delayed timeline saves, keyhole no-op behavior, and audio pack frame bounds. - Added cross-game regression coverage for CSB viewport/import/chaos/optional-asset paths, DM2 save/weather/projectile behavior, Nexus palette/DGN bounds/save validation, and Theron launch/progression/shop/transition state. ## Verification - GitHub Actions verify workflow passed on `main` at `8cc26c5aa` before release. - Local release-prep CMake build, Phase A probe, and audio probe passed before tagging. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.6 Patch release focused on DM1 V1 inventory-panel source-lock hardening after v2.7.5. ## What's New - Added a 176-assertion DM1 V1 inventory-panel regression gate for status-row hand-slot routing. - Proved that status hand slot boxes 0..7 resolve to the intended champion and source slot without falling through to the inventory swap path. - Added coverage for dead champions, candidate champions, open inventory champions, out-of-party slots, null health state, and per-champion mouse-item routing. ## Verification - Local focused inventory-panel route gate passed before tagging. - Local Release build, Phase A probe, and audio probe passed before tagging. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.5 Patch release focused on DM1 launch regressions reported in v2.7.4 on macOS. ## Fixes - Restored the initial FTL/SWSH animation when DM1 data is stored in the normal nested data-directory layout. - Restored the source-locked Dungeon Master TITLE animation palette steps for PRESENTS, DUNGEON and MASTER phases. - Fixed Entrance door button clicks when the macOS window size changes outside Firestaff's cached resize path. - Made the new SWSH pathfinder regression test portable on Windows. ## Verification - GitHub Actions verify workflow passed on `main` at `b330682d`. - Local focused gates passed: SWSH pathfinder, TITLE step palette, Entrance button click probe, Phase A and audio probe. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64 and Linux arm64 artifacts. --- # Firestaff v2.7.4 Patch release focused on DM1 V1 viewport, panel, and capture-route regression hardening after v2.7.3. ## What's New - Added focused DM1 V1 runtime and pixel probes for champion mirror visibility, mirror Z-order, chest compact-close edges, D2L side-wall rendering, capture-route smoke coverage, and champion panel bounds. - Expanded DM1 V1 viewport evidence around side-wall drawing, wall inscriptions, and small-scale window layout. - Kept the latest DM1 V1 presentation and panel hardening in the release packaging path. ## Fixes - Fixed the legacy small-scale window layout regression. - Fixed DM1 V1 side-wall drawing drift and wall inscription source-font rendering. - Slowed title frontend cadence back to the V1 tick path. - Cleared stale Firestaff queue failed probes and made the CSB DSA probe mkdir path portable. ## Verification - GitHub Actions verify workflow passed on `main` at `3fe79467`. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.3 Patch release focused on regression coverage, cross-platform test harness fixes, and verified release packaging after v2.7.2. ## What's New - Added narrow no-game-data regression coverage for DM1, CSB, DM2, Nexus, Theron, M11 overlay input, accessibility manifest output, save-browser behavior, and M12 data-directory cancel handling. - Added Phase A coverage for M12 no-data asset-status scans, including null-safe calls, empty roots, stale-path clearing, and deterministic repeated scans. - Expanded asset-status scanner coverage for irrelevant data roots, partial required-data matches, archive-backed required files, and required-file accounting. ## Fixes - Fixed Windows test harness portability for `stat` and temporary-directory helpers. - Fixed static-library link ordering for M11/M12 test harnesses on ELF linkers. - Preserved launch/profile identity diagnostics while keeping required-file launch gates blocked when data is incomplete. ## Verification - GitHub Actions verify workflow passed on Ubuntu, macOS, and Windows. - CMake build, strict warnings, Phase A, audio smoke, and cross-platform determinism passed on `main`. - Release workflow builds and packages macOS arm64/x86_64, Windows x86_64, Linux x86_64, and Linux arm64 artifacts. --- # Firestaff v2.7.2 Patch release focused on game-data discovery, launch gating, real-asset runtime handoff, and regression cleanup after v2.7.1. ## What's New - Recursive hash-based game-data discovery now covers nested folders, stored ZIP entries, deflated ZIP entries when zlib is available, and ISO/BIN ISO 9660 data images. - Archive-backed DM1, CSB, and DM2 required files can be materialized into the Firestaff asset cache before launch, while runtime code continues opening ordinary `GRAPHICS.DAT` and `DUNGEON.DAT` paths. - The start menu now wires data-directory availability into game cards and reports missing required game data with user-facing OK popups. - Theron's Quest now recognizes JP Rev 1 and US Track 02 ISO variants and can route direct launches into the native M11 Theron boot/world/viewport path. ## Fixes - Fixed DM2 save/load SUPPRESS masks and version detection. - Fixed DM2 PC English GRAPHICS.DAT container loading and real DUNGEON.DAT parser probes. - Fixed CSB PC 3.4 FTL-compressed DUNGEON.DAT ingestion in the V1 loader. - Fixed DM1 V1 viewport floor-ornament/stair, front-wall depth, and pit floor-ornament BUG0_64 regression gates. - Fixed M11 inventory scroll-panel and mouth-visual source-lock gates on configured macOS data roots. - Fixed CSB V2 Phase 7 and CSB/DM2 V2 smooth-movement verification regressions. - Fixed `turn_viewport_orientation_probe` so it exits cleanly after writing artifacts. ## Verification - GitHub Actions verify workflow remains the release gate on `main`. - Relevant local regression gates passed: DM1 viewport, M11 inventory, CSB V2 Phase 7, CSB V2 smooth movement, DM2 V1 asset/dungeon/save probes, and CSB V1 dungeon load gate. - Phase A probe remains green. --- # Firestaff v2.7.1 DM1 PC-34 boot-sequence fidelity release. ## Fixes - Added hash recognition and direct runtime launch support for the JP Rev 1 and US Track 02 ISO variants of Theron's Quest. - Fixed direct launch version selection so hash-matched game data can launch even when the default menu version slot points at a different known variant. - Kept the DM1 TITLE/entrance sequence on the DM1 launch path only, allowing Theron's Quest to enter its own Track 02 runtime handoff directly. - Restored ReDMCSB SWSH/FTL logo playback before the DM1 TITLE sequence. - Fixed SWSH `SWOOSH` loading when the original file is a DOS/MZ program with the IMG logo payload embedded inside it. - Fixed the SWSH palette path so the FTL logo starts black and lights up via the ReDMCSB `Setcolor()` command sequence instead of using the TITLE palette. - Kept the GRAPHICS.DAT `C001_GRAPHIC_TITLE` path on the same final guard timing as the TITLE.DAT fallback. - Replaced hardcoded entrance-door delays with source-locked ReDMCSB vblank timing. ## Verification - SWSH, TITLE, and entrance source-lock gates passed locally. - Phase A probe: 21/21 invariants passed locally. --- # Firestaff v2.7.0 Major V2 pipeline completion across all game systems, Theron V1 rendering pipeline, DM1 V1/V2 Phase 8 completion, and accessibility improvements building on the v2.6.0 release. ## What's New ### CSB V2 — Phase 0–6 Complete - **Phase 0**: V1 compatibility lock.13 domain compile gates (`CSB_V2_PHASE_DOMAIN_*`), stub hooks for all V2-only functions, C11 `_Static_assert` for V1 struct sizes. Source-lock: COMMAND.C, DUNGEON.C, CSBWin champion/resurrect. - **Phase 1**: Launch/profile separation with compile gates and CSB-hash-katalog (DUNGEON.DAT `6695d2a`, GRAPHICS.DAT `61fbfd5`). LAUNCH-before-PROFILE pattern enforced. Source-lock: ENTRANCE.C F0806, PROFILE.C F0401. - **Phase 2**: Enhanced asset pipeline. - **Phase 3**: Enhanced UI overlays — HUD overlay scaffolding. - **Phase 4**: Stairs animation for smooth movement + runtime hardening. - **Phase 5**: Stairs animation + runtime hardening. - **Phase 6**: Touch controller test coverage and affordances. ### DM2 V2 — Phase 1–6 Complete - **Phase 1**: Launch/profile phase gate, probe, and CMake wiring. - **Phase 2**: Enhanced asset pipeline. - **Phase 3**: HUD overlay hardening. - **Phase 4**: Enhanced lighting, outdoor FX, torch flicker, fog animation. - **Phase 5**: Smooth movement runtime integration (`DM2_V2_MoveCallback`/`TurnCallback`/`StairsCallback` registered into `dm2_v1_runtime`). Source-lock: ReDMCSB DUNGEON.C G0306/G0307. - **Phase 6**: Touch controller affordance stubs for V2 render pipeline. ### Nexus V2 — Phase 1–6 Complete - **Phase 1–6**: Touch/controller affordance ergonomics, atmosphere, lighting, particles, upscaler fixes. ### Theron V1 — Phase 1–4 Complete - **Phase 1–4**: Rendering pipeline — tile renderer, asset loader, UI chrome, creature instance lifecycle (death/drop/sound integration). - **Runtime handoff**: M11 now routes hash-verified Track 02 launches into the Theron boot/world/viewport path instead of the DM1 DUNGEON.DAT loader, with deterministic fallback rendering while exact Track 02 dungeon-bank offsets are hardened. ### DM1 V1 — Phase 8 Complete - Door and special-square interaction probe. - Wall rendering integrity probe (wall spec, parity, blit clip gate). - Blurry inscription probe. - Champion portrait Z-order fix (floating artifact). - Source-lock parity evidence manifests and line references updated. ### DM1 V2 — Phase 8 Complete - Door-frame type override and manifest path resolution. - Message log — pixel font atlas and scroll renderer. - Champion panel renderer and HUD overlay V2 (Phase 8 revisit). - FloorShapeType enum normalization, `dm1_v2_vp_square_id` export. - DM1 V2.2 Modern Asset Pipeline defined. ### M12 Launcher - JSON settings export/import feature (`firestaff_m12_json_export_import_probe`). ### Accessibility - High-contrast game view toggle. - Configurable in-game font scaling (M11 `fontScale` from M12 setting). ### Probes - `firestaff_nexus_v1_mechanics_parity_probe` — Phase 7 mechanics verification (dungeon loading, movement, combat, save/load, world state, engine lifecycle). - CSB V1 Phase 2 DSA script section probe. - DM1 V1 parity-evidence manifests (2026-05-30 refresh). - Source-lock evidence docs with screen-detect automation. ## Fixes - Fixed `m11_game_view.c` missing includes chain. - Fixed CSB V1 Phase 6 followup warnings and `get_party` stub. - Fixed DM1 V1 wall rendering: `flip_horizontally` set before return (native path). - Fixed stale DM1 V1 verification probe line ranges. - Fixed `dm2_v1_world_model.c` dungeon data model. - Fixed `dm2_v1` movement collision to check door state (Phase 4 gap). - Fixed `dm1_v1_viewport_cell_is_wall_like` inline fakewall/open-wall parity. - Fixed `dm1_v1_viewport_3d_select_wall_bitmap` `flip_horizontally` before return. - Fixed `csb_v1_phase7_followup` 3 failing test assertions. - Fixed `nexus_v1_mechanics_combat_probe` — combat/creature AI source-lock. - Fixed `passH22F7` CSB V1 Phase 2 DSA script section. - Fixed `test_dm1_v22_verification` manifest JSON format (single-line → multi-line). - Fixed `DM1_V1`0x80 inscription separator normalization to `\n`. ## Verification - GitHub Actions verify workflow passed on `main` before release. - CMake configure + build completed (all targets, pre-existing warnings only). - Phase A probe: 21/21 invariants. - Nexus launch smoke: 6/6. - CSB V2 Phase 1 separation: 40/40. - DM2 V2 HUD overlay, lighting, csb_v2_lighting_dynamic, csb_v2_touch_controller_affordance: all green. ## Platforms | Platform | Architecture | Format | |----------|-------------|--------| | macOS | arm64 + x86_64 | DMG, ZIP | | Windows | x86_64 | ZIP, Installer (EXE) | | Linux | x86_64 | DEB, RPM | | Linux | ARM64 | DEB, RPM | --- # Firestaff v2.6.0 V2 expansion, source-lock hardening, and engine handoff release building on the v2.5.x pipeline. ## What's New - **CSB V2 Phase 0**: V1 compatibility lock before V2 work. `csb_v2_phase_gate_pc34.h` defines 13 domain compile gates (V1-source-locked vs V2-presentation-berättigade). Stub hooks for all V2-only functions. C11 `_Static_assert` for V1 struct sizes. Source-lock: COMMAND.C, DUNGEON.C, CSBWin champion/resurrect. - **CSB V2 Phase 1**: Launch/profile separation. `CSB_V2_PHASE_DOMAIN_LAUNCH` and `CSB_V2_PHASE_DOMAIN_PROFILE` compile gates with CSB-hash-katalog (DUNGEON.DAT `6695d2a`, GRAPHICS.DAT `61fbfd5`). LAUNCH-before-PROFILE pattern enforced. Source-lock: ENTRANCE.C F0806, PROFILE.C F0401. - **DM2 V2 Phase 5**: Smooth movement runtime integration. `DM2_V2_MoveCallback`/`DM2_V2_TurnCallback`/`DM2_V2_StairsCallback` registered from `dm2_v2_runtime.c` into `dm2_v1_runtime`. Pre-move position stored, turn-only detection fires turn_callback without move_callback. Source-lock: ReDMCSB DUNGEON.C G0306/G0307. - **Nexus V1 Launcher**: Full `nexus_v1_launcher.h/.c` engine handoff. Singleton owns `Nexus_V1_Engine` lifecycle. `M11_GameView_StartNexus` now calls `launcher_init` + `launcher_load_level(0)` and stores engine pointer. `firestaff_nexus_v1_launch_smoke_probe` validates full init→load→tick→render cycle (6/6 headless). Source-lock: NEXUS.C/NEXUS2.C engine lifecycle, DMWeb Saturn DGN/DMDF format. ## Fixes - Fixed CI build error: `nexus_v1_launcher.h` not in git causing `fatal error: nexus_v1_launcher.h: No such file` on fresh clone. Launcher integrated into CMake and source committed. - Fixed `firestaff_nexus_v1_launch_smoke_probe` orphaned CMake target (source file was added in commit but never committed). - Disabled `test_dm1_v22_verification` CMake target (committed with massive API mismatches — wrong headers, undefined types). - Patched `m11_game_view.c` missing includes: `nexus_v1_engine.h`, `dm1_v2_camera_controller_pc34.h`, `firestaff_po_loader.h`, `dm1_v2_phase5_runtime_bridge_pc34.h`, `dm1_v1_viewport_fakewall_pc34_compat.h`. - Added `firestaff_nexus` to `firestaff_m11` `target_link_libraries` (linker error on `M11_GameView_StartNexus`). ## Verification - GitHub Actions verify workflow passed on `main` before release. - CMake configure + build completed (all targets, pre-existing warnings only). - Phase A probe: 21/21 invariants. - Nexus launch smoke: 6/6. - CSB V2 Phase 1 separation: 40/40. - DM2 V2 HUD overlay, lighting, csb_v2_lighting_dynamic, csb_v2_touch_controller_affordance: all green. ## Platforms | Platform | Architecture | Format | |----------|-------------|--------| | macOS | arm64 + x86_64 | DMG, ZIP | | Windows | x86_64 | ZIP, Installer (EXE) | | Linux | x86_64 | DEB, RPM | | Linux | ARM64 | DEB, RPM | ## Release assets This release includes macOS arm64, macOS x86_64, Windows x86_64, Linux x86_64, and Linux arm64 packages. Original Dungeon Master game data is not included. Full changelog: https://github.com/yeager/firestaff/compare/v3.0.6...v3.0.7

## Changes since initial - release: v1.9.7 — door frame + stairs direction fixes Full changelog: https://github.com/yeager/firestaff/compare/main...v1.9.7

## Changes since initial - release: v1.9.5 — HiDPI/Retina scaling fix for macOS Full changelog: https://github.com/yeager/firestaff/compare/main...v1.9.5

## Firestaff v0.6.0 — Complete Collection ### Rendering Pipeline (NEW) - **GRAPHICS.DAT bitmap extraction**: 713 graphics parsed from original PC-34 data - **4bpp decompression**: real wall textures, HUD panel, title screens from original assets - **DM1 VGA palette**: authentic 16-color dungeon palette - **Wall texture mapping**: D0-D3 distance × L/C/R position per wall set - **Dungeon view cone**: square type query drives wall selection - **Full pipeline**: GRAPHICS.DAT → 4bpp → palette RGBA → EPX upscale → SDL present ### Games | Game | V1 | V2.1 Upscaled | V2.2 Enhanced | |---|---|---|---| | Dungeon Master | ✅ 62 modules | ✅ EPX pipeline | ✅ 20 features | | Chaos Strikes Back | ✅ 12 modules | ✅ Viewport | ✅ 4 features | | Dungeon Master II | ✅ 10 modules | ✅ Indoor+outdoor | ✅ 4 features | ### 20 Languages EN, SV, DE, FR, ES, IT, PT, NL, PL, CS, RU, JA, KO, ZH, DA, NO, FI, HU, TR - Auto-detects system language - Swedish game text (Firestaff original, with ÅÄÖ) - Dungeon inscriptions translated for all 20 languages ### CLI ``` firestaff dm1 --v21 --fullscreen --lang sv firestaff csb --v1 --scale 4 firestaff dm2 --v22 --load 3 ``` ### Extras - Bestiary (24 creatures), Spell Reference (14 spells) - Map Viewer, Item Encyclopedia (33 items), Screenshot Gallery ### Technical - 927 source files, 188K lines of C - 100% ReDMCSB function parity (40/40 source files) - 304 tests, repo restructured (28 root items) ### Downloads | Platform | File | |---|---| | macOS (Apple Silicon + Intel) | `Firestaff-0.6.0.dmg` or `.zip` | | Windows | `Firestaff-0.6.0-windows.zip` or `-installer.exe` | | Linux (Debian/Ubuntu) | `firestaff_0.6.0_amd64.deb` | | Linux (Fedora/RHEL) | `firestaff-0.6.0.x86_64.rpm` |

## Firestaff v0.3.21 Verified DM1 V1 parity-gate release from current `main`. ### Added - Source-locked DM1 V1 Elija route gate evidence. - DM1 V1 viewport hand overlay compatibility gate. - DM1 V1 viewport status bar layout compatibility gate. ### Packaging - macOS DMG + app zip. - SHA256 checksums included. ### Verified - `git diff --check` clean. - Conflict marker scan clean. - Strict secret scan clean. - Sensitive filename scan clean. - CMake Release configure/build. - macOS smoke probes. - Focused DM1 V1 viewport/status CTest gates passed.

## Firestaff v0.3.20 ### Startup menu - Shows a startup popup when no original retail game files are found. - The popup tells the user to copy their retail files into the detected Firestaff data directory before launching. Startup menu feature controls binary release. ### Added - New startup menu control groups for Renderer, Input, Data, and Debug. - Viewport style selector: Original, Expanded, Widescreen. - Input mode selector: Auto, Keyboard+Mouse, Touch, Gamepad. - Touch controls selector: Off, Minimal, Full, Large. - Movement mode selector: Original, Fast, Smooth. - Original data status row. - Debug overlay selector: Off, Coords, Queue, Draw Order. - Developer gates selector: Off, Quick, Full. - Persistent config keys for the new menu controls. ### Packaging - macOS DMG + app zip. - Linux DEB + RPM. - Windows zip + NSIS installer. ### Verified - macOS Release build + smoke probes. - GitHub Actions package builds for Linux and Windows. - Package checksums included per platform.

# Firestaff v0.3.12 Release workflow follow-up for the DM1 V1 movement, viewport, touch, and runtime-route verification release. ## Highlights - Carries the v0.3.11 DM1 V1 movement/viewport/touch verification changes. - Fixes release workflow tag resolution so Windows and Linux package jobs use the tag-specific release notes file instead of the stale preview fallback. ## Verification Local release gates passed on macOS before tagging: - `cmake --build build-release-push -j2` - `ctest --test-dir build-release-push --output-on-failure -R 'm12_startup_menu|m11_game_view|m11_viewport_state|m11_turn_viewport_orientation|dm1_v1_hall_walkaround_runtime|dm1_v1_title_launcher|dm1_v1_movement_core|dm1_v1_viewport_wall|dm1_v1_viewport_redraw|touch|pass3(4|5|6|7|8|9|60|61|62)'` - `git diff --check origin/main..HEAD` - high-confidence secret scan against `origin/main..HEAD` - local macOS DMG creation and `hdiutil verify`