From 5b03fd8ebc836b5c358964e98be01ea031c66210 Mon Sep 17 00:00:00 2001
From: Matthew Jackson <1085847+MattJackson@users.noreply.github.com>
Date: Wed, 22 Jul 2026 13:45:15 -0700
Subject: [PATCH] libfreemkv: 1.5.2 changelog reflects the shipped
 playback-order crack

The prior wording described the round-1 'self-cracking per-sector' approach
that the audit replaced; rewrite it to match what ships (per-title crack in
playback order + scan-key reuse + loud hard-fail on an uncrackable title).
---
 CHANGELOG.md | 22 ++++++----------------
 1 file changed, 6 insertions(+), 16 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3386177..290ce09 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,25 +4,15 @@
 
 ### Fixed
 
-- **A CSS DVD whose main title opens with a long unscrambled run no longer
-  produces a silent garbage MKV.** The mux resolved a DVD's descramble key from
-  an up-front detection pass that scanned the title's largest cell first and gave
-  up after a fixed budget; a feature cell that begins with a long clear stretch
-  (well over that budget) was read as "unencrypted", so the muxer passed the
-  still-scrambled sectors through as plaintext and exited 0 with corrupt video.
-  A DVD now always muxes through the self-contained CSS descramble path, which
-  checks each sector's own scramble flag and re-cracks the per-region title key
-  from the data itself — no up-front key, no detection gate. A clear DVD is a
-  per-sector no-op; an encrypted one self-recovers, including across VOB/VTS key
-  changes; a detection miss can no longer route scrambled data to the muxer.
+- CSS DVDs whose main title opens with a long clear run no longer mux to garbage.
+  The key crack scanned the largest cell first and gave up in its clear prefix, so
+  the scrambled feature was muxed as plaintext at exit 0. The per-title key is now
+  reused from the scan when it covers the title's VTS, else cracked from the
+  title's extents in playback order; an uncrackable title hard-fails (E7023).
 
 ### Changed
 
-- The per-rip unlocker report renames the DVD entry **CSS → DVD** and now
-  reflects the bus-auth that actually ran (it engages on any DVD to clear the
-  drive's scrambled-read barrier), rather than whether a title-key crack happened
-  to succeed. An encrypted DVD that reads and muxes fine previously showed
-  `CSS: no`; it now correctly shows `DVD: yes`.
+- Unlocker report: the DVD entry is renamed `CSS` → `DVD`.
 
 ## [1.5.1] — 2026-07-20