release: v7.6.4 — Windows DR-stream guidance + combined demo SVG

Docs / help-text only. Flags PowerShell's `>` binary corruption pitfall
in the --stream help text and in DISASTER_RECOVERY.md, plus a 7-Zip
extraction note for AES-256 archives. Combines the 7 demo SVGs from
v7.6.2 into one 113-second sequential animation to keep the README
scrollable.

No code path, config, or repository format changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
TZERO78
2026-05-25 09:43:09 +00:00
parent 3193baeec4
commit 9746b6993e
5 changed files with 41 additions and 4 deletions
+37
View File
@@ -5,6 +5,43 @@ All notable changes to Kopi-Docka will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [7.6.4] - 2026-05-25
### 📚 Windows DR-stream guidance + single combined demo SVG
**Why:** A real user hit a confusing failure path on Windows:
`ssh ... disaster-recovery export --stream > recovery.zip` from
PowerShell produced a 14 KB file (twice the real size) that 7-Zip
rejected as "not an archive". Root cause is PowerShell 5.1's `>`
operator re-encoding stdout as UTF-16 LE — which corrupts the
binary stream. The same code path works fine from cmd.exe, scp, or
any Linux/macOS client. Separately, the seven demo SVGs added in
v7.6.2 stacked vertically and made the README scroll-heavy.
**Changes:**
- `--stream` `--help` text now flags the PowerShell pitfall right at
command-line discovery time and points at the DR docs.
- `README.md` gains an inline Windows note next to the SSH-stream
example and a stronger 7-Zip hint at the extraction step.
- `docs/DISASTER_RECOVERY.md` gets two new subsections under "SSH
Stream Mode": **Windows clients** (scp-from-server-side-file pattern,
cmd.exe `>` pattern, post-transfer byte-magic verification) and
**Extracting on Windows** (Explorer's lack of AES-256 ZIP support,
recommended tools: 7-Zip / NanaZip / WinRAR).
- README "What it looks like" replaces the 7 individual demo SVGs
with a single 113-second sequential animation
(`demo-combined.svg`, 743 KB) that plays all scenes back-to-back
with banner cards. The 7 individual SVGs are preserved and exposed
via a collapsible table for direct access.
**Upgrade notes:** Docs / help-text only. No code path, config, or
repository format changes — `pip install --upgrade kopi-docka` (or
`pipx upgrade kopi-docka`) to pick up the new `--help` output.
Windows users currently fighting PowerShell binary streams should
switch to one of the patterns in the docs.
---
## [7.6.3] - 2026-05-25
### 🐛 `disaster-recovery export --stream` no longer crashes on `Console.print(err=True)`
+1 -1
View File
@@ -6,7 +6,7 @@ Kopi-Docka is a Python CLI tool that wraps **Kopia** for encrypted, deduplicated
**Important**: This project will always be a Kopia wrapper. No second backup engine planned.
- **Version**: 7.6.3
- **Version**: 7.6.4
- **Python**: 3.10, 3.11, 3.12
- **License**: MIT
- **Author**: Markus F. (TZERO78)
+1 -1
View File
@@ -32,7 +32,7 @@ Notes:
from pathlib import Path
# Version information
VERSION = "7.6.3"
VERSION = "7.6.4"
# Backup Scope Levels
BACKUP_SCOPE_MINIMAL = "minimal" # Only volumes
+1 -1
View File
@@ -1,5 +1,5 @@
{
"version": "7.6.3",
"version": "7.6.4",
"kopia": {
"kopia_params": "filesystem --path /backup/kopia-repository",
"profile": "kopi-docka",
+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "kopi-docka"
version = "7.6.3"
version = "7.6.4"
description = "Robust cold backups for Docker environments using Kopia"
readme = "README.md"
requires-python = ">=3.10"