docs(CHANGES): Document path contraction as breaking change for v1.41.x

why: Users consuming JSON/NDJSON output need to know about the change
what:
- Add Breaking Changes section to v1.41.x unreleased notes
- Document that all commands (list, status, sync) now use ~/
- Show before/after JSON examples
- Explain rationale: consistency, privacy, portability
- Note impact: automation may need to expand ~ if required

Breaking change: path field changed from /home/user/... to ~/...

Author: tony

CHANGES

@@ -31,7 +31,33 @@ $ pipx install --suffix=@next 'vcspull' --pip-args '\--pre' --force
 
 <!-- Maintainers, insert changes / features for the next release here -->
 
-_Notes on upcoming releases will be added here_
+### Breaking Changes
+
+#### JSON/NDJSON paths now use tilde notation
+
+**All commands** (`list`, `status`, `sync`) now contract home directory paths in JSON/NDJSON output for consistency, privacy, and portability.
+
+**Before:**
+```json
+{
+  "name": "flask",
+  "path": "/home/username/code/flask",
+  "workspace_root": "~/code/"
+}
+```
+
+**After:**
+```json
+{
+  "name": "flask",
+  "path": "~/code/flask",
+  "workspace_root": "~/code/"
+}
+```
+
+**Why:** The `workspace_root` field already used tilde notation in JSON output, creating an inconsistency. Full home paths (`/home/username/`) expose usernames and make output less portable between machines.
+
+**Impact:** Automation consuming JSON/NDJSON output will need to expand `~` to absolute paths if required. Most tools handle tilde expansion automatically.
 
 ## vcspull v1.40.0 (2025-10-19)