# Changelog

All notable changes to NotAlterra are documented in this file.

---

## [v0.1.0] — 2026-05-31

### Added
- Cross-platform terminal UI (ratatui + crossterm) with keyboard-driven menus, pickers, popups, and status bar
- GVAS save-file binary parser: extracts SlotName, DisplayName, bIsMultiplayerSave, GameMode, LevelName, BuildNumber, and more
- **Save-folder discovery** with Windows fast-path (`%LOCALAPPDATA%`) and Linux Proton/Steam Deck paths
- **.bak to .sav recovery** with filename-derived slot grouping, `.sav.old` rollback, and size sanity checks
- **Full backup / restore** (only `savegame_*` files) with pre-restore snapshots and verification
- **UE5 Config (.ini) management** — backup, restore, and guarded delete
- **Save inspector** with full GVAS metadata displayed in a color-coded popup
- **Slot grouping** in the recovery picker — first entry per slot gets a numbered label, subsequent entries blank
- **Online / Local detection** via `bIsMultiplayerSave` BoolProperty
- **Mode-change warning** (Online ↔ Local) and **name-change warning** on recovery
- **Game-running guard** — exits or warns if Subnautica 2 is active
- **Transaction log** (`transaction.log`) with `MANUAL_BAK`, `AUTO_BAK`, `RESTORE`, `RECOVER`, `CONFIG_BAK`, `CONFIG_RESTORE`, `CONFIG_DEL`, and `LICENSE` actions
- **Disclaimer popup** with Accept / Decline buttons — Esc returns to menu without revoking
- **OK dialogs** for backup results, no-backup warnings, and ini action outcomes
- **Confirmation popups** with `[ Yes ]` / `[ No ]` buttons and detailed metadata comparison
- **No-backup guard** — warns if `NotAlterra_Backups` is empty before destructive actions
- **Empty directory cleanup** — failed backup directories are removed
- **Auto-size popups** — GVAS inspector and OK dialogs scale to fit content
- **Terminal resize** — main loop and all sub-loops respond to terminal size changes
- **Arrow-key debounce** — `KeyRelease` events are filtered; no double-stepping
- **Elapsed timer** during save-folder scan with background threading
- **Release build script** (`build.sh`) producing `notalterra-v{version}-linux-amd64.tar.gz` and `notalterra-v{version}-windows-amd64.zip`
- `--version` / `-v` CLI flag
- MIT License and README with build, usage, and unpack instructions

### Changed
- Improved game-running exit message — explains why save files are at risk

### Fixed
- Background scan thread panic no longer hangs the application
- Arrow-key navigation no longer overshoots — `KeyEventKind::Release` events filtered
- GVAS metadata popup renders all 11 fields (was clipped to 2 because of `Paragraph::new(Span)`)
- Header path now shows tail of path (e.g. `…\Subnautica2\Saved\SaveGames`) instead of truncated prefix
- Confirmation popup always appears — hard `require_backup` block replaced with soft warning

### Security
- Game-running detection at launch and before each destructive operation
- `.ini` delete guarded by requiring at least one `ini_backup_*` directory