Function _subset_has_cross_reference

explainshell/extraction/postprocess.py:94–113

Check if subset's description mentions any of the superset's extra flags. This guards against false-positive subset merges that occur when the LLM normalises dashless BSD options (e.g. ``U`` → ``-U``), creating spurious flag overlaps with genuinely different POSIX options (e.g. ``-U``/`

(subset: Option, extra_flags: frozenset[str])

def _subset_has_cross_reference(subset: Option, extra_flags: frozenset[str]) -> bool:
    """Check if subset's description mentions any of the superset's extra flags.

    This guards against false-positive subset merges that occur when the LLM
    normalises dashless BSD options (e.g. ``U`` → ``-U``), creating spurious
    flag overlaps with genuinely different POSIX options (e.g. ``-U``/``--User``).
    Legitimate duplicates typically cross-reference the other entry's flags
    ("Identical to -M", "same as --sort").

    Flags are matched with non-alphanumeric boundaries so that bare
    single-letter flags like ``k`` do not match inside ordinary words
    ("work", "make") and flag prefixes like ``-M`` do not match inside
    longer tokens.
    """
    desc = subset.text
    for flag in extra_flags:
        pattern = r"(?<![a-zA-Z0-9\-])" + re.escape(flag) + r"(?![a-zA-Z0-9\-])"
        if re.search(pattern, desc):
            return True
    return False


def dedup_options(options: list[Option]) -> tuple[list[Option], int]: