RSDK-9287: standardize command flags

[purplenicole730]

Ticket

Changes:

• make a generic name flag
• add aliases to organization, location, machine, and part flags
• specify flag id or name depending on usage

Testing:
NOTE: The name changes were NOT tested since nothing changed other than var name

• locally ran all commands with a combination of aliases

rdk % go run ./cli/viam machines list --help              
NAME:
   viam machines list - list machines in an organization and location

USAGE:
   viam machines list [command options] [arguments...]

OPTIONS:
   --location value, --location-id value, --location-name value         (default: first location alphabetically)
   --organization value, --org value, --org-id value, --org-name value  (default: first organization alphabetically)

rdk % go run ./cli/viam machines list --org <...> --location <...>
<...> (id: <...>)

rdk % go run ./cli/viam machines list --organization <...> --location-name <...>
<...> (id: <...>)

rdk % go run ./cli/viam machines list --org-id <...> --location-id <...>
<...> (id: <...>)

rdk % go run ./cli/viam machines api-key create --organization <...> --name test --machine <...>
Error: Rpc error: code = InvalidArgument desc = mongo: no documents in result

rdk % go run ./cli/viam machines api-key create --machine <...> --name "test" --org <...>
Info: Successfully created key:
Key ID: <...>
Key Value: <...>
Warning: Keep this key somewhere safe; it has full write access to your machine

rdk % go run ./cli/viam machines status --org-id <...> --location-id <...> --machine-id <...>
ID: <...>
Name: <...>
Last Access: Mon Jan  6 16:13:51 UTC 2025 (855.467ms ago)
Parts:
        ID: <...>
        Name: <...>-main (main)
        Last Access: Mon Jan  6 16:13:51 UTC 2025 (855.467ms ago)

rdk % go run ./cli/viam machines status --organization  <...> --location-name <...> --machine <...>
ID: <...>
Name: <...>
Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h43m4.073189s ago)
Parts:
        ID: <...>
        Name: <...>-main (main)
        Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h43m4.073248s ago)

rdk % go run ./cli/viam machines status --organization  <...> --location <...> --machine-name <...>
ID: <...>
Name: <...>
Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h43m4.073189s ago)
Parts:
        ID: <...>
        Name: <...>-main (main)
        Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h43m4.073248s ago)

rdk % go run ./cli/viam machines logs --org <...> --location <...> --machine <...> --errors --count 2
<...>-main
        No recent logs

rdk % go run ./cli/viam machines part status --org <...> --location <...> --machine <...> --part <...>
ID: <...>
Name: <...>-main (main)
Last Access: Mon Jan  6 16:20:59 UTC 2025 (342.901ms ago)

rdk % go run ./cli/viam machines part status --org-id <...> --location-id <...> --machine-id <...> --part-id <...>
ID: <...>
Name: <...>-main (main)
Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h44m52.376819s ago)

rdk % go run ./cli/viam machines part status --organization <...> --location-name <...> --machine-name <...> --part-name <...>
ID: <...>
Name: <...>-main (main)
Last Access: Mon Jan  6 16:27:41 UTC 2025 (1h46m3.162506s ago)

rdk % go run ./cli/viam machines part logs --org <...> --location <...> --machine <...> --part <...> --errors --count 2
No recent logs

rdk % go run ./cli/viam machines part restart --org <...> --location <...> --machine <...> --part-id <...>
Info: Request to restart part sent successfully

rdk % go run ./cli/viam machines part run --org-id <...> --location-name <...> --machine-id <...> --part-id <...> --data '{"name": "motor1"}'  viam.component.motor.v1.MotorService.IsPowered  
{
  "isOn": false,
  "powerPct": 0
}

rdk % go run ./cli/viam machines part shell --org-id <...> --location-name <...> --machine-id <...> --part-id <...>                
Info: Ensure machine part has a valid shell type service
Error: Shell service is not enabled on this machine part
exit status 1

rdk % go run ./cli/viam machines part cp --organization <...> --location-name <...> --machine <...> --part-name <...> my_file machine:/home/user/
Error: Shell service is not enabled on this machine part
exit status 1

[njooma]

nice

[stuqdog]

lgtm!