hyperweave 0.3.0__tar.gz → 0.3.1__tar.gz

{hyperweave-0.3.0 → hyperweave-0.3.1}/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to HyperWeave are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-05-10
+
+Receipt user-turn count and filenames now reflect actual session content. Voltage receipts always render dark regardless of viewer color scheme. Star chart x-axis labels no longer collide on short-history repos.
+
+### Fixed
+
+- **Receipt user-turn count** — the footer "N user turns" now reports actual prompt count; slash commands and tool results no longer skew the number.
+- **Star chart x-axis labels on short histories** — "Apr 2026" / "May 2026" no longer overlap on charts spanning under two years. Spacing now accounts for actual label width and drops middle labels when their bounding boxes would touch.
+
+### Changed
+
+- **Receipt filenames are human-readable** — saved as `{date}_{time}_{session-name}.svg` (was UUID-only). Session name comes from Claude Code's auto-titled session or Codex's thread name; UUID stays in the SVG metadata.
+- **Voltage receipts always render dark** — the light-mode adaptation block is removed; voltage stays dark across all viewers.
+- **Codex receipts carry git branch and thread name** — both are now extracted from Codex transcripts and surfaced in receipt provenance and filenames.
+
+### Notes
+
+- 1067 tests (was 1035).
+
 ## [0.3.0] - 2026-05-10
 
 Chrome ships five named variants. Automata ships sixteen tones with a pairing grammar that composes any two into a bifamily strip or divider. Stat cards, star charts, marquees, and icons redesigned. Per-frame font filtering cuts artifact payloads.

