Skip to content

Conversation

@gilescope
Copy link

Fixes #205

When users provide an unknown flag (e.g., --if-exist instead of --if-exists), the error now includes a helpful suggestion pointing to the most similar valid flag.

Implementation details:

  • Added Levenshtein distance algorithm for string similarity matching
  • Extract valid flag names from struct tags using reflection
  • Wrap unknown flag errors with hints suggesting closest matches
  • Only suggest flags within reasonable edit distance to avoid unrelated suggestions

The suggestion mechanism uses the existing hint package to display helpful messages like "Did you mean '--if-exists'?" when typos occur.

This improves the developer experience, especially for newcomers who may make minor typos in flag names.

Fixes #205

When users provide an unknown flag (e.g., --if-exist instead of
--if-exists), the error now includes a helpful suggestion pointing
to the most similar valid flag.

Implementation details:
- Added Levenshtein distance algorithm for string similarity matching
- Extract valid flag names from struct tags using reflection
- Wrap unknown flag errors with hints suggesting closest matches
- Only suggest flags within reasonable edit distance to avoid
  unrelated suggestions

The suggestion mechanism uses the existing hint package to display
helpful messages like "Did you mean '--if-exists'?" when typos occur.

This improves the developer experience, especially for newcomers who
may make minor typos in flag names.
@gemini-code-assist
Copy link

Summary of Changes

Hello @gilescope, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the command-line interface's robustness and user-friendliness by automatically suggesting correct flag names when a user makes a typo. By leveraging string similarity algorithms and reflection, it provides intelligent, context-aware feedback, making the tool more forgiving and easier to use for both new and experienced users.

Highlights

  • Unknown Flag Suggestions: Introduces a 'Did you mean?' suggestion feature for command-line flags when an unknown flag is provided, improving user experience by guiding them to correct flag usage.
  • Levenshtein Distance Algorithm: Implements the Levenshtein distance algorithm to calculate string similarity, which is used to find the closest matching valid flag for a given unknown flag.
  • Reflection-based Flag Extraction: Utilizes Go's reflection capabilities to dynamically extract valid flag names from struct tags, ensuring that suggestions are based on the actual defined flags.
  • Intelligent Suggestion Filtering: Suggestions are only provided if the unknown flag is within a reasonable edit distance (less than half the length of the unknown flag, with a minimum of 2) from a valid flag, preventing irrelevant suggestions.
  • Error Wrapping with Hints: Integrates with the existing hint package to wrap unknown flag errors, appending the 'Did you mean --flag-name?' message to the error output.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link

github-actions bot commented Jan 10, 2026

➖ Are we earthbuild yet?

No change in "earthly" occurrences

📈 Overall Progress

Branch Total Count
main 5731
This PR 5731
Difference +0

Keep up the great work migrating from Earthly to Earthbuild! 🚀

💡 Tips for finding more occurrences

Run locally to see detailed breakdown:

./.github/scripts/count-earthly.sh

Note that the goal is not to reach 0.
There is anticipated to be at least some occurences of earthly in the source code due to backwards compatibility with config files and language constructs.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a 'Did you mean?' feature for unknown command-line flags, which is a great improvement for user experience. The implementation uses the Levenshtein distance algorithm to find the closest match. My review focuses on improving the robustness and efficiency of the new implementation. I've suggested using type assertion for error handling instead of string matching for better resilience, and an optimization for the Levenshtein distance algorithm to reduce memory usage. The added tests are comprehensive and cover the new functionality well.


// findClosestFlag finds the most similar flag name to the given unknown flag.
// Returns the suggested flag and whether a good suggestion was found.
func findClosestFlag(unknownFlag string, validFlags []string) (string, bool) {
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bool is redundant. The empty string indicates that no closest match was found.


// extractUnknownFlagFromError extracts the flag name from an "unknown flag" error.
// Uses type assertion to check for the specific error type from go-flags library.
func extractUnknownFlagFromError(err error) (string, bool) {
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here, bool is redundant

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

unknown argument makes no suggestions

3 participants