pub async fn create(
client: &DriveClient,
opts: &CreateOptions,
rules: &[FolderPermissionRule],
) -> CreateOutcomeExpand description
Creates opts.name inside opts.parent_folder_id, gated by
rules (the active account’s write_permissions.rules).
Every real (non-dry-run) attempt — created, blocked, or failed — is
logged via request_log::record_drive_mutation, even when the gate
refused before any Drive API call was made. A --dry-run preview is
never logged, matching drive move’s existing precedent (its CLI layer
calls file_move::plan but never execute under --dry-run, and only
execute logs).