claude-team-mcp 0.4.0__py3-none-any.whl

claude_team_mcp/names.py

@@ -0,0 +1,427 @@
+"""Iconic names module for assigning memorable session names."""
+
+import random
+
+# =============================================================================
+# NAME SETS ORGANIZED BY SIZE
+# =============================================================================
+
+# Solo icons - artists known by one name
+SOLOS: dict[str, list[str]] = {
+    "cher": ["Cher"],
+    "madonna": ["Madonna"],
+    "prince": ["Prince"],
+    "beyonce": ["Beyoncé"],
+    "bono": ["Bono"],
+    "sting": ["Sting"],
+    "liberace": ["Liberace"],
+    "elvis": ["Elvis"],
+    "adele": ["Adele"],
+    "rihanna": ["Rihanna"],
+    "shakira": ["Shakira"],
+    "banksy": ["Banksy"],
+    "voltaire": ["Voltaire"],
+    "aristotle": ["Aristotle"],
+    "plato": ["Plato"],
+    "socrates": ["Socrates"],
+    "rembrandt": ["Rembrandt"],
+    "michelangelo": ["Michelangelo"],
+    "napoleon": ["Napoleon"],
+    "cleopatra": ["Cleopatra"],
+    "gandhi": ["Gandhi"],
+    "pele": ["Pelé"],
+    "ronaldinho": ["Ronaldinho"],
+    "zendaya": ["Zendaya"],
+    "lizzo": ["Lizzo"],
+    "bjork": ["Björk"],
+    "moby": ["Moby"],
+    "seal": ["Seal"],
+    "enya": ["Enya"],
+    "yanni": ["Yanni"],
+    # International artists
+    "sade": ["Sade"],
+    "stromae": ["Stromae"],
+    "lorde": ["Lorde"],
+    # Historical/cultural icons
+    "confucius": ["Confucius"],
+    "nefertiti": ["Nefertiti"],
+    "hypatia": ["Hypatia"],
+    "frida": ["Frida"],
+    "oprah": ["Oprah"],
+    "basquiat": ["Basquiat"],
+    "hokusai": ["Hokusai"],
+    # Fiction
+    "hiro": ["Hiro Protagonist"],
+    "wishbone": ["Wishbone"],
+    # Philosophy
+    "sartre": ["Sartre"],
+    "negarestani": ["Negarestani"],
+}
+
+# Dynamic duos - iconic pairs
+DUOS: dict[str, list[str]] = {
+    "abbott_costello": ["Abbott", "Costello"],
+    "simon_garfunkel": ["Simon", "Garfunkel"],
+    "laurel_hardy": ["Laurel", "Hardy"],
+    "bonnie_clyde": ["Bonnie", "Clyde"],
+    "thelma_louise": ["Thelma", "Louise"],
+    "tom_jerry": ["Tom", "Jerry"],
+    "batman_robin": ["Batman", "Robin"],
+    "bert_ernie": ["Bert", "Ernie"],
+    "cheech_chong": ["Cheech", "Chong"],
+    "penn_teller": ["Penn", "Teller"],
+    "chip_dale": ["Chip", "Dale"],
+    "ren_stimpy": ["Ren", "Stimpy"],
+    "pinky_brain": ["Pinky", "Brain"],
+    "rick_morty": ["Rick", "Morty"],
+    "beavis_butthead": ["Beavis", "Butthead"],
+    "starsky_hutch": ["Starsky", "Hutch"],
+    "cagney_lacey": ["Cagney", "Lacey"],
+    "tango_cash": ["Tango", "Cash"],
+    "rocky_bullwinkle": ["Rocky", "Bullwinkle"],
+    "calvin_hobbes": ["Calvin", "Hobbes"],
+    "mario_luigi": ["Mario", "Luigi"],
+    "sonic_tails": ["Sonic", "Tails"],
+    "sherlock_watson": ["Sherlock", "Watson"],
+    "frodo_sam": ["Frodo", "Sam"],
+    "han_chewie": ["Han", "Chewie"],
+    "r2_3po": ["R2D2", "C-3PO"],
+    "bill_ted": ["Bill", "Ted"],
+    "wayne_garth": ["Wayne", "Garth"],
+    "blues_brothers": ["Jake", "Elwood"],
+    "key_peele": ["Key", "Peele"],
+    "hall_oates": ["Hall", "Oates"],
+    "outkast": ["André", "Big Boi"],
+    "daft_punk": ["Thomas", "Guy-Man"],
+    "flight_concords": ["Bret", "Jemaine"],
+    "odd_couple": ["Oscar", "Felix"],
+    "peanut_butter_jelly": ["PB", "J"],
+    "salt_pepa": ["Salt", "Pepa"],
+    "milli_vanilli": ["Fab", "Rob"],
+    "wham": ["George", "Andrew"],
+    # Literature & mythology
+    "don_sancho": ["Don Quixote", "Sancho"],
+    "romeo_juliet": ["Romeo", "Juliet"],
+    # Film
+    "jules_vincent": ["Jules", "Vincent"],
+    # Gaming
+    "ratchet_clank": ["Ratchet", "Clank"],
+    "jak_daxter": ["Jak", "Daxter"],
+    "goku_vegeta": ["Goku", "Vegeta"],
+    # Science & innovation
+    "wright_bros": ["Orville", "Wilbur"],
+    "jobs_woz": ["Steve", "Woz"],
+    # Philosophy
+    "phil_science": ["Peirce", "Kuhn"],
+    "pragmatists": ["James", "Rorty"],
+    "d_and_g": ["Deleuze", "Guattari"],
+    # TV
+    "tia_tamera": ["Tia", "Tamera"],
+    "statler_waldorf": ["Statler", "Waldorf"],
+    "laverne_shirley": ["Laverne", "Shirley"],
+    # Star Trek
+    "kirk_khan": ["Kirk", "Khan"],
+    "picard_q": ["Picard", "Q"],
+}
+
+# Terrific trios - famous threesomes
+TRIOS: dict[str, list[str]] = {
+    "three_stooges": ["Larry", "Moe", "Curly"],
+    "destinys_child": ["Beyoncé", "Kelly", "Michelle"],
+    "nirvana": ["Kurt", "Krist", "Dave"],
+    "the_police": ["Sting", "Andy", "Stewart"],
+    "bee_gees": ["Barry", "Robin", "Maurice"],
+    "rush": ["Geddy", "Alex", "Neil"],
+    "cream": ["Eric", "Jack", "Ginger"],
+    "zz_top": ["Billy", "Dusty", "Frank"],
+    "green_day": ["Billie", "Mike", "Tré"],
+    "blink_182": ["Mark", "Tom", "Travis"],
+    "tlc": ["T-Boz", "Left Eye", "Chilli"],
+    "supremes": ["Diana", "Mary", "Florence"],
+    "charlie_angels": ["Kelly", "Jill", "Sabrina"],
+    "powerpuff_girls": ["Blossom", "Bubbles", "Buttercup"],
+    "oai_research": ["Ilya", "Dario", "Sam"],
+    "southern_reach": ["Biologist", "Control", "Saul"],
+    "homeward_bound": ["Shadow", "Chance", "Sassy"],
+    "john_dies": ["David", "John", "Amy"],
+    "totoro": ["Satsuki", "Mei", "Totoro"],
+    "trio_mandili": ["Tatuli", "Tako", "Mariam"],
+    # Philosophy
+    "vienna_circle": ["Carnap", "Schlick", "Neurath"],
+    "ccru": ["Land", "Plant", "Fisher"],
+    # Film
+    "stalker": ["Stalker", "Writer", "Professor"],
+    # Horror
+    "pontypool": ["Grant", "Sydney", "Laurel-Ann"],
+    # TV/Animation
+    "ed_edd_eddy": ["Ed", "Edd", "Eddy"],
+    "chipettes": ["Brittany", "Jeanette", "Eleanor"],
+    "chipmunks": ["Alvin", "Simon", "Theodore"],
+    "animaniacs": ["Yakko", "Wakko", "Dot"],
+    "three_musketeers": ["Athos", "Porthos", "Aramis"],
+    "three_tenors": ["Luciano", "Plácido", "José"],
+    "three_amigos": ["Lucky", "Dusty", "Ned"],
+    "hanson": ["Isaac", "Taylor", "Zac"],
+    "jonas_brothers": ["Kevin", "Joe", "Nick"],
+    "dixie_chicks": ["Natalie", "Martie", "Emily"],
+    "trinity": ["Neo", "Trinity", "Morpheus"],
+    "good_bad_ugly": ["Blondie", "Angel Eyes", "Tuco"],
+    "ghostbusters_og": ["Peter", "Ray", "Egon"],
+    "hp_trio": ["Harry", "Ron", "Hermione"],
+    "lotr_hunters": ["Aragorn", "Legolas", "Gimli"],
+    "fairly_odd": ["Timmy", "Cosmo", "Wanda"],
+    # Mythology & folklore
+    "three_fates": ["Clotho", "Lachesis", "Atropos"],
+    "norns": ["Urd", "Verdandi", "Skuld"],
+    "trimurti": ["Brahma", "Vishnu", "Shiva"],
+    # Literature
+    "bronte_sisters": ["Charlotte", "Emily", "Anne"],
+    # Gaming & anime
+    "triforce": ["Link", "Zelda", "Ganon"],
+    "team_rocket": ["Jessie", "James", "Meowth"],
+    "sannin": ["Jiraiya", "Tsunade", "Orochimaru"],
+    # TV
+    "top_gear": ["Jeremy", "Richard", "James"],
+    "trailer_park": ["Julian", "Ricky", "Bubbles"],
+    "totally_spies": ["Sam", "Clover", "Alex"],
+}
+
+# Fabulous fours - quartets
+QUARTETS: dict[str, list[str]] = {
+    "beatles": ["John", "Paul", "George", "Ringo"],
+    "tmnt": ["Leonardo", "Donatello", "Raphael", "Michelangelo"],
+    "fantastic_four": ["Reed", "Sue", "Johnny", "Ben"],
+    "a_team": ["Hannibal", "Face", "Murdock", "B.A."],
+    "marx_brothers": ["Groucho", "Harpo", "Chico", "Zeppo"],
+    "ghostbusters": ["Peter", "Ray", "Egon", "Winston"],
+    "hogwarts_founders": ["Godric", "Helga", "Rowena", "Salazar"],
+    "horsemen": ["Conquest", "War", "Famine", "Death"],
+    "golden_girls": ["Dorothy", "Rose", "Blanche", "Sophia"],
+    "sex_city": ["Carrie", "Samantha", "Charlotte", "Miranda"],
+    "queen": ["Freddie", "Brian", "Roger", "John"],
+    "led_zeppelin": ["Robert", "Jimmy", "John Paul", "Bonzo"],
+    "metallica": ["James", "Lars", "Kirk", "Robert"],
+    "u2": ["Bono", "Edge", "Adam", "Larry"],
+    "red_hot_chili_peppers": ["Anthony", "Flea", "Chad", "John"],
+    "coldplay": ["Chris", "Jonny", "Guy", "Will"],
+    "radiohead_core": ["Thom", "Jonny", "Colin", "Ed"],
+    "south_park": ["Stan", "Kyle", "Cartman", "Kenny"],
+    "seinfeld": ["Jerry", "George", "Elaine", "Kramer"],
+    "wizard_oz": ["Dorothy", "Scarecrow", "Tinman", "Lion"],
+    "big_bang": ["Sheldon", "Leonard", "Howard", "Raj"],
+    "who": ["Roger", "Pete", "John", "Keith"],
+    "kiss": ["Gene", "Paul", "Ace", "Peter"],
+    "motley_crue": ["Vince", "Nikki", "Mick", "Tommy"],
+    "van_halen": ["David", "Eddie", "Alex", "Michael"],
+    "doors": ["Jim", "Ray", "Robby", "John"],
+    "monkees": ["Davy", "Micky", "Michael", "Peter"],
+    "crosby_stills": ["David", "Stephen", "Graham", "Neil"],
+    "it_crowd": ["Roy", "Moss", "Jen", "Richmond"],
+    "mst3k": ["Cambot", "Tom", "Gypsy", "Crow"],
+    # Philosophy
+    "frankfurt_school": ["Adorno", "Horkheimer", "Marcuse", "Benjamin"],
+    # Mythology
+    "cardinal_virtues": ["Prudence", "Justice", "Temperance", "Fortitude"],
+    "four_winds": ["Boreas", "Notus", "Eurus", "Zephyrus"],
+    # Anime
+    "team_avatar": ["Aang", "Katara", "Sokka", "Toph"],
+    "cowboy_bebop": ["Spike", "Jet", "Faye", "Ed"],
+    # TV comedy
+    "its_sunny": ["Dennis", "Mac", "Charlie", "Dee"],
+    "impractical": ["Joe", "Murr", "Sal", "Q"],
+    "schitts_creek": ["Johnny", "Moira", "David", "Alexis"],
+    # Music
+    "abba": ["Agnetha", "Björn", "Benny", "Frida"],
+    "black_sabbath": ["Ozzy", "Tony", "Geezer", "Bill"],
+    # Historical
+    "mount_rushmore": ["Washington", "Jefferson", "Roosevelt", "Lincoln"],
+}
+
+# Famous fives - quintets
+QUINTETS: dict[str, list[str]] = {
+    "spice_girls": ["Scary", "Sporty", "Baby", "Ginger", "Posh"],
+    "breakfast_club": ["Brain", "Athlete", "Basket Case", "Princess", "Criminal"],
+    "jackson_5": ["Jackie", "Tito", "Jermaine", "Marlon", "Michael"],
+    "nsync": ["Justin", "JC", "Chris", "Joey", "Lance"],
+    "backstreet_boys": ["AJ", "Howie", "Nick", "Kevin", "Brian"],
+    "one_direction": ["Harry", "Niall", "Liam", "Louis", "Zayn"],
+    "new_kids": ["Donnie", "Jordan", "Joey", "Jonathan", "Danny"],
+    "new_edition": ["Bobby", "Ralph", "Ricky", "Michael", "Ronnie"],
+    "temptations": ["Eddie", "David", "Otis", "Paul", "Melvin"],
+    "aerosmith": ["Steven", "Joe", "Tom", "Joey", "Brad"],
+    "rolling_stones": ["Mick", "Keith", "Charlie", "Ron", "Bill"],
+    "maroon_5_core": ["Adam", "Jesse", "Mickey", "James", "Matt"],
+    "ac_dc": ["Angus", "Malcolm", "Brian", "Cliff", "Phil"],
+    "foo_fighters_core": ["Dave", "Nate", "Taylor", "Pat", "Chris"],
+    "grateful_dead_core": ["Jerry", "Bob", "Phil", "Bill", "Mickey"],
+    "power_rangers_og": ["Jason", "Trini", "Zack", "Billy", "Kimberly"],
+    "voltron_force": ["Keith", "Lance", "Pidge", "Hunk", "Allura"],
+    "planeteers": ["Kwame", "Wheeler", "Linka", "Gi", "Ma-Ti"],
+    "scooby_gang": ["Fred", "Daphne", "Velma", "Shaggy", "Scooby"],
+    "queer_eye_og": ["Ted", "Kyan", "Thom", "Carson", "Jai"],
+    "rat_pack": ["Frank", "Dean", "Sammy", "Peter", "Joey"],
+    "yamadas": ["Takashi", "Matsuko", "Shige", "Noboru", "Nonoko"],
+}
+
+# Larger ensembles for flexibility
+LARGER: dict[str, list[str]] = {
+    "monty_python": ["Chapman", "Cleese", "Gilliam", "Idle", "Jones", "Palin"],
+    "friends": ["Rachel", "Monica", "Phoebe", "Ross", "Joey", "Chandler"],
+    "ocean_eleven": [
+        "Danny", "Rusty", "Linus", "Basher", "Yen",
+        "Virgil", "Turk", "Frank", "Reuben", "Livingston", "Saul",
+    ],
+    "fellowship": [
+        "Frodo", "Sam", "Merry", "Pippin", "Gandalf",
+        "Aragorn", "Legolas", "Gimli", "Boromir",
+    ],
+    "avengers_og": [
+        "Tony", "Steve", "Thor", "Bruce", "Natasha", "Clint",
+    ],
+    "justice_league_core": [
+        "Clark", "Bruce", "Diana", "Barry", "Arthur", "Victor", "Hal",
+    ],
+    "x_men_og": [
+        "Charles", "Scott", "Jean", "Hank", "Bobby", "Warren",
+    ],
+    "brady_bunch": [
+        "Mike", "Carol", "Greg", "Marcia", "Peter",
+        "Jan", "Bobby", "Cindy",
+    ],
+    "simpsons": ["Homer", "Marge", "Bart", "Lisa", "Maggie"],
+    "parks_rec": ["Leslie", "Ron", "Tom", "April", "Andy", "Ben", "Ann"],
+    "office_core": ["Michael", "Jim", "Pam", "Dwight", "Angela", "Kevin", "Oscar"],
+    "stranger_things_kids": ["Mike", "Eleven", "Dustin", "Lucas", "Will", "Max"],
+    "goonies": ["Mikey", "Mouth", "Chunk", "Data", "Brand", "Andy", "Stef"],
+    "lost_boys": ["Michael", "Star", "Sam", "Edgar", "Alan", "Laddie"],
+    "sandlot": ["Scotty", "Benny", "Ham", "Squints", "Yeah-Yeah", "Kenny", "Bertram", "Timmy", "Tommy"],
+    "mighty_ducks": ["Charlie", "Adam", "Fulton", "Goldberg", "Jesse", "Guy", "Connie", "Averman"],
+}
+
+# Combined lookup for all sizes
+SETS_BY_SIZE: dict[int, dict[str, list[str]]] = {
+    1: SOLOS,
+    2: DUOS,
+    3: TRIOS,
+    4: QUARTETS,
+    5: QUINTETS,
+}
+
+# Legacy combined dict for backward compatibility
+NAME_SETS: dict[str, list[str]] = {}
+for size_dict in [SOLOS, DUOS, TRIOS, QUARTETS, QUINTETS, LARGER]:
+    NAME_SETS.update(size_dict)
+
+
+def get_name_set(name: str) -> list[str]:
+    """Get names from a specific set.
+
+    Args:
+        name: The name of the set (e.g., "beatles", "tmnt")
+
+    Returns:
+        List of names in the set
+
+    Raises:
+        KeyError: If the set name doesn't exist
+    """
+    return NAME_SETS[name]
+
+
+def pick_names_for_count(count: int) -> tuple[str, list[str]]:
+    """Pick a name set that matches the requested count.
+
+    For counts 1-5, picks a random set of exactly that size.
+    For counts > 5, combines sets to reach the target count.
+
+    Args:
+        count: Number of names needed
+
+    Returns:
+        Tuple of (set_description, list of names)
+    """
+    if count <= 0:
+        return ("empty", [])
+
+    if count <= 5:
+        # Pick a random set of exactly this size
+        size_sets = SETS_BY_SIZE[count]
+        set_name = random.choice(list(size_sets.keys()))
+        return (set_name, list(size_sets[set_name]))
+
+    # For count > 5, combine sets
+    names: list[str] = []
+    set_names: list[str] = []
+    remaining = count
+
+    while remaining > 0:
+        if remaining >= 5:
+            # Add a quintet
+            set_name = random.choice(list(QUINTETS.keys()))
+            names.extend(QUINTETS[set_name])
+            set_names.append(set_name)
+            remaining -= 5
+        elif remaining in SETS_BY_SIZE:
+            # Add a set of exact size
+            size_sets = SETS_BY_SIZE[remaining]
+            set_name = random.choice(list(size_sets.keys()))
+            names.extend(size_sets[set_name])
+            set_names.append(set_name)
+            remaining = 0
+        else:
+            # Should not happen for counts 1-5, but just in case
+            # Use a larger set and take what we need
+            if remaining > 5:
+                larger_name = random.choice(list(LARGER.keys()))
+                larger_set = LARGER[larger_name]
+                take = min(remaining, len(larger_set))
+                names.extend(larger_set[:take])
+                set_names.append(larger_name)
+                remaining -= take
+            else:
+                break
+
+    combined_name = " + ".join(set_names)
+    return (combined_name, names)
+
+
+def pick_names(count: int, name_set: str | None = None) -> list[str]:
+    """Pick N names from a set, using size-matched selection when no set specified.
+
+    Args:
+        count: Number of names to pick
+        name_set: Optional set name. If None, picks a size-matched set.
+
+    Returns:
+        List of names (may combine sets if count > set size)
+
+    Raises:
+        KeyError: If the specified name_set doesn't exist
+    """
+    if name_set is None:
+        # Use size-matched selection
+        _, names = pick_names_for_count(count)
+        return names
+
+    # Use specified set
+    names = get_name_set(name_set)
+
+    result = []
+    for i in range(count):
+        result.append(names[i % len(names)])
+    return result
+
+
+def list_sets_by_size() -> dict[int, list[str]]:
+    """List available name sets grouped by size.
+
+    Returns:
+        Dict mapping size to list of set names
+    """
+    result: dict[int, list[str]] = {}
+    for size, sets in SETS_BY_SIZE.items():
+        result[size] = list(sets.keys())
+    result[6] = [k for k, v in LARGER.items() if len(v) == 6]
+    result[7] = [k for k, v in LARGER.items() if len(v) == 7]
+    result[8] = [k for k, v in LARGER.items() if len(v) >= 8]
+    return result