vaal-code 0.6.910__tar.gz → 0.6.930__tar.gz

{vaal_code-0.6.910 → vaal_code-0.6.930}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vaal-code
-Version: 0.6.910
+Version: 0.6.930
 Summary: AI coding agent CLI — local LLMs via Ollama or cloud models via API
 License: MIT
 Project-URL: Homepage, https://e-e.tools/vaal

{vaal_code-0.6.910 → vaal_code-0.6.930}/vaal/__init__.py

@@ -1,2 +1,2 @@
 """Vaal — Local LLM coding assistant CLI."""
-__version__ = "0.6.910"
+__version__ = "0.6.930"

vaal_code-0.6.930/vaal/core/buddy.py

@@ -0,0 +1,349 @@
+"""Vaal Buddy — procedurally generated ASCII companion with personality."""
+
+import hashlib
+import json
+import time
+from pathlib import Path
+from .config import VAAL_DIR
+
+BUDDY_FILE = VAAL_DIR / "buddy.json"
+
+RARITIES = ["common", "uncommon", "rare", "epic", "legendary"]
+RARITY_WEIGHTS = {"common": 60, "uncommon": 25, "rare": 10, "epic": 4, "legendary": 1}
+RARITY_STARS = {"common": "★", "uncommon": "★★", "rare": "★★★", "epic": "★★★★", "legendary": "★★★★★"}
+RARITY_COLORS = {"common": "dim", "uncommon": "#5fd75f", "rare": "#5f87ff", "epic": "#af5fff", "legendary": "#d7d75f"}
+
+SPECIES = [
+    "duck", "goose", "blob", "cat", "dragon", "octopus", "owl",
+    "penguin", "turtle", "snail", "ghost", "axolotl", "capybara",
+    "cactus", "robot", "rabbit", "mushroom", "chonk",
+]
+
+EYES = ["·", "✦", "×", "◉", "@", "°"]
+
+HATS = ["none", "crown", "tophat", "propeller", "halo", "wizard", "beanie", "tinyduck"]
+
+STATS = ["DEBUGGING", "PATIENCE", "CHAOS", "WISDOM", "SNARK"]
+
+# ASCII sprites — 5 lines tall, {E} = eye char
+SPRITES = {
+    "duck":     ['            ', '    __      ', '  <({E} )___  ', '   (  ._>   ', '    `--´    '],
+    "goose":    ['            ', '     ({E}>    ', '     ||     ', '   _(__)_   ', '    ^^^^    '],
+    "blob":     ['            ', '   .----.   ', '  ( {E}  {E} )  ', '  (      )  ', '   `----´   '],
+    "cat":      ['            ', '   /\\_/\\    ', '  ( {E}   {E})  ', '  (  ω  )   ', '  (")_(")   '],
+    "dragon":   ['            ', '  /^\\  /^\\  ', ' <  {E}  {E}  > ', ' (   ~~   ) ', '  `-vvvv-´  '],
+    "octopus":  ['            ', '   .----.   ', '  ( {E}  {E} )  ', '  (______)  ', '  /\\/\\/\\/\\  '],
+    "owl":      ['            ', '   /\\  /\\   ', '  (({E})({E}))  ', '  (  ><  )  ', '   `----´   '],
+    "penguin":  ['            ', '  .---.     ', '  ({E}>{E})     ', ' /(   )\\    ', '  `---´     '],
+    "turtle":   ['            ', '   _,--._   ', '  ( {E}  {E} )  ', ' /[______]\\ ', '  ``    ``  '],
+    "snail":    ['            ', ' {E}    .--.  ', '  \\  ( @ )  ', '   \\_`--´   ', '  ~~~~~~~   '],
+    "ghost":    ['            ', '   .----.   ', '  / {E}  {E} \\  ', '  |      |  ', '  ~`~``~`~  '],
+    "axolotl":  ['            ', '}~(______)~{', '}~({E} .. {E})~{', '  ( .--. )  ', '  (_/  \\_)  '],
+    "capybara": ['            ', '  n______n  ', ' ( {E}    {E} ) ', ' (   oo   ) ', '  `------´  '],
+    "cactus":   ['            ', ' n  ____  n ', ' | |{E}  {E}| | ', ' |_|    |_| ', '   |    |   '],
+    "robot":    ['            ', '   .[||].   ', '  [ {E}  {E} ]  ', '  [ ==== ]  ', '  `------´  '],
+    "rabbit":   ['            ', '   (\\__/)   ', '  ( {E}  {E} )  ', ' =(  ..  )= ', '  (")__(")  '],
+    "mushroom": ['            ', ' .-o-OO-o-. ', '(__________)', '   |{E}  {E}|   ', '   |____|   '],
+    "chonk":    ['            ', '  /\\    /\\  ', ' ( {E}    {E} ) ', ' (   ..   ) ', '  `------´  '],
+}
+
+HAT_LINES = {
+    "none": "",
+    "crown":    "   \\^^^/    ",
+    "tophat":   "   [___]    ",
+    "propeller":"    -+-     ",
+    "halo":     "   (   )    ",
+    "wizard":   "    /^\\     ",
+    "beanie":   "   (___)    ",
+    "tinyduck": "    ,>      ",
+}
+
+
+def _mulberry32(seed: int):
+    """Seeded PRNG."""
+    a = seed & 0xFFFFFFFF
+    def next_val():
+        nonlocal a
+        a = (a + 0x6D2B79F5) & 0xFFFFFFFF
+        t = ((a ^ (a >> 15)) * (1 | a)) & 0xFFFFFFFF
+        t = ((t + ((t ^ (t >> 7)) * (61 | t))) ^ t) & 0xFFFFFFFF
+        return ((t ^ (t >> 14)) & 0xFFFFFFFF) / 4294967296
+    return next_val
+
+
+def _hash_string(s: str) -> int:
+    """FNV-1a hash to match Claude Code's buddy generation."""
+    h = 2166136261
+    for ch in s:
+        h ^= ord(ch)
+        h = (h * 16777619) & 0xFFFFFFFF
+    return h
+
+
+def _pick(rng, arr):
+    return arr[int(rng() * len(arr))]
+
+
+def _roll_rarity(rng) -> str:
+    total = sum(RARITY_WEIGHTS.values())
+    roll = rng() * total
+    for r in RARITIES:
+        roll -= RARITY_WEIGHTS[r]
+        if roll < 0:
+            return r
+    return "common"
+
+
+def _roll_stats(rng, rarity: str) -> dict:
+    floors = {"common": 5, "uncommon": 15, "rare": 25, "epic": 35, "legendary": 50}
+    floor = floors.get(rarity, 5)
+    peak = _pick(rng, STATS)
+    dump = _pick(rng, STATS)
+    while dump == peak:
+        dump = _pick(rng, STATS)
+
+    stats = {}
+    for name in STATS:
+        if name == peak:
+            stats[name] = min(100, floor + 50 + int(rng() * 30))
+        elif name == dump:
+            stats[name] = max(1, floor - 10 + int(rng() * 15))
+        else:
+            stats[name] = floor + int(rng() * 40)
+    return stats
+
+
+def roll_buddy(user_id: str = "anon") -> dict:
+    """Generate deterministic buddy from user ID."""
+    seed = _hash_string(user_id + "friend-2026-401")
+    rng = _mulberry32(seed)
+
+    rarity = _roll_rarity(rng)
+    species = _pick(rng, SPECIES)
+    eye = _pick(rng, EYES)
+    hat = "none" if rarity == "common" else _pick(rng, HATS)
+    shiny = rng() < 0.01
+    stats = _roll_stats(rng, rarity)
+
+    return {
+        "rarity": rarity,
+        "species": species,
+        "eye": eye,
+        "hat": hat,
+        "shiny": shiny,
+        "stats": stats,
+    }
+
+
+def render_sprite(buddy: dict) -> list[str]:
+    """Render the buddy as ASCII lines."""
+    species = buddy.get("species", "blob")
+    eye = buddy.get("eye", "·")
+    hat = buddy.get("hat", "none")
+
+    body = SPRITES.get(species, SPRITES["blob"])
+    lines = [line.replace("{E}", eye) for line in body]
+
+    # Add hat
+    if hat != "none" and not lines[0].strip():
+        lines[0] = HAT_LINES.get(hat, "")
+
+    # Remove blank first line if no hat
+    if not lines[0].strip():
+        lines = lines[1:]
+
+    return lines
+
+
+def get_buddy() -> dict | None:
+    """Get saved buddy, or None."""
+    if BUDDY_FILE.exists():
+        try:
+            return json.loads(BUDDY_FILE.read_text(encoding="utf-8"))
+        except Exception:
+            pass
+    return None
+
+
+def save_buddy(buddy: dict):
+    """Save buddy to disk."""
+    VAAL_DIR.mkdir(exist_ok=True)
+    BUDDY_FILE.write_text(json.dumps(buddy, indent=2), encoding="utf-8")
+
+
+def hatch_buddy(user_id: str = "anon", name: str = "", personality: str = "") -> dict:
+    """Hatch a new buddy."""
+    bones = roll_buddy(user_id)
+    buddy = {
+        **bones,
+        "name": name or bones["species"].title(),
+        "personality": personality or "A mysterious companion",
+        "hatched_at": int(time.time()),
+    }
+    save_buddy(buddy)
+    return buddy
+
+
+def play_hatch_animation(buddy: dict):
+    """Play an egg hatching animation in the terminal."""
+    import sys
+    import time as _time
+
+    def _w(s):
+        sys.stdout.write(s)
+        sys.stdout.flush()
+
+    def _clear_lines(n):
+        for _ in range(n):
+            _w("\033[A\033[2K")
+
+    rarity = buddy.get("rarity", "common")
+    species = buddy.get("species", "blob")
+    eye = buddy.get("eye", "·")
+    rcolor_code = {"common": "37", "uncommon": "32", "rare": "34", "epic": "35", "legendary": "33"}.get(rarity, "37")
+
+    # Egg frames
+    egg_frames = [
+        [
+            "            ",
+            "    .--.    ",
+            "   /    \\   ",
+            "  |      |  ",
+            "   \\    /   ",
+            "    `--´    ",
+        ],
+        [
+            "            ",
+            "    .--.    ",
+            "   / ·  \\   ",
+            "  |      |  ",
+            "   \\    /   ",
+            "    `--´    ",
+        ],
+        [
+            "            ",
+            "    .~--.   ",
+            "   / ·  \\   ",
+            "  |  ·   |  ",
+            "   \\    /   ",
+            "    `--´    ",
+        ],
+        [
+            "     *      ",
+            "   .~--~.   ",
+            "  / · ·  \\  ",
+            " |   ·    | ",
+            "  \\ ·    /  ",
+            "   `~--~´   ",
+        ],
+        [
+            "    \\|/     ",
+            "   ,~--~.   ",
+            "  / ·  · \\  ",
+            " | ·  ·   | ",
+            "  \\  · · /  ",
+            "   `~--~´   ",
+        ],
+        [
+            "   \\  | /   ",
+            "  --,~~.--  ",
+            "   /    \\   ",
+            "  | CRACK|  ",
+            "   \\    /   ",
+            "  --`~~´--  ",
+        ],
+        [
+            "  * \\ | / * ",
+            "   .~~~~.   ",
+            "  /  /\\  \\  ",
+            " | / ·  \\|  ",
+            "  \\/ ·  /   ",
+            "   `~~~~´   ",
+        ],
+        [
+            " * *\\|/* *  ",
+            "   ._/\\.    ",
+            "  / /  \\ \\  ",
+            " |/ ·  · \\| ",
+            "  /      \\  ",
+            "   `_/\\_´   ",
+        ],
+    ]
+
+    # Phase 1: Egg wobbling
+    _w("\n")
+    for i in range(12):
+        frame = egg_frames[min(i // 3, 2)]
+        for line in frame:
+            _w(f"  \033[2m{line}\033[0m\n")
+        _time.sleep(0.25)
+        _clear_lines(len(frame))
+
+    # Phase 2: Cracking
+    for i in range(3, 6):
+        frame = egg_frames[min(i, len(egg_frames) - 1)]
+        for line in frame:
+            _w(f"  \033[1;37m{line}\033[0m\n")
+        _time.sleep(0.4)
+        _clear_lines(len(frame))
+
+    # Phase 3: Breaking open
+    for i in range(6, len(egg_frames)):
+        frame = egg_frames[i]
+        for line in frame:
+            _w(f"  \033[1;{rcolor_code}m{line}\033[0m\n")
+        _time.sleep(0.35)
+        _clear_lines(len(frame))
+
+    # Phase 4: Flash
+    _w(f"\033[1;{rcolor_code}m")
+    for _ in range(3):
+        _w("  ✦ ✦ ✦ ✦ ✦ ✦ ✦ ✦\n")
+        _time.sleep(0.1)
+        _clear_lines(1)
+        _time.sleep(0.1)
+    _w("\033[0m")
+
+    # Phase 5: Reveal the buddy
+    sprite = render_sprite(buddy)
+    stars = RARITY_STARS.get(rarity, "★")
+    name = buddy.get("name", "???")
+
+    _w(f"\n  \033[1;{rcolor_code}m{name}\033[0m {stars}\n")
+    _w(f"  \033[2m{rarity} {species}\033[0m\n\n")
+    for line in sprite:
+        _w(f"  \033[1;{rcolor_code}m{line}\033[0m\n")
+    _w("\n")
+
+    if buddy.get("shiny"):
+        _w(f"  \033[1;33m✧ ✧ ✧  S H I N Y  ✧ ✧ ✧\033[0m\n\n")
+
+    _time.sleep(0.5)
+
+
+def format_buddy_card(buddy: dict) -> str:
+    """Format buddy as a display card."""
+    rarity = buddy.get("rarity", "common")
+    stars = RARITY_STARS.get(rarity, "★")
+    sprite = render_sprite(buddy)
+
+    lines = []
+    lines.append(f"  {buddy.get('name', '???')} {stars}")
+    lines.append(f"  {rarity} {buddy.get('species', '???')}")
+    if buddy.get("shiny"):
+        lines.append("  ✧ SHINY ✧")
+    lines.append("")
+    for sl in sprite:
+        lines.append(f"  {sl}")
+    lines.append("")
+    if buddy.get("hat", "none") != "none":
+        lines.append(f"  Hat: {buddy['hat']}")
+    stats = buddy.get("stats", {})
+    if stats:
+        for stat, val in stats.items():
+            bar = "█" * (val // 10) + "░" * (10 - val // 10)
+            lines.append(f"  {stat:10s} {bar} {val}")
+    if buddy.get("personality"):
+        lines.append(f"  \"{buddy['personality']}\"")
+
+    return "\n".join(lines)

{vaal_code-0.6.910 → vaal_code-0.6.930}/vaal/core/command_palette.py

@@ -74,6 +74,7 @@ COMMANDS = [
     ("/ssh", "SSH remote execution (connect/run/disconnect)"),
     ("/explain", "Explain an error or stack trace"),
     ("/migrate", "Guided framework/language migration"),
+    ("/buddy", "Your companion (hatch/show/reroll/name)"),
     ("/register", "Create a vaal account"),
     ("/remote", "Remote control from web browser"),
     ("/task", "Manage tasks (create/update/complete)"),

{vaal_code-0.6.910 → vaal_code-0.6.930}/vaal/core/repl.py

@@ -1148,8 +1148,31 @@ def run_repl(model: str = DEFAULT_MODEL, permission_mode: str = DEFAULT_PERMISSI
     }
 
     def print_prompt_line():
-        """Print the thin line above the prompt + mode hint below."""
-        console.print(f"[dim]{'─' * min(console.width, 70)}[/dim]")
+        """Print the thin line above the prompt with buddy on the right."""
+        from .buddy import get_buddy, render_sprite, RARITY_COLORS
+        w = min(console.width or 80, 80)
+        line_w = w - 14  # Leave room for buddy
+
+        buddy = get_buddy()
+        if buddy:
+            sprite = render_sprite(buddy)
+            rcolor = RARITY_COLORS.get(buddy.get("rarity", "common"), "dim")
+            bname = buddy.get("name", "")
+
+            # Print separator with buddy sprite on the right
+            _write(f"\033[2m{'─' * line_w}\033[0m\n")
+            # Print buddy sprite lines aligned to the right
+            for i, sline in enumerate(sprite):
+                # Cursor to column position for right-alignment
+                col = line_w + 2
+                _write(f"\033[{col}G\033[2m{sline}\033[0m\n")
+            # Print buddy name under sprite
+            _write(f"\033[{line_w + 4}G\033[2m{bname}\033[0m")
+            # Move cursor back to start for the > prompt
+            up = len(sprite) + 1
+            _write(f"\033[{up}A\r")
+        else:
+            console.print(f"[dim]{'─' * line_w}[/dim]")
 
     # Check if any models are installed — if not, open model selector
     from .llm import list_models as _check_models
@@ -1651,6 +1674,7 @@ def handle_command(cmd: str, session: Session, active_model: list, permissions:
             ("/register", "Create a vaal account on e-e.tools"),
             ("/login vaal", "Login to your vaal account"),
             ("/remote start|stop", "Remote control from web browser"),
+            ("/buddy", "Your companion (hatch/show/reroll/name)"),
             ("/doctor", "System health diagnostics"),
             ("/preview <path>", "Live preview with interactive inspector"),
             ("/preview stop", "Stop preview server"),
@@ -2380,6 +2404,9 @@ def handle_command(cmd: str, session: Session, active_model: list, permissions:
     elif command == "/remote":
         _handle_remote_command(arg, active_model, session, components)
 
+    elif command == "/buddy":
+        _handle_buddy_command(arg)
+
     elif command == "/doctor":
         _handle_doctor_command(active_model)
 
@@ -3242,6 +3269,65 @@ def get_vaal_user() -> dict | None:
     return None
 
 
+def _handle_buddy_command(arg: str):
+    """Handle /buddy [hatch|show|reroll|name] — companion system."""
+    from .buddy import get_buddy, hatch_buddy, format_buddy_card, roll_buddy, save_buddy, RARITY_COLORS
+
+    action = arg.strip().lower().split(maxsplit=1) if arg.strip() else ["show"]
+    cmd = action[0]
+    cmd_arg = action[1] if len(action) > 1 else ""
+
+    buddy = get_buddy()
+
+    if cmd == "hatch" or (cmd == "show" and not buddy):
+        # Hatch a new buddy
+        from .buddy import play_hatch_animation
+        user = get_vaal_user()
+        user_id = user["username"] if user else "anon"
+        buddy = hatch_buddy(user_id)
+        play_hatch_animation(buddy)
+        # Show stats after animation
+        stats_dict = buddy.get("stats", {})
+        for stat, val in stats_dict.items():
+            bar = "█" * (val // 10) + "░" * (10 - val // 10)
+            console.print(f"  [dim]{stat:10s}[/dim] [{VAAL_CYAN}]{bar}[/] {val}")
+        console.print()
+
+    elif cmd == "show":
+        rcolor = RARITY_COLORS.get(buddy["rarity"], "dim")
+        console.print()
+        console.print(f"[{rcolor}]{format_buddy_card(buddy)}[/]")
+        console.print()
+
+    elif cmd == "reroll":
+        from .buddy import play_hatch_animation
+        import secrets
+        seed = secrets.token_hex(8)
+        bones = roll_buddy(seed)
+        buddy = {**bones, "name": bones["species"].title(), "personality": "A rerolled companion", "hatched_at": int(time.time())}
+        save_buddy(buddy)
+        play_hatch_animation(buddy)
+        stats_dict = buddy.get("stats", {})
+        for stat, val in stats_dict.items():
+            bar = "█" * (val // 10) + "░" * (10 - val // 10)
+            console.print(f"  [dim]{stat:10s}[/dim] [{VAAL_CYAN}]{bar}[/] {val}")
+        console.print()
+
+    elif cmd == "name" and cmd_arg:
+        if not buddy:
+            console.print(f"  [dim]No buddy yet. Use /buddy hatch[/dim]")
+            return
+        buddy["name"] = cmd_arg
+        save_buddy(buddy)
+        console.print(f"  [{VAAL_GREEN}]Renamed to {cmd_arg}[/]")
+
+    else:
+        console.print(f"[dim]  /buddy          — Show your buddy[/dim]")
+        console.print(f"[dim]  /buddy hatch    — Hatch a new buddy[/dim]")
+        console.print(f"[dim]  /buddy reroll   — Reroll (random seed)[/dim]")
+        console.print(f"[dim]  /buddy name X   — Rename your buddy[/dim]")
+
+
 def _handle_doctor_command(active_model: list):
     """Handle /doctor — system health diagnostics."""
     import sys

{vaal_code-0.6.910 → vaal_code-0.6.930}/vaal_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vaal-code
-Version: 0.6.910
+Version: 0.6.930
 Summary: AI coding agent CLI — local LLMs via Ollama or cloud models via API
 License: MIT
 Project-URL: Homepage, https://e-e.tools/vaal

{vaal_code-0.6.910 → vaal_code-0.6.930}/vaal_code.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ vaal/core/auto_fix.py
 vaal/core/bootstrap.py
 vaal/core/branching.py
 vaal/core/bridge.py
+vaal/core/buddy.py
 vaal/core/changelog.py
 vaal/core/clipboard.py
 vaal/core/code_review.py