release: CA-O 2.2.7 con registrador black-box para Overclock

- Registrador de pasos en Refresh de Overclock (CrashLog.Step): el log dice el paso exacto si vuelve a crashear
- Seam CrashLog.LogPathOverride para aislar tests del log real
- Suite 1701 passed, 0 failed; build 0W/0E

Author: Pyromesis

CHANGELOG.md

@@ -4,6 +4,14 @@ Formato basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/).
 
 ## [Unreleased]
 
+## [2.2.7] - 2026-10-11
+
+### Anadido
+- **Registrador black-box de pasos de Overclock.** `CrashLog.Step(stage)` escribe una marca por fase del sondeo (`refresh.probe-start`, `probe-done`, `rows-done`, `readings-done`, `games-done`, `delta-done`, `ceilings-done`, `recoveries-done`, `done`/`failed`) en el mismo `cao-ui-crash.log`. Si la pestana vuelve a fallar en un equipo, el log dice el paso exacto en vez de un crash mudo.
+
+### Probado
+- Suite completa en Release (2 CrashLogStepTests nuevos).
+
 ## [2.2.6] - 2026-10-11
 
 ### Corregido

README.md

@@ -1,4 +1,4 @@
-# CA-O 2.2.6 — Plataforma nativa de rendimiento, diagnóstico y optimización para Windows 11
+# CA-O 2.2.7 — Plataforma nativa de rendimiento, diagnóstico y optimización para Windows 11
 
 > **Principio operativo:** diagnosticar primero → recomendar con evidencia → aplicar en transacción → verificar → revertir si falla. Sin promesas numéricas falsas, solo hechos medibles.
 
