Redesign mascot as single-line, fix ASCII alignment; bump to 0.1.1

The 5-line hand-drawn ASCII ghost body didn't align cleanly (text
columns drifted since each face line had a different length) and
looked crude compared to just using the real ghost emoji, which
renders fine on any modern terminal. Replaced it with a single-line
icon (star-flanked emoji, colored per state) plus a plain ASCII face
fallback (o o)/(O O)/(x x) for terminals that can't render it -- both
paths now use a fixed-width icon so the summary/detail text lines up.

Version bump reflects the mascot feature and the judge-cache/env-var
fixes shipped this session.

Author: parthmax2

CHANGELOG.md

@@ -6,13 +6,27 @@ All notable changes to ghostrun are documented here. The format is based on
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-07-28
+
 ### Added
-- **Terminal mascot** — a small ASCII ghost printed once at the end of a test
-  session, reacting to what the interceptor actually did: calm when every
-  call replayed from cache, alert (yellow) when the network was actually
-  touched, and a distinct miss face (red) when `--ghostrun-replay` hit an
-  uncached request. Color and emoji only render on a real UTF-8-capable TTY;
-  silent on CI/piped output, and always silenceable via `GHOSTRUN_NO_MASCOT=1`.
+- **Terminal mascot** — a one-line marker printed once at the end of a test
+  session, reacting to what the interceptor actually did: calm (`☆ 👻 ☆`,
+  cyan) when every call replayed from cache, alert (yellow) when the network
+  was actually touched, and a distinct miss face (red) when
+  `--ghostrun-replay` hit an uncached request. Falls back to a plain ASCII
+  face (`(o o)` / `(O O)` / `(x x)`) on terminals/codepages that can't render
+  the emoji. Silent on CI/piped output and `NO_COLOR`, and always
+  silenceable via `GHOSTRUN_NO_MASCOT=1`.
+
+### Fixed
+- Judge verdict caching ignored a per-test `cache_dir` override passed to
+  `@ghostrun.record()`, so verdicts silently leaked into the global cache dir
+  instead of living next to the test as documented — the root cause of every
+  CI matrix job failing on `--ghostrun-replay`. `recording()` now scopes
+  `cache_dir`/`mode` onto the active config for the run.
+- `GHOSTRUN_*` environment variables were misnamed `ghostrun_*` (lowercase
+  prefix) across the codebase, docs, and CI following the gentest→ghostrun
+  rename.
 - **`ghostrun init`** — scaffolds a working first test in one command. Detects
   whether `openai` or `anthropic` is importable in the project and generates
   a matching starter test (or a generic httpx-based one if neither is found),

ghostrun/__init__.py

@@ -24,7 +24,7 @@ def test_reply():
 from .interceptor import CacheMiss, UnsupportedHttpx
 from .record import record, recording
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 
 def configure(**kwargs) -> Config:

ghostrun/mascot.py

@@ -1,5 +1,5 @@
-"""The ghostrun terminal mascot: a one-line-per-session ASCII ghost that reacts
-to what the interceptor actually did (replayed from cache, hit the network, or
+"""The ghostrun terminal mascot: a one-line-per-session marker that reacts to
+what the interceptor actually did (replayed from cache, hit the network, or
 missed in strict replay mode).
 
 Deliberately shown at most once, at the end of a test session -- never per-line
@@ -14,39 +14,24 @@
 import sys
 
 RESET = "\x1b[0m"
-DIM = "\x1b[2m"
 BOLD = "\x1b[1m"
+DIM = "\x1b[2m"
 
 _COLOR = {
     "replayed": "\x1b[36m",  # cyan -- calm, nothing cost anything
     "recorded": "\x1b[33m",  # yellow -- the network was actually touched
     "miss": "\x1b[31m",      # red -- something's wrong
 }
 