{hyperweave-0.3.0 → hyperweave-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.3.0
+Version: 0.3.1
 Summary: Headless visual output layer for AI agents. One API call → self-contained SVG.
 Project-URL: Repository, https://github.com/InnerAura/hyperweave
 Project-URL: Issues, https://github.com/InnerAura/hyperweave/issues
@@ -161,11 +161,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="chrome">chrome</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/BUILD/passing/chrome.static?state=passing&variant=horizon" alt="BUILD passing — horizon variant"/>
-  <img src="https://hyperweave.app/v1/badge/DEPLOY/live/chrome.static?state=passing&variant=abyssal" alt="DEPLOY live — abyssal variant"/>
-  <img src="https://hyperweave.app/v1/badge/COVERAGE/94%25/chrome.static?state=passing&variant=lightning" alt="COVERAGE 94% — lightning variant"/>
-  <img src="https://hyperweave.app/v1/badge/CRITICAL/0/chrome.static?state=warning&variant=graphite" alt="CRITICAL 0 — graphite variant"/>
-  <img src="https://hyperweave.app/v1/badge/TESTS/142/chrome.static?state=passing&variant=moth" alt="TESTS 142 — moth variant"/>
+  <img src="https://hyperweave.app/v1/badge/BUILD/chrome.static?data=gh:InnerAura/hyperweave.build&glyph=githubactions&variant=horizon" alt="BUILD — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/BLUESKY/POST/chrome.static?glyph=bluesky&variant=abyssal" alt="BLUESKY POST — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/DOCKER/chrome.static?data=docker:zeroxeli/readme-ai.pull_count&glyph=docker&variant=lightning" alt="DOCKER pulls — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/STARS/chrome.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=graphite" alt="STARS — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/ANTHROPIC/CLAUDE/chrome.static?glyph=anthropic&variant=moth" alt="ANTHROPIC CLAUDE — moth variant"/>
 </p>
 
 <p align="center">
@@ -260,12 +260,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="automata">automata</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=indigo" alt="DISCORD JOIN — indigo variant"/>
-  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=cobalt" alt="DOCKER PULL — cobalt variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:InnerAura/hyperweave.stars&glyph=github&variant=bone" alt="STARS — bone variant"/>
-  <img src="https://hyperweave.app/v1/badge/FOLLOW/automata.static?glyph=x&variant=steel" alt="FOLLOW — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=teal" alt="DOCKER PULL — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=violet" alt="DISCORD JOIN — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=amber" alt="STARS — amber variant"/>
   <img src="https://hyperweave.app/v1/badge/HF/MODELS/automata.static?glyph=huggingface&variant=sulfur" alt="HF MODELS — sulfur variant"/>
-  <img src="https://hyperweave.app/v1/badge/LISTEN/automata.static?glyph=spotify&variant=jade" alt="LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
 </p>
 
 <p align="center">
@@ -289,7 +288,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Dashboard<br/><sub>strip</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&pair=steel&glyph=github" alt="strip"/>
+  <img src="https://hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&glyph=github" alt="strip"/>
   <br/>
   <ul>
 <li><sub><code>/v1/strip/{title}/automata.static?data={tokens}&variant={tone}&pair={tone}&subtitle={text}&glyph={glyph}</code></sub></li>
@@ -300,7 +299,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Profile<br/><sub>stats card</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone" alt="stats" width="100%"/>
+  <img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone&v=2" alt="stats" width="100%"/>
   <br/>
   <ul>
 <li><sub><code>/v1/stats/{username}/{genome}.static?variant={tone}</code></sub></li>
@@ -311,7 +310,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Star Chart<br/><sub>star history</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone" alt="star chart" width="100%"/>
+  <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone&v=2" alt="star chart" width="100%"/>
   <br/>
   <ul>
 <li><sub><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={tone}</code></sub></li>
@@ -335,8 +334,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <td>
   <img src="https://hyperweave.app/v1/icon/docker/automata.static?shape=square&variant=cobalt" alt="docker cobalt" width="56"/>
   <img src="https://hyperweave.app/v1/icon/discord/automata.static?shape=square&variant=indigo" alt="discord indigo" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/automata.static?shape=square&variant=bone" alt="github bone" width="56"/>
   <img src="https://hyperweave.app/v1/icon/huggingface/automata.static?shape=square&variant=sulfur" alt="huggingface sulfur" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/anthropic/automata.static?shape=square&variant=solar" alt="anthropic solar" width="56"/>
   <img src="https://hyperweave.app/v1/icon/youtube/automata.static?shape=square&variant=crimson" alt="youtube crimson" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/automata.static?shape=square&variant=jade" alt="spotify jade" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/automata.static?shape=square&variant={tone}</code></sub></li>
@@ -347,7 +349,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Divider<br/><sub>dissolve</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone&pair=steel" alt="automata dissolve divider"/>
+  <img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone" alt="automata dissolve divider"/>
   <br/>
   <ul>
 <li><sub><code>/v1/divider/dissolve/{genome}.static?variant={tone}&pair={tone}</code></sub></li>
@@ -444,6 +446,8 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 </tr>
 </table>
 
+<br />
+
 | | chrome | brutalist | automata |
 |---|---|---|---|
 | Aesthetic | Metallic precision | Raw material | Living cellular grid |
@@ -451,6 +455,8 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 | Motion | Animated border SMIL | Animated border SMIL | Animated cell grid |
 | Divider | `band` | `seam` | `dissolve` |
 
+<br />
+
 <h3 id="dividers"><code>/a/inneraura/dividers/</code></h3>
 
 <table>

{hyperweave-0.3.0 → hyperweave-0.3.1}/README.md

@@ -129,11 +129,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="chrome">chrome</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/BUILD/passing/chrome.static?state=passing&variant=horizon" alt="BUILD passing — horizon variant"/>
-  <img src="https://hyperweave.app/v1/badge/DEPLOY/live/chrome.static?state=passing&variant=abyssal" alt="DEPLOY live — abyssal variant"/>
-  <img src="https://hyperweave.app/v1/badge/COVERAGE/94%25/chrome.static?state=passing&variant=lightning" alt="COVERAGE 94% — lightning variant"/>
-  <img src="https://hyperweave.app/v1/badge/CRITICAL/0/chrome.static?state=warning&variant=graphite" alt="CRITICAL 0 — graphite variant"/>
-  <img src="https://hyperweave.app/v1/badge/TESTS/142/chrome.static?state=passing&variant=moth" alt="TESTS 142 — moth variant"/>
+  <img src="https://hyperweave.app/v1/badge/BUILD/chrome.static?data=gh:InnerAura/hyperweave.build&glyph=githubactions&variant=horizon" alt="BUILD — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/BLUESKY/POST/chrome.static?glyph=bluesky&variant=abyssal" alt="BLUESKY POST — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/DOCKER/chrome.static?data=docker:zeroxeli/readme-ai.pull_count&glyph=docker&variant=lightning" alt="DOCKER pulls — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/STARS/chrome.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=graphite" alt="STARS — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/ANTHROPIC/CLAUDE/chrome.static?glyph=anthropic&variant=moth" alt="ANTHROPIC CLAUDE — moth variant"/>
 </p>
 
 <p align="center">
@@ -228,12 +228,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="automata">automata</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=indigo" alt="DISCORD JOIN — indigo variant"/>
-  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=cobalt" alt="DOCKER PULL — cobalt variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:InnerAura/hyperweave.stars&glyph=github&variant=bone" alt="STARS — bone variant"/>
-  <img src="https://hyperweave.app/v1/badge/FOLLOW/automata.static?glyph=x&variant=steel" alt="FOLLOW — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=teal" alt="DOCKER PULL — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=violet" alt="DISCORD JOIN — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=amber" alt="STARS — amber variant"/>
   <img src="https://hyperweave.app/v1/badge/HF/MODELS/automata.static?glyph=huggingface&variant=sulfur" alt="HF MODELS — sulfur variant"/>
-  <img src="https://hyperweave.app/v1/badge/LISTEN/automata.static?glyph=spotify&variant=jade" alt="LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
 </p>
 
 <p align="center">
@@ -257,7 +256,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Dashboard<br/><sub>strip</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&pair=steel&glyph=github" alt="strip"/>
+  <img src="https://hyperweave.app/v1/strip/readme-ai/automata.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&variant=bone&glyph=github" alt="strip"/>
   <br/>
   <ul>
 <li><sub><code>/v1/strip/{title}/automata.static?data={tokens}&variant={tone}&pair={tone}&subtitle={text}&glyph={glyph}</code></sub></li>
@@ -268,7 +267,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Profile<br/><sub>stats card</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone" alt="stats" width="100%"/>
+  <img src="https://hyperweave.app/v1/stats/eli64s/automata.static?variant=bone&v=2" alt="stats" width="100%"/>
   <br/>
   <ul>
 <li><sub><code>/v1/stats/{username}/{genome}.static?variant={tone}</code></sub></li>
@@ -279,7 +278,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Star Chart<br/><sub>star history</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone" alt="star chart" width="100%"/>
+  <img src="https://hyperweave.app/v1/chart/stars/eli64s/readme-ai/automata.static?variant=bone&v=2" alt="star chart" width="100%"/>
   <br/>
   <ul>
 <li><sub><code>/v1/chart/stars/{owner}/{repo}/{genome}.static?variant={tone}</code></sub></li>
@@ -303,8 +302,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <td>
   <img src="https://hyperweave.app/v1/icon/docker/automata.static?shape=square&variant=cobalt" alt="docker cobalt" width="56"/>
   <img src="https://hyperweave.app/v1/icon/discord/automata.static?shape=square&variant=indigo" alt="discord indigo" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/automata.static?shape=square&variant=bone" alt="github bone" width="56"/>
   <img src="https://hyperweave.app/v1/icon/huggingface/automata.static?shape=square&variant=sulfur" alt="huggingface sulfur" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/anthropic/automata.static?shape=square&variant=solar" alt="anthropic solar" width="56"/>
   <img src="https://hyperweave.app/v1/icon/youtube/automata.static?shape=square&variant=crimson" alt="youtube crimson" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/automata.static?shape=square&variant=jade" alt="spotify jade" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/automata.static?shape=square&variant={tone}</code></sub></li>
@@ -315,7 +317,7 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Divider<br/><sub>dissolve</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone&pair=steel" alt="automata dissolve divider"/>
+  <img src="https://hyperweave.app/v1/divider/dissolve/automata.static?variant=bone" alt="automata dissolve divider"/>
   <br/>
   <ul>
 <li><sub><code>/v1/divider/dissolve/{genome}.static?variant={tone}&pair={tone}</code></sub></li>
@@ -412,6 +414,8 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 </tr>
 </table>
 
+<br />
+
 | | chrome | brutalist | automata |
 |---|---|---|---|
 | Aesthetic | Metallic precision | Raw material | Living cellular grid |
@@ -419,6 +423,8 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 | Motion | Animated border SMIL | Animated border SMIL | Animated cell grid |
 | Divider | `band` | `seam` | `dissolve` |
 
+<br />
+
 <h3 id="dividers"><code>/a/inneraura/dividers/</code></h3>
 
 <table>

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.3.1'
+__version_tuple__ = version_tuple = (0, 3, 1)
 
 __commit_id__ = commit_id = None

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/cli.py

@@ -369,12 +369,30 @@ def session(
     result = do_compose(spec)
 
     if action == "receipt":
-        # Default output: .hyperweave/receipts/{session_id}.svg
+        # Default output: .hyperweave/receipts/{date}_{time}_{slug}.svg
         if not output:
-            sid = contract.get("session", {}).get("id", "unknown")
+            from datetime import datetime as _dt
+
+            from hyperweave.telemetry.receipt_paths import receipt_filename
+
+            sess = contract.get("session", {})
+            sid = sess.get("id", "unknown")
+            session_name = sess.get("name", "")
+            start_iso = sess.get("start", "")
+            try:
+                ts = _dt.fromisoformat(start_iso)
+            except (TypeError, ValueError):
+                ts = _dt.now()
+            user_events = contract.get("user_events", []) or []
+            first_prompt = user_events[0].get("preview", "") if user_events else ""
             hw_dir = Path(".hyperweave") / "receipts"
             hw_dir.mkdir(parents=True, exist_ok=True)
-            output = hw_dir / f"{sid}.svg"
+            output = hw_dir / receipt_filename(
+                timestamp=ts,
+                session_name=session_name,
+                session_id=sid,
+                prompt_text=first_prompt,
+            )
 
         output.parent.mkdir(parents=True, exist_ok=True)
         output.write_text(result.svg)

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/compose/resolver.py

@@ -1993,10 +1993,9 @@ def resolve_receipt(
     pill_label = hero_profile.upper()
     pill_w = int(len(pill_label) * 7 * 1.28) + 14
     pill_x = 800 - 24 - pill_w
-    # Split "pushbacks" into distinct signals so the card stops labeling them
-    # as one opaque "N corrections" lie. user_events counts every non-continuation
-    # user turn (corrections + redirects + elaborations); tool errors count
-    # failing/blocked tool calls (the red ✗N cell marks reconcile to this).
+    # user_events is the unfiltered series of human-authored prose turns
+    # (continuations + corrections + redirects + elaborations). Tool errors
+    # count failing/blocked tool calls; the red ✗N cell marks reconcile to this.
     n_user_turns = len(user_events)
     n_tool_errors = sum(t.get("errors", 0) + t.get("blocked", 0) for t in tools)
     # n_agents = len(agents)  # was used by old footer; v0.2.21 footer is 4-quadrant.

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/data/genomes/telemetry-voltage.json

@@ -66,16 +66,6 @@
   "state_building_bright": "#DC8AC2",
   "state_offline_core": "#7A7F88",
   "state_offline_bright": "#B0B4BC",
-  "light_mode": {
-    "surface": "#fafafa",
-    "surface_alt": "#f5f5f5",
-    "surface_deep": "#f0f0f0",
-    "ink": "#18181b",
-    "ink_muted": "#3f3f46",
-    "ink_ghost": "#a1a1aa",
-    "border": "#e4e4e7",
-    "sep": "#d4d4d8"
-  },
   "paradigms": {
     "receipt": "default",
     "rhythm-strip": "default",

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/render/chart_engine.py

@@ -798,10 +798,49 @@ def _build_y_labels(ticks: list[int], v_min: int, v_max: int, vp: Viewport) -> l
     return out
 
 
-# Minimum horizontal pixel gap between two x-axis labels. Year labels (4 chars)
-# need a bit more room than milestone labels (40 px); 48 px keeps well-spaced
-# "2023" / "2024" / "2025" readable without forcing unnecessary drops.
-_X_LABEL_MIN_GAP_PX: int = 48
+# Width-aware label collision constants. The previous fixed 48px center-to-center
+# gap let monthly labels ("Apr 2026", ~58px wide) overlap by ~10px on adjacent ticks
+# even when the gap "rule" passed. We now compute each label's actual rendered
+# bounding box and check edge-to-edge separation.
+
+# Conservative per-character width covering the widest paradigm (brutalist:
+# 9px sans-serif + 0.20em letter-spacing + uppercase). Cellular and chrome
+# render narrower, so this estimate is a safe upper bound for all genome
+# paradigms — it never under-estimates collision.
+_LABEL_CHAR_WIDTH_PX: float = 7.5
+
+# Minimum visual gap between two label bounding boxes. Smaller than the full
+# character width — readers tolerate close-packed labels as long as the glyphs
+# don't actually touch.
+_LABEL_EDGE_PADDING_PX: float = 6.0
+
+
+def _label_pixel_width(text: str) -> float:
+    """Worst-case rendered width of `text` in pixels."""
+    return len(text) * _LABEL_CHAR_WIDTH_PX
+
+
+def _label_bounds(label: dict[str, Any]) -> tuple[float, float]:
+    """Return (left_edge_px, right_edge_px) for a generated label dict.
+
+    Honors the SVG `text-anchor` semantics: 'start' anchors the left edge
+    at x, 'end' anchors the right edge at x, 'middle' centers the text on x.
+    """
+    x = float(label["x"])
+    w = _label_pixel_width(str(label["text"]))
+    anchor = label.get("anchor", "middle")
+    if anchor == "start":
+        return (x, x + w)
+    if anchor == "end":
+        return (x - w, x)
+    return (x - w / 2, x + w / 2)
+
+
+def _labels_collide(left: dict[str, Any], right: dict[str, Any]) -> bool:
+    """True if `right`'s left edge is closer than padding to `left`'s right edge."""
+    _, left_right = _label_bounds(left)
+    right_left, _ = _label_bounds(right)
+    return right_left < left_right + _LABEL_EDGE_PADDING_PX
 
 
 def _build_x_date_labels(points: list[ChartPoint], vp: Viewport) -> list[dict[str, Any]]:
@@ -815,10 +854,11 @@ def _build_x_date_labels(points: list[ChartPoint], vp: Viewport) -> list[dict[st
         else       → every other year ("2012", "2014", ...)
 
     A single-point input renders one centered label with full "%b %d, %Y".
-    After candidate generation, a min-gap de-overlap pass removes any middle
-    label within ``_X_LABEL_MIN_GAP_PX`` of a previously-kept one. The first
-    and last labels are preserved unconditionally because they're the
-    temporal endpoints a reader expects to see.
+    After candidate generation, a width-aware de-overlap pass removes any
+    middle label whose bounding box would touch the previously-kept one
+    (see ``_labels_collide``). The first and last labels are preserved
+    unconditionally because they're the temporal endpoints a reader
+    expects to see.
     """
     if not points:
         return []
@@ -867,22 +907,23 @@ def _build_x_date_labels(points: list[ChartPoint], vp: Viewport) -> list[dict[st
     # First label flush with the y-axis for a cleaner left edge.
     candidates[0]["anchor"] = "start"
 
-    # De-overlap: preserve first + last; drop any middle label within min-gap
-    # of a previously-kept one. Same algorithm as _build_milestones.
+    # De-overlap: preserve first + last; drop any middle label whose
+    # bounding box would touch the previously-kept one. Edge-to-edge
+    # collision (not center-to-center) so labels of different widths
+    # (e.g. monthly "Apr 2026" vs yearly "2026") behave correctly.
     if len(candidates) <= 2:
         return candidates
     kept: list[dict[str, Any]] = [candidates[0]]
     for label in candidates[1:-1]:
-        if label["x"] - kept[-1]["x"] >= _X_LABEL_MIN_GAP_PX:
+        if not _labels_collide(kept[-1], label):
             kept.append(label)
-    # The terminal endpoint is always included. If it's too close to the
-    # last-kept middle label, or has identical text (e.g. yearly granularity
-    # where the last jan-1 tick and the terminal point both read "2026"),
-    # replace that middle label with the terminal rather than duplicating.
+    # The terminal endpoint is always included. If it would collide with
+    # the last-kept middle label, or has identical text (e.g. yearly
+    # granularity where the last jan-1 tick and the terminal point both
+    # read "2026"), replace that middle rather than duplicating.
     last_candidate = candidates[-1]
-    too_close = last_candidate["x"] - kept[-1]["x"] < _X_LABEL_MIN_GAP_PX
     same_text = last_candidate["text"] == kept[-1]["text"]
-    if too_close or same_text:
+    if same_text or _labels_collide(kept[-1], last_candidate):
         kept[-1] = last_candidate
     else:
         kept.append(last_candidate)

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/telemetry/codex_parser.py

@@ -230,6 +230,8 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
     # ── Pass 1: session_meta + turn_context derive session metadata ──
     session_id = ""
     project_path = ""
+    git_branch: str | None = None
+    session_name = ""
     model: str | None = None
     for line in raw_lines:
         ltype = line.get("type")
@@ -239,6 +241,11 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
         if ltype == "session_meta":
             session_id = session_id or str(payload.get("id", ""))
             project_path = project_path or str(payload.get("cwd", ""))
+            git_data = payload.get("git") or {}
+            if isinstance(git_data, dict):
+                branch = git_data.get("branch")
+                if isinstance(branch, str) and branch:
+                    git_branch = branch
         elif ltype == "turn_context":
             # turn_context refines model + cwd over time; the latest wins.
             cwd = payload.get("cwd")
@@ -247,6 +254,12 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
             mdl = payload.get("model")
             if mdl:
                 model = str(mdl)
+        elif ltype == "event_msg" and payload.get("type") == "thread_name_updated":
+            # Codex's equivalent of Claude Code's customTitle — driven by
+            # task-naming flow. Latest-wins so renames mid-session are honored.
+            tname = payload.get("thread_name")
+            if isinstance(tname, str) and tname:
+                session_name = tname
 
     # ── Pass 2: tool calls from response_item (3 shapes) ──
     all_tool_calls: list[ToolCall] = []
@@ -411,8 +424,9 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
 
     return SessionTelemetry(
         session_id=session_id,
+        session_name=session_name,
         project_path=project_path,
-        git_branch=None,  # Codex doesn't surface git_branch in transcripts
+        git_branch=git_branch,
         model=model,
         runtime=_REGISTRY.runtime,
         timestamp=session_start,

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/telemetry/contract.py

@@ -104,6 +104,7 @@ def _assemble(t: SessionTelemetry, cost: float) -> dict[str, Any]:
     return {
         "session": {
             "id": t.session_id,
+            "name": t.session_name,
             "start": t.timestamp.isoformat(),
             "end": end,
             "duration_minutes": t.duration_minutes,
@@ -162,7 +163,6 @@ def _assemble(t: SessionTelemetry, cost: float) -> dict[str, Any]:
         "user_events": [
             {"category": e.category.value, "preview": e.message_preview, "confidence": e.confidence.value}
             for e in t.user_events
-            if e.category.value != "continuation"
         ],
         "agents": [
             {"id": a.agent_id, "type": a.agent_type, "tool_calls": a.tool_calls, "tokens": a.total_tokens}

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/telemetry/models.py

@@ -248,6 +248,16 @@ class SessionTelemetry(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
     session_id: str
+    session_name: str = Field(
+        default="",
+        description=(
+            "Human-readable session identifier. Claude Code: latest customTitle "
+            "from `custom-title` records (driven by /rename and auto-titling). "
+            "Codex: latest thread_name from `event_msg/thread_name_updated` events. "
+            "Empty when neither is available — consumers fall back to first-prompt "
+            "slug or session_id when constructing receipt filenames."
+        ),
+    )
     project_path: str
     git_branch: str | None = None
     model: str | None = None

{hyperweave-0.3.0 → hyperweave-0.3.1}/src/hyperweave/telemetry/parser.py

@@ -14,6 +14,7 @@ from __future__ import annotations
 
 import json
 import logging
+import re
 from datetime import datetime
 from pathlib import Path
 from typing import Any
@@ -40,6 +41,15 @@ _JsonObj = dict[str, Any]
 # Resolved at import time — fail loud if claude-code.yaml is missing.
 _REGISTRY = get_runtime("claude-code")
 
+# Match content that consists entirely of one or more XML envelopes
+# emitted by the Claude Code harness (e.g. <command-name>...</command-name>,
+# <local-command-stdout>...</local-command-stdout>, <system-reminder>...</...>).
+# These are non-prose framing — never count them as user turns.
+_ENVELOPE_ONLY = re.compile(
+    r"^<[a-z][a-z0-9-]*>.*</[a-z][a-z0-9-]*>$",
+    re.DOTALL,
+)
+
 
 # --------------------------------------------------------------------------- #
 # HELPERS
@@ -199,7 +209,7 @@ def _extract_user_text(obj: _JsonObj) -> str | None:
 
     if isinstance(content, str):
         text = content.strip()
-        if text.startswith("<") and ("command-name" in text or "system-reminder" in text):
+        if _ENVELOPE_ONLY.match(text):
             return None
         return text if text else None
 
@@ -303,6 +313,16 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
         if session_id and project_path and git_branch is not None:
             break
 
+    # `custom-title` records carry the user-facing session name (driven by /rename
+    # and Claude Code's auto-titling, which slugifies the first prompt). One record
+    # is emitted per assistant turn after the most-recent rename, so latest-wins.
+    session_name = ""
+    for line in raw_lines:
+        if line.get("type") == "custom-title":
+            title = line.get("customTitle")
+            if isinstance(title, str) and title:
+                session_name = title
+
     # -- Pass 1: Extract all tool calls from assistant messages --
     all_tool_calls: list[ToolCall] = []
     for line in raw_lines:
@@ -381,7 +401,9 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
             s.error_count += 1
 
     # -- Build totals --
-    total_user_msgs = sum(1 for ln in raw_lines if _is_user_entry(ln))
+    # Count only human-authored prose. type:"user" lines also wrap tool_results
+    # and command-name/local-command-stdout envelopes; those are not turns.
+    total_user_msgs = sum(1 for ln in raw_lines if _is_user_entry(ln) and _extract_user_text(ln) is not None)
     total_assistant_msgs = sum(1 for ln in raw_lines if ln.get("type") == "assistant")
 
     totals = SessionTotals(
@@ -408,6 +430,7 @@ def parse_transcript(transcript_path: str | Path) -> SessionTelemetry:
 
     return SessionTelemetry(
         session_id=session_id,
+        session_name=session_name,
         project_path=project_path,
         git_branch=git_branch,
         model=model,