photoanalyzer/delivery_backlog/stories/US04-01-rename-plan.md

US04-01 — Build and Export Rename Plans

Epic: E04

As a user, I want a complete validated rename plan before mutation so I can understand every source, destination, collision, and blocker.

Acceptance criteria

• Approved album proposals produce itemized plans with asset IDs, source/destination, expected hashes, versions, and required operations.
• Validation detects missing/changed sources, duplicate targets, case-only and Unicode collisions, root escapes, symlinks, and cross-filesystem behavior.
• A portable JSON export contains no credentials and has a schema version/checksum.

Automated tests

• Property tests validate collision-free plans and asset-set preservation.
• API/golden tests cover valid, invalid, stale, case-only, Unicode, and exported plans.

Dependencies

• E03 complete