photoanalyzer/delivery_backlog/stories/US05-01-upload-preflight.md

US05-01 — Validate Credentials and Upload Readiness

Epic: E05

As a user, I want upload blockers and scope validated before execution so unverified or changed files never reach Immich accidentally.

Acceptance criteria

• Preflight checks credentials without exposing them, server reachability, selected album scope, canonical/safety/analysis/EXIF readiness, and current byte hashes.
• The redacted command preview shows exact folders, album mapping, and asset counts.
• Partial scope and every blocker require explicit resolution or approved policy.
• Preflight produces a versioned token invalidated by relevant changes.

Automated tests

• Integration tests cover valid, missing/invalid credential, blocked stage, changed bytes, partial album, stale token, and secret redaction.

Dependencies

• E04 complete