@@ -7,10 +7,10 @@
 [![WinUI 3](https://img.shields.io/badge/WinUI%203-00B7C3?style=flat-square&logo=windows&logoColor=white)](https://microsoft.github.io/microsoft-ui-xaml/)
 [![Build](https://img.shields.io/badge/build-passing-brightgreen?style=flat-square)](https://github.com/Pyromesis/CA-O/actions)
 [![Tests](https://img.shields.io/badge/tests-1692%20passed-brightgreen?style=flat-square)](#-pruebas)
-[![Release](https://img.shields.io/badge/release-v2.2.6-blue?style=flat-square)](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.6)
+[![Release](https://img.shields.io/badge/release-v2.2.7-blue?style=flat-square)](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.7)
 [![License](https://img.shields.io/badge/license-privado-lightgrey?style=flat-square)](#licencia)
 
-**Descargas v2.2.6:** [CA-O-Instalador.exe (132 MB, instalador Inno Setup)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O-Instalador.exe) | [CA-O.Setup.exe (135 MB, descargador de un solo exe: baja el paquete y abre el instalador)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O.Setup.exe) | [CA-O-Setup-GUI-x64.zip (88 MB, paquete completo offline)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O-Setup-GUI-x64.zip) | [CA-O-Setup-GUI-x64.exe (instalador con asistente Inno Setup)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O-Setup-GUI-x64.exe) | [SHA256SUMS.txt](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/SHA256SUMS.txt) | [Notas de la versión](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.6) | [Documentación](docs/ARCHITECTURE.md)
+**Descargas v2.2.7:** [CA-O-Instalador.exe (132 MB, instalador Inno Setup)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O-Instalador.exe) | [CA-O.Setup.exe (135 MB, descargador de un solo exe: baja el paquete y abre el instalador)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O.Setup.exe) | [CA-O-Setup-GUI-x64.zip (88 MB, paquete completo offline)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O-Setup-GUI-x64.zip) | [CA-O-Setup-GUI-x64.exe (instalador con asistente Inno Setup)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O-Setup-GUI-x64.exe) | [SHA256SUMS.txt](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/SHA256SUMS.txt) | [Notas de la versión](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.7) | [Documentación](docs/ARCHITECTURE.md)
 
 ---
 
@@ -43,7 +43,7 @@
 
 ## Resumen ejecutivo
 
-**CA-O 2.2.6** es una aplicación **100% nativa Windows** escrita en **.NET 10 + WinUI 3 (Windows App SDK 2.4)**. No es una colección de tweaks: **mide** hardware, térmicas, red, almacenamiento, drivers y postura de seguridad **antes** de recomendar. Cada cambio pertenece a un **bucket analizado-primero** (`Recommended` / `Optional` / `Experimental` / `SecuritySensitive` / `NotApplicable` / `Blocked`) y se ejecuta bajo el flujo transaccional `PRECHECK → SNAPSHOT → APPLY → VERIFY → COMMIT` con **rollback automático y verificación post-reversión**.
+**CA-O 2.2.7** es una aplicación **100% nativa Windows** escrita en **.NET 10 + WinUI 3 (Windows App SDK 2.4)**. No es una colección de tweaks: **mide** hardware, térmicas, red, almacenamiento, drivers y postura de seguridad **antes** de recomendar. Cada cambio pertenece a un **bucket analizado-primero** (`Recommended` / `Optional` / `Experimental` / `SecuritySensitive` / `NotApplicable` / `Blocked`) y se ejecuta bajo el flujo transaccional `PRECHECK → SNAPSHOT → APPLY → VERIFY → COMMIT` con **rollback automático y verificación post-reversión**.
 
 La UI **siempre eleva** (`app.manifest` `requireAdministrator` → UAC en cada inicio) pero **toda mutación privilegiada cruza** al servicio Windows `CAO.Privileged` (SYSTEM) vía **Named Pipe autenticado** con ACL restrictiva, validación de esquema tipado, ventana de 30 s, nonce y protección anti-replay. Sin el servicio, la app opera en **modo solo lectura** (diagnóstico + benchmark disponibles). El servicio es `start= delayed-auto` por diseño: tras un reinicio arranca solo con retardo; si la app lo encuentra aún detenido, lo levanta (`sc start` + espera de readiness con ping al pipe hasta 8 s) al comprobar, o lo re-registra con `Ajustes → Instalar ahora` sin necesitar el repositorio.
 
@@ -80,7 +80,7 @@ La UI **siempre eleva** (`app.manifest` `requireAdministrator` → UAC en cada i
 | **WMI** | System.Management | **10.0.0** | Lectura hardware/termal/batería |
 | **Perf** | System.Diagnostics.PerformanceCounter | **10.0.0** | `% DPC Time` / `% Interrupt Time` |
 | **Servicios** | System.ServiceProcess.ServiceController | **8.0.1** | `CAO.Privileged` como `BackgroundService` |
-| **Build** | `Directory.Packages.props` + `Directory.Build.props` + `Version.props` (single source `2.2.6`) | Centralizado | Un lugar para bump de versión/paquetes |
+| **Build** | `Directory.Packages.props` + `Directory.Build.props` + `Version.props` (single source `2.2.7`) | Centralizado | Un lugar para bump de versión/paquetes |
 | **Tests** | xUnit 2.9.2 + Microsoft.NET.Test.Sdk 17.11.1 | — | 1692 tests en Release |
 | **Seguridad** | CodeQL + `dotnet audit` + Dependabot + CycloneDX SBOM | CI | Cadena de suministro auditada |
 
@@ -117,7 +117,7 @@ La UI **siempre eleva** (`app.manifest` `requireAdministrator` → UAC en cada i
 
 | Proyecto | Responsabilidad | Depende de |
 |---|---|---|
-| `CA-O.Shared` | DTOs, contratos IPC v2 (`IpcProtocol` v2, `Ping`, `GetServiceStatus`), `CaOPaths`, `ErrorCodes CAO-XXX-nnn`, `AppVersion 2.2.6`, `BuildConstants`, `Constants/IpcConstants`, `TimeoutProfile` | — |
+| `CA-O.Shared` | DTOs, contratos IPC v2 (`IpcProtocol` v2, `Ping`, `GetServiceStatus`), `CaOPaths`, `ErrorCodes CAO-XXX-nnn`, `AppVersion 2.2.7`, `BuildConstants`, `Constants/IpcConstants`, `TimeoutProfile` | — |
 | `CA-O.Core` | `OptimizationCatalog` (93), `OptimizationEngine` transaccional, `RecommendationEngine` + `OptimizationScoreCalculator` (0-100), `GameCompatibilityPolicy` (matriz SAFE/CAUTION/BLOCKED `CAO-GAME-001`), `HealthEngine`, `KnownIssueMatcher`, `CrashRecoveryService`, `Rollback/*` | Shared |
 | `CA-O.Infrastructure` | WMI 5 s timeout + `SystemAnalysisService` + `AnalysisStateStore` (atómico, 24 h TTL) + `SnapshotRepository`/`FileSnapshotStore` (TX identity + SHA-256) + `JsonHistoryLogger` (hash-chain) + `SystemBenchmarkRunner` + `Gaming/*` + `Networking/*` + `Storage/*` + `Security/*` + `Windows/*` | Core, Shared |
 | `CA-O.Privileged` | Servicio `SYSTEM` + `PrivilegedPipeService` (Named Pipe `CA-O.Privileged.v1`, ACL + `ReplayCache` 30 s, timeout 15 s/conn) + `OptimizationEngine` hosteado + `AdministratorsOnlyAuthorizer` | Core, Infrastructure, Shared |
@@ -156,7 +156,7 @@ BENCHMARK → post-commit, fallo no invalida commit   // eventos separados
 CA-O.sln  (.NET 10 · LangVersion 13 · WinUI 3)
 ├── src/
 │   ├── CA-O.Shared/                 # Contratos puros, sin IO
-│   │   ├── Constants/               # AppVersion (2.2.6), BuildConstants, CaOPaths, IpcConstants, TimeoutProfile
+│   │   ├── Constants/               # AppVersion (2.2.7), BuildConstants, CaOPaths, IpcConstants, TimeoutProfile
 │   │   ├── IPC/                     # IpcProtocol v2, IpcRequest/Response, Payloads (17 ops)
 │   │   ├── Security/                # CommandPolicy, ErrorCodes, CallerIdentity
 │   │   ├── Enums/                   # RecommendationBucket, RiskLevel, EvidenceLevel, etc.
@@ -219,7 +219,7 @@ CA-O.sln  (.NET 10 · LangVersion 13 · WinUI 3)
 ├── .github/workflows/ci.yml         # build + test + CodeQL + dotnet audit
 ├── Directory.Packages.props         # Versiones centralizadas
 ├── Directory.Build.props            # Propiedades MSBuild comunes
-├── Version.props                    # Single source 2.2.6
+├── Version.props                    # Single source 2.2.7
 ├── global.json                      # SDK 10.0.400
 └── CA-O.sln
 ```
@@ -677,15 +677,15 @@ Cada perfil es **dinámico** — no es lista fija. Ej. `maximum-power-plan` solo
 
 ### Opción A — Un solo exe (lo más fácil)
 
-1. Descarga [CA-O.Setup.exe (135 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O.Setup.exe) — es el único archivo que necesitas
+1. Descarga [CA-O.Setup.exe (135 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O.Setup.exe) — es el único archivo que necesitas
 2. Ejecútalo (pide UAC) → deriva al instalador gráfico en español: instala app + servicio y abre CA-O. Sin consola: lo trae todo dentro
 
 > Autocontenido, log en `%TEMP%\CA-O-Setup.log`
-> Tambien disponible [CA-O-Instalador.exe (132 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O-Instalador.exe): instalador Inno Setup que pone app + servicio + atajos sin pasos extra.
+> Tambien disponible [CA-O-Instalador.exe (132 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O-Instalador.exe): instalador Inno Setup que pone app + servicio + atajos sin pasos extra.
 
 ### Opción B — Instalador GUI offline (88 MB)
 
-1. Descarga [CA-O-Setup-GUI-x64.zip (88 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O-Setup-GUI-x64.zip) y verifica el hash con `SHA256SUMS.txt`
+1. Descarga [CA-O-Setup-GUI-x64.zip (88 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O-Setup-GUI-x64.zip) y verifica el hash con `SHA256SUMS.txt`
 2. Descomprime (mantén `ui/`, `service/`, `gui-installer/`, `uninstall/`, `setup/`)
 3. Entra en `gui-installer/` → clic derecho **Ejecutar como administrador** en `CA-O.InstallerGui.exe` → UAC Sí
 4. Elige destino (`C:\Program Files\CA-O`), atajos Escritorio/Inicio, progress → registra `CAO.Privileged` (`demand`, `failure 86400`) + ARP
@@ -695,7 +695,7 @@ Cada perfil es **dinámico** — no es lista fija. Ej. `maximum-power-plan` solo
 
 ### Opción C — Descargador online (135 MB)
 
-1. Descarga [CA-O.Setup.exe (135 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.6/CA-O.Setup.exe)
+1. Descarga [CA-O.Setup.exe (135 MB)](https://github.com/Pyromesis/CA-O/releases/download/v2.2.7/CA-O.Setup.exe)
 2. Ejecútalo como admin: descarga el paquete `CA-O-Setup-GUI-x64.zip` desde GitHub Releases (requiere internet), deriva al instalador gráfico y continúa solo
 
 > Log: `%TEMP%\CA-O-Setup.log`
@@ -750,7 +750,7 @@ powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1
 
 # Empaquetar (scripts/package.ps1, FullPackageName `CA-O-{versión}-win-x64.zip`)
 powershell -ExecutionPolicy Bypass -File scripts/package.ps1
-# → artifacts/CA-O-2.2.6-win-x64.zip + .sha256
+# → artifacts/CA-O-2.2.7-win-x64.zip + .sha256
 
 # Endurecer ACLs de datos
 powershell -ExecutionPolicy Bypass -File scripts/harden-data-acls.ps1
@@ -790,7 +790,7 @@ dotnet test --filter "FullyQualifiedName~GameCompatibility"
 
 ## Release y verificación
 
-- **Versión actual:** **2.2.6** — [Releases](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.6) (solo se conserva el último release)
+- **Versión actual:** **2.2.7** — [Releases](https://github.com/Pyromesis/CA-O/releases/tag/v2.2.7) (solo se conserva el último release)
 - **Artefactos:**
   - `CA-O.Setup.exe` (135 MB, descargador single-file con handoff al GUI)
   - `CA-O-Setup-GUI-x64.zip` (88 MB, paquete completo offline con `ui/`, `service/`, `gui-installer/`, `setup/`, `uninstall/`)
@@ -801,7 +801,7 @@ dotnet test --filter "FullyQualifiedName~GameCompatibility"
 - **Empaquetado:** `scripts/package.ps1` genera ZIP versionado `CA-O-{versión}-win-x64.zip` + hash SHA-256. `scripts/build-release.ps1` publica `ui` y `service` como self-contained y `gui-installer` como self-contained **sin single-file** (requisito WinUI 3)
 
 ```powershell
-Get-FileHash artifacts/CA-O-2.2.6-win-x64.zip -Algorithm SHA256
+Get-FileHash artifacts/CA-O-2.2.7-win-x64.zip -Algorithm SHA256
 Get-Content artifacts/release/SHA256SUMS.txt
 cat artifacts/sbom/bom.json | ConvertFrom-Json | select -ExpandProperty components | measure
 ```
@@ -880,4 +880,4 @@ Proyecto privado: no se concede licencia de uso, copia, modificación ni distrib
 
 ---
 
-<p align="center"><i>CA-O 2.2.6 — Diagnóstico primero, evidencia después, transacción siempre. Sin promesas, solo hechos medibles.</i></p>
+<p align="center"><i>CA-O 2.2.7 — Diagnóstico primero, evidencia después, transacción siempre. Sin promesas, solo hechos medibles.</i></p>

Version.props

@@ -1,12 +1,12 @@
 <Project>
   <!-- Single source of truth for versioning (FASE 28). All other files derive from here. -->
   <PropertyGroup>
-    <Version>2.2.6</Version>
-    <AssemblyVersion>2.2.6.0</AssemblyVersion>
-    <FileVersion>2.2.6.0</FileVersion>
-    <PackageVersion>2.2.6</PackageVersion>
-    <ProductVersion>2.2.6</ProductVersion>
-    <InformationalVersion>2.2.6+$(GHTag)</InformationalVersion>
+    <Version>2.2.7</Version>
+    <AssemblyVersion>2.2.7.0</AssemblyVersion>
+    <FileVersion>2.2.7.0</FileVersion>
+    <PackageVersion>2.2.7</PackageVersion>
+    <ProductVersion>2.2.7</ProductVersion>
+    <InformationalVersion>2.2.7+$(GHTag)</InformationalVersion>
   </PropertyGroup>
 </Project>
 

installer/CA-O.iss

@@ -3,7 +3,7 @@
 ; (lee la versión de BuildConstants.cs y firma con CAO_SIGN_THUMBPRINT si existe)
 
 #ifndef AppVersion
-  #define AppVersion "2.2.6"
+  #define AppVersion "2.2.7"
 #endif
 #ifndef RepoRoot
   #define RepoRoot ".."

src/CA-O.Shared/Constants/BuildConstants.cs

@@ -11,10 +11,10 @@ namespace CAO.Shared.Constants;
 public static class BuildConstants
 {
     // Version - SINGLE SOURCE OF TRUTH
-    public const string ProductVersion = "2.2.6";
+    public const string ProductVersion = "2.2.7";
     public const string ProductVersionMajor = "2";
     public const string ProductVersionMinor = "2";
-    public const string ProductVersionPatch = "6";
+    public const string ProductVersionPatch = "7";
 
     // Product Identity
     public const string ProductName = "CA-O";

src/CA-O.UI/Helpers/CrashLog.cs

@@ -18,15 +18,23 @@ internal static class CrashLog
     /// Appends an exception and its inner chain. Never throws: a logger that
     /// can crash the caller is a second bug wearing the first one's clothes.
     /// </summary>
+    /// <summary>Test seam: when set, the log goes here instead of LocalAppData. Production never sets it.</summary>
+    internal static string? LogPathOverride { get; set; }
+
+    private static string ResolvePath()
+    {
+        var path = LogPathOverride ?? Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+            "CA-O", "logs", "cao-ui-crash.log");
+        Directory.CreateDirectory(Path.GetDirectoryName(path)!);
+        return path;
+    }
+
     public static void Write(Exception ex)
     {
         try
         {
-            var logDir = Path.Combine(
-                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
-                "CA-O", "logs");
-            Directory.CreateDirectory(logDir);
-            var path = Path.Combine(logDir, "cao-ui-crash.log");
+            var path = ResolvePath();
             RotateIfNeeded(path);
 
             var sb = new StringBuilder()
@@ -78,6 +86,28 @@ public static void Write(Exception ex)
         }
     }
 
+    /// <summary>
+    /// Appends a one-line breadcrumb. The Overclock refresh writes one per
+    /// phase so a native crash that leaves no managed exception behind still
+    /// leaves the exact step it died in. Same contract as Write: never throws.
+    /// </summary>
+    public static void Step(string stage)
+    {
+        try
+        {
+            var path = ResolvePath();
+            RotateIfNeeded(path);
+            File.AppendAllText(
+                path,
+                DateTime.UtcNow.ToString("o") + " step: " + stage + Environment.NewLine,
+                Encoding.UTF8);
+        }
+        catch
+        {
+            // Diagnostics must never break the page they observe.
+        }
+    }
+
     private static void RotateIfNeeded(string path)
     {
         var info = new FileInfo(path);

src/CA-O.UI/ViewModels/OverclockViewModel.cs

@@ -272,9 +272,11 @@ private async Task RefreshAsync(CancellationToken ct)
         {
             Headline = Localizer.Get("overclock_title");
             StatusLine = Localizer.Get("overclock_probing");
+            CrashLog.Step("refresh.probe-start");
 
             // Vendor P/Invoke and WMI both block; none of them belong on the UI thread.
             var capabilities = await Task.Run(() => _registry.ProbeAll(ct), ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.probe-done");
 
             CpuKnobs.Clear();
             GpuKnobs.Clear();
@@ -313,15 +315,22 @@ private async Task RefreshAsync(CancellationToken ct)
                 }
             }
 
+            CrashLog.Step("refresh.rows-done");
             await FillReadingsAsync(ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.readings-done");
             await FillGamesAsync(ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.games-done");
 
             Summarize(capabilities);
             await LoadSavedDeltaAsync(ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.delta-done");
             await LoadCeilingsAsync(ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.ceilings-done");
             await LoadPendingRecoveriesAsync(ct).ConfigureAwait(true);
+            CrashLog.Step("refresh.recoveries-done");
 
             StatusLine = Localizer.Format("overclock_probe_done", capabilities.Knobs.Count);
+            CrashLog.Step("refresh.done");
         }
         catch (OperationCanceledException)
         {
@@ -330,6 +339,7 @@ private async Task RefreshAsync(CancellationToken ct)
         catch (Exception ex)
         {
             StatusLine = Localizer.Get("overclock_probe_failed");
+            CrashLog.Step("refresh.failed");
             CrashLog.Write(ex);
         }
         finally

tests/CA-O.UI.Tests/CrashLogStepTests.cs

@@ -0,0 +1,34 @@
+using CAO.UI.Helpers;
+using Xunit;
+
+namespace CAO.UI.Tests;
+
+/// <summary>El registrador black-box: cada fase del sondeo deja una miga para el siguiente crash nativo.</summary>
+public sealed class CrashLogStepTests
+{
+    [Fact]
+    public void Step_AppendsABreadcrumb_WithTheStageName()
+    {
+        var stage = "test-breadcrumb-" + Guid.NewGuid().ToString("N");
+        var path = Path.Combine(Path.GetTempPath(), "cao-step-" + Guid.NewGuid().ToString("N") + ".log");
+        CrashLog.LogPathOverride = path;
+        try
+        {
+            CrashLog.Step(stage);
+            Assert.Contains("step: " + stage, File.ReadAllText(path));
+        }
+        finally
+        {
+            CrashLog.LogPathOverride = null;
+        }
+
+        File.Delete(path);
+    }
+
+    [Fact]
+    public void Step_NeverThrows()
+    {
+        var ex = Record.Exception(() => CrashLog.Step("test-never-throws"));
+        Assert.Null(ex);
+    }
+}