chore: initial sanitized public snapshot

docs/compatibility/goldens/README.md

@@ -0,0 +1,28 @@
+# CLI Golden Snapshots
+
+This directory stores evidence-backed CLI compatibility snapshots captured from:
+
+- upstream Windows aria2 `1.37.0`
+- the current local `aria2-rust-pro` binary
+
+The current capture script is:
+
+- `xtask compat capture-cli-goldens`
+- `scripts/compat/capture-cli-goldens.ps1` (thin compatibility shim)
+
+It writes:
+
+- `cli/upstream/version.txt`
+- `cli/upstream/help-all.txt`
+- `cli/rust/version.txt`
+- `cli/rust/help-all.txt`
+- `cli/manifest.json`
+
+Run it from the repo root with:
+
+```powershell
+rtk cargo run --manifest-path .\xtask\Cargo.toml -- compat capture-cli-goldens
+powershell -NoProfile -File .\scripts\compat\capture-cli-goldens.ps1
+```
+
+These files are evidence. They do not claim parity by themselves.