Method generate_slug

dev-tools/scripts/changes2logchange.py:326–361

Generate a slug from issue ID and title. Format: ISSUE-12345 short slug or VERSION entry 001 short slug Note: Previous slug formats used dashes ("ISSUE-12345-short-slug"), but this script now uses spaces between components (e.g., "ISSUE-12345 short slug"). Spaces ar

(issue_id: str, title: str)

    @staticmethod
    def generate_slug(issue_id: str, title: str) -> str:
        """
        Generate a slug from issue ID and title.

        Format: ISSUE-12345 short slug or VERSION entry 001 short slug
        Note: Previous slug formats used dashes ("ISSUE-12345-short-slug"), but this script now uses spaces between components (e.g., "ISSUE-12345 short slug").
        Spaces are preferred over dashes for improved readability, better preservation of word boundaries, and to avoid unnecessary character substitutions. This change also ensures that filenames remain filesystem-safe while being more human-friendly.
        Uses the actual issue ID without forcing SOLR- prefix
        Ensures filesystem-safe filenames and respects word boundaries
        Whitespace is preserved as spaces (not converted to dashes)
        """
        # Sanitize issue_id to remove unsafe characters (preserve case and # for readability)
        base_issue = SlugGenerator._sanitize_issue_id(issue_id)

        # Create slug from title: lowercase, preserve spaces, replace only unsafe chars with dash
        title_slug = SlugGenerator._sanitize_filename_part(title)

        # Limit to reasonable length while respecting word boundaries
        # Target max length: 50 chars for slug (leaving room for base_issue and space)
        if len(title_slug) > 50:
            # Find last word/space boundary within 50 chars
            truncated = title_slug[:50]
            # Find the last space within the limit
            last_space = truncated.rfind(' ')
            if last_space > 20:  # Keep at least 20 chars to avoid too-short slugs
                title_slug = truncated[:last_space]
            else:
                # If no good space boundary, try to find a dash (from unsafe chars)
                last_dash = truncated.rfind('-')
                if last_dash > 20:
                    title_slug = truncated[:last_dash]
                else:
                    # If no good boundary, use hard limit and clean up
                    title_slug = truncated.rstrip(' -')

        return f"{base_issue} {title_slug}"

    @staticmethod
    def _sanitize_issue_id(issue_id: str) -> str: