Usage: photoc [global options] review <directory> [--recursive] [--sort name|date] [--show all|unmarked|picked|rejected] [--images auto|iterm|none] [--state <file>]
       photoc review --help

Cull JPEGs in an interactive terminal session

Status: interactive review with optional iTerm images; writes review state only

Example:
  photoc review ./shoot
  photoc review ./shoot --images none
  photoc review ./shoot --recursive --sort date --show unmarked
  photoc review ./shoot --state ./review-state.json

Options:
  --recursive          Include nested directories
  --sort name|date     Sort by filename (default) or valid capture time
  --show all|unmarked|picked|rejected Filter navigation; counts cover all photos
  --images auto|iterm|none Inline images in iTerm (default: auto)
  --state <file>       Review state file (default: <directory>/.photoc-review.json)

Requires one directory; reviews regular .jpg/.jpeg files only.
Requires a terminal on stdin and stdout; --json is not supported.
Auto shows images only in direct iTerm2; other terminals get text only.
The iterm mode forces protocol output, not terminal support.
Keys: left/h previous, right/l/space next, p pick, x reject, u unmark,
i details, ? help, q quit. Marks are saved atomically before advancing.
Only review state is written; JPEG files are never changed.
