feat: add diagnostics and resolve js-yaml advisory

.github/workflows/release.yml

@@ -145,6 +145,9 @@ jobs:
 
       - name: Build TypeScript
         run: cd app && npm run build
+        env:
+          VITE_POSTHOG_PROJECT_TOKEN: ${{ secrets.POSTHOG_PROJECT_TOKEN }}
+          VITE_POSTHOG_HOST: https://us.i.posthog.com
 
       - name: Download bundles for DMG
         run: |

.gitignore

@@ -66,6 +66,10 @@ vkd3d-proton-reference/
 /app/out/
 /app/release/
 
+# Local PostHog project configuration and wizard state (NEVER commit credentials or account artifacts)
+/app/.env
+/app/.posthog-wizard-cache/
+
 # macOS app bundles (regeneratable)
 *.dmg
 *.pkg

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## v0.59.1 — 2026-08-08
+
+### Added
+
+- **Developer diagnostics and feedback** — PostHog US Cloud operational diagnostics are enabled by default with a persisted Settings opt-out, privacy-minimized renderer lifecycle/error events, fully masked session recordings, and explicit Settings feedback submission. No Steam/account data, paths, game-library metadata, command lines, raw logs, backend responses, exception details, credentials, or secrets are collected automatically.
+- **Emergency active-game stop shortcut** — `Cmd+Q` invokes MetalSharp's existing PID-scoped Stop path while a tracked game is active, including when the game owns focus; with no active game, it retains normal application quit behavior.
+- **Reminiscence default route** — Steam AppID 1675140 now defaults to the M11 pipeline and is listed in the supported-games matrix.
+
+### Fixed
+
+- **M12/DXMT pipeline switches** — game-folder graphics deployment now strictly removes the conflicting prior route before staging the selected one. M12 owns VKD3D-Proton `d3d12.dll`/`d3d12core.dll` and DXVK `dxgi.dll`/`d3d11.dll`; DXMT transitions evict that full set, and M12 transitions remove DXMT-specific files first.
+- **VKMT MoltenVK installation and upgrades** — fresh installs and existing installations now synchronize Wine’s direct-load MoltenVK copies from the staged VKMT lane after graphics extraction, with byte-level stale-copy detection; the legacy DXMT fast path also verifies and repairs missing M12 lanes.
+- **Saved application theme** — auxiliary and process-manager windows now respect an explicitly saved theme; first launch remains dark.
+- **`js-yaml` security update** — updated to 4.3.1.
+
 ## v0.59.0 — 2026-08-06
 
 ### Added

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.24)
-project(metalsharp VERSION 0.59.0 LANGUAGES C CXX OBJC OBJCXX)
+project(metalsharp VERSION 0.59.1 LANGUAGES C CXX OBJC OBJCXX)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)

README.md

@@ -1,12 +1,12 @@
 <div align="center">
 
 # MetalSharp
-**Updated:** 2026-08-01
+**Updated:** 2026-08-08
 
 **Run Windows games on MacOS Silicon.**
 
 <a href="https://github.com/aaf2tbz/metalsharp/actions"><img src="https://img.shields.io/github/actions/workflow/status/aaf2tbz/metalsharp/ci.yml?branch=main&style=for-the-badge" alt="CI"></a>
-<a href="https://github.com/metalsharp/MetalSharp/releases/tag/v0.58.0"><img src="https://img.shields.io/github/v/release/aaf2tbz/metalsharp?filter=v0.58.0&style=for-the-badge" alt="Release"></a>
+<a href="https://github.com/metalsharp/MetalSharp/releases/tag/v0.59.1"><img src="https://img.shields.io/github/v/release/aaf2tbz/metalsharp?filter=v0.59.1&style=for-the-badge" alt="Release"></a>
 <a href="https://github.com/aaf2tbz/metalsharp/discussions"><img src="https://img.shields.io/github/discussions/aaf2tbz/metalsharp?style=for-the-badge" alt="Discussions"></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/License-PolyForm%20Noncommercial-yellow.svg?style=for-the-badge" alt="PolyForm Noncommercial 1.0.0"></a>
 <a href="https://discord.gg/qW5rUr4dH"><img src="https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white" alt="DISCORD"></a>
@@ -21,7 +21,7 @@ MetalSharp is an application designed to run Windows Steam and Windows Steam gam
 
 ## Arm64-FEX Build For Devs Out Now
 
-[0.60.0 Dependancies Release](https://github.com/metalsharp/MetalSharp/releases/tag/v0.60.0-dependency-bundles), 0.59.0 Remains The Current Working Version. 
+[0.60.0 Dependancies Release](https://github.com/metalsharp/MetalSharp/releases/tag/v0.60.0-dependency-bundles), 0.59.1 Remains The Current Working Version.
 
 ## Quick Start
 

app/.env.example

@@ -0,0 +1,2 @@
+VITE_POSTHOG_PROJECT_TOKEN=your_posthog_project_token
+VITE_POSTHOG_HOST=https://us.i.posthog.com

app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "metalsharp",
-  "version": "0.59.0",
-  "description": "MetalSharp \u2014 D3D\u2192Metal translation layer frontend",
+  "version": "0.59.1",
+  "description": "MetalSharp — D3D→Metal translation layer frontend",
   "author": "MetalSharp",
   "repository": {
     "type": "git",
@@ -27,7 +27,8 @@
     "dmg": "npm run dist -- --mac dmg"
   },
   "dependencies": {
-    "electron-store": "^10.0.0"
+    "electron-store": "^10.0.0",
+    "posthog-js": "^1.414.0"
   },
   "overrides": {
     "form-data": "4.0.6",
@@ -54,7 +55,7 @@
   "build": {
     "appId": "com.metalsharp.app",
     "productName": "MetalSharp",
-    "copyright": "Copyright \u00a9 2026 MetalSharp",
+    "copyright": "Copyright © 2026 MetalSharp",
     "afterPack": "build/adhoc-deep-sign.cjs",
     "afterSign": "build/notarize.cjs",
     "mac": {

app/src-rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "metalsharp-backend"
-version = "0.59.0"
+version = "0.59.1"
 edition = "2021"
 
 [dependencies]