-_EMOJI = {"replayed": "👻", "recorded": "🌐", "miss": "⚠️"}
-
-_FACES = {
-    "replayed": [
-        "   .-''''-.",
-        "  /  o  o  \\",
-        " |    ..    |",
-        "  \\  '--'  /",
-        "   `------`",
-    ],
-    "recorded": [
-        "   .-''''-.",
-        "  /  O  O  \\",
-        " |    o     |",
-        "  \\  '--'  /",
-        "   `------`",
-    ],
-    "miss": [
-        "   .-''''-.",
-        "  /  x  x  \\",
-        " |   /\\    |",
-        "  \\  '--'  /",
-        "   `------`",
-    ],
+# The real 👻 emoji is the mascot on any terminal that can render it -- it
+# already looks better than anything drawn from punctuation. ASCII faces are
+# only the fallback for terminals/codepages that can't show it.
+_ASCII_FACE = {"replayed": "(o o)", "recorded": "(O O)", "miss": "(x x)"}
+
+_DETAIL = {
+    "replayed": "no network touched",
+    "recorded": "the network was touched -- new cache written",
+    "miss": "re-run with --ghostrun-record to fix",
 }
 
 
@@ -68,29 +53,17 @@ def _supports_color(stream) -> bool:
     return bool(getattr(stream, "isatty", lambda: False)())
 
 
-def _supports_emoji(stream) -> bool:
+def _supports_unicode(stream) -> bool:
     encoding = getattr(stream, "encoding", None) or ""
     return "UTF" in encoding.upper()
 
 
-def _summary_line(stats: dict, state: str, emoji: bool, unicode_safe: bool) -> str:
-    parts = [
-        f"{stats.get('replayed', 0)} replayed",
-        f"{stats.get('recorded', 0)} recorded",
-    ]
-    if stats.get("misses", 0):
-        parts.append(f"{stats['misses']} missed")
-    mark = f"{_EMOJI[state]} " if emoji else ""
-    sep = "·" if unicode_safe else "-"
-    return f"{mark}ghostrun  {sep}  " + ", ".join(parts)
-
-
 def render(stats: dict, stream=None) -> str:
-    """Render the mascot block for this session's stats, or "" to show nothing.
+    """Render the mascot line(s) for this session's stats, or "" for nothing.
 
     Returns an empty string when nothing ghostrun-related happened (no
     replays, records, or misses) so a suite that never calls @ghostrun.record
-    doesn't get an unexplained ghost printed at it.
+    doesn't get an unexplained mascot printed at it.
     """
     stream = stream if stream is not None else sys.stdout
     state = _state(stats)
@@ -100,27 +73,29 @@ def render(stats: dict, stream=None) -> str:
         return ""
 
     color = _supports_color(stream)
-    emoji = color and _supports_emoji(stream)
-
-    face = _FACES[state]
-    summary = _summary_line(stats, state, emoji, unicode_safe=emoji)
-    detail = {
-        "replayed": "no network touched",
-        "recorded": "the network was touched -- new cache written",
-        "miss": "re-run with --ghostrun-record to fix",
-    }[state]
+    unicode_safe = color and _supports_unicode(stream)
 
     c = _COLOR[state] if color else ""
     r = RESET if color else ""
+    bold = BOLD if color else ""
     dim = DIM if color else ""
+    sep = "·" if unicode_safe else "-"
 
-    lines = []
-    for i, art_line in enumerate(face):
-        colored_art = f"{c}{art_line}{r}"
-        if i == 0:
-            lines.append(f"{colored_art}      {BOLD if color else ''}{summary}{r}")
-        elif i == 1:
-            lines.append(f"{colored_art}      {dim}{detail}{r}")
-        else:
-            lines.append(colored_art)
-    return "\n" + "\n".join(lines) + "\n"
+    if unicode_safe:
+        icon = f"{c}☆{r} \U0001f47b {c}☆{r}"
+        icon_width = 5  # visual columns: star, space, ghost(~2), space, star
+    else:
+        icon = f"{c}{_ASCII_FACE[state]}{r}"
+        icon_width = len(_ASCII_FACE[state])
+
+    parts = [f"{stats.get('replayed', 0)} replayed", f"{stats.get('recorded', 0)} recorded"]
+    if stats.get("misses", 0):
+        parts.append(f"{stats['misses']} missed")
+    summary = f"{bold}ghostrun  {sep}  " + ", ".join(parts) + r
+    detail = f"{dim}{_DETAIL[state]}{r}"
+
+    pad = " " * icon_width
+    return (
+        f"\n{icon}   {summary}"
+        f"\n{pad}   {detail}\n"
+    )

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ghostrun"
-version = "0.1.0"
+version = "0.1.1"
 description = "pytest for LLMs: deterministic HTTP record/replay, local LLM-as-judge semantic assertions, and prompt regression diffing for testing GenAI applications."
 readme = "README.md"
 requires-python = ">=3.9"

tests/test_mascot.py

@@ -45,8 +45,7 @@ def test_opt_out_env_var(monkeypatch):
 def test_state_selection(stats, expected_state, monkeypatch):
     monkeypatch.delenv("GHOSTRUN_NO_MASCOT", raising=False)
     block = mascot.render(stats, stream=FakeStream(isatty=False))
-    face_line = mascot._FACES[expected_state][1]  # eyes line is state-distinctive
-    assert face_line in block
+    assert mascot._ASCII_FACE[expected_state] in block
 
 
 def test_color_and_emoji_only_on_tty_utf8(monkeypatch):