Add hint for misplaced --verbose in uv tool run

[F4RAN]

Resolves #16777

Summary

When a command fails, users sometimes add --verbose after the package name (e.g., uvx foo --verbose) instead of before it (e.g., uvx --verbose foo). This adds a hint that suggests moving --verbose before the command.
The hint appears when a verbose flag is detected in the subcommand arguments and the command fails to resolve. It works for both uvx and uv tool run.

Test Plan

Tested by running:
uvx foo-does-not-exist --verbose - shows the hint
uv tool run foo-does-not-exist --verbose - shows the hint
The hint only appears when verbose flags are detected, and the message shows the correct command format.

Screenshot

Open to feedback and happy to make changes as needed! 💯

[EliteTK]

@F4RAN thanks for this.

Aside from the review comment, do you mind adding a test?

There are a few examples in crates/uv/tests/it/tool_run.rs.

[zanieb]

nit: I might use let Some(...) = ... else { continue } just to reduce nesting

[F4RAN]

Used ? operator instead of let...else (clippy also suggested this)

[zanieb]

nit: I might write this using args.iter().find(...) instead?

[F4RAN]

Refactored to use find_map as suggested

[F4RAN]

@F4RAN thanks for this.

Aside from the review comment, do you mind adding a test?

There are a few examples in crates/uv/tests/it/tool_run.rs.

Hi @EliteTK and @zanieb. Thanks for reviewing my code.

1. Added tests for --verbose, -v, and -vv flags - all passing now!
2. Added doc comment for find_verbose_flag function
3. Refactored to use find_map as suggested
4. Used ? operator instead of let...else (clippy also suggested this)

All feedback addressed! Happy to make any additional changes if needed.

[EliteTK]

@F4RAN thanks for sorting those out. I've pushed a couple of commits to drop the filter as it's not something we normally do in the test suite and add a test case for the potential false positive case.

I've made a note to create an issue regarding the OperationDiagnostic problems once this is merged so I can reference the affected code.