Use apple finder --help and subcommand help as the first reference.
Common reads:
apple finder items list --path . --json
apple finder items metadata --path Package.swift --json
apple finder items search --path . --query README --jsonFile actions and mutations use the DryRun safety flow:
apple finder items reveal --path Package.swift --dry-run --json
apple finder items move --path old.txt --to new.txt --dry-run --jsonThe detailed capability boundary lives in
../../Architecture/Finder/CapabilityList.md.