Function sanitize_option_fields

explainshell/extraction/llm/response.py:167–200

Fix common LLM mistakes in option fields. Returns (short, long, has_argument, positional, nested_cmd, prefix).

(
    short: list[str],
    long: list[str],
    has_argument: bool | list[str],
    positional: str | None,
    nested_cmd: bool,
    prefix: str | None = None,
)

def sanitize_option_fields(
    short: list[str],
    long: list[str],
    has_argument: bool | list[str],
    positional: str | None,
    nested_cmd: bool,
    prefix: str | None = None,
) -> tuple[list[str], list[str], bool | list[str], str | None, bool, str | None]:
    """Fix common LLM mistakes in option fields.

    Returns (short, long, has_argument, positional, nested_cmd, prefix).
    """
    if positional and (short or long):
        logger.debug(
            "clearing positional=%r on flagged option %s/%s", positional, short, long
        )
        positional = None

    if prefix and not positional:
        logger.debug("clearing prefix=%r on non-positional option", prefix)
        prefix = None

    if prefix and prefix not in models.OPTION_PREFIX_SIGILS:
        logger.debug(
            "dropping prefix=%r on positional %r: not in sigil allowlist",
            prefix,
            positional,
        )
        prefix = None

    if nested_cmd and not has_argument:
        has_argument = True

    return short, long, has_argument, positional, nested_cmd, prefix


def llm_option_to_store_option(