hyperweave 0.3.2__tar.gz → 0.3.3__tar.gz

{hyperweave-0.3.2 → hyperweave-0.3.3}/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.3] - 2026-05-12
+
+### Fixed
+
+- **Receipt filenames** — use consistent underscore separators; the footer displays the same human-readable filename.
+- **Dark brutalist badge panels** — match the prototype: left panel reads `brand_panel_fill`, label reads `ink-primary`, seam-gap rect restored so the divider region renders the same in any markdown viewer.
+- **Badge layout engine** — brutalist badges land every interior gap (accent→glyph, glyph→label, label→seam, seam→value, value→indicator, indicator→right border) on a single 5px rhythm. `measure_text` now consumes the paradigm's declared `value_letter_spacing_em` so the engine reserves the actual rendered width instead of under-counting by `(n-1) * font_size * em`.
+- **Dark brutalist star charts** — header glyph fill routes through `var(--dna-signal)` (was an orphaned brand-text white). 6px solid left accent rail anchors the chart as a Y-axis spine; outer perimeter softens to a 1.5px hairline at 0.25 opacity so the rail dominates the read.
+- **Light scholar star charts** — area gradient resolves through each variant's panel color across all 6 light variants instead of falling back to the seam color. Substrate-aware paper grain with multiply blend; perimeter inset and grain layer order match the prototype.
+- **Activity graph bars** — light scholar stat cards use the correct accent color.
+- **Divider tick marks** — resolve through the genome palette instead of a hardcoded green.
+
+### Changed
+
+- **Star chart milestone callouts** — now include date context (e.g. `1K · JAN 24`) so the chart is self-documenting without cross-referencing external star history tools.
+- **Star chart milestone markers** — data points use a filled square marker (■) to visually distinguish them from the regular interval crosshair (+) markers.
+
 ## [0.3.2] - 2026-05-11
 
 Brutalist gets 12 variants split by substrate: 6 dark monochromes (celadon, carbon, alloy, temper, pigment, ember) and 6 light scholars (archive, signal, pulse, depth, afterimage, primer). Metadata pipeline wires 12 fields that were silently hardcoded. Per-frame reasoning populates `hw:reasoning` from per-genome YAML.

{hyperweave-0.3.2 → hyperweave-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.3.2
+Version: 0.3.3
 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
@@ -197,11 +197,11 @@ 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/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=celadon" alt="strip"/>
+  <img src="https://hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon" alt="strip"/>
   <br/>
   <ul>
 <li><sub><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></sub></li>
-<li><sub><code>hyperweave.app/v1/strip/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=celadon</code></sub></li>
+<li><sub><code>hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon</code></sub></li>
 </ul>
 </td>
 </tr>

{hyperweave-0.3.2 → hyperweave-0.3.3}/README.md

@@ -165,11 +165,11 @@ 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/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=celadon" alt="strip"/>
+  <img src="https://hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon" alt="strip"/>
   <br/>
   <ul>
 <li><sub><code>/v1/strip/{title}/{genome}.static?data={tokens}&subtitle={text}&glyph={glyph}&variant={variant}</code></sub></li>
-<li><sub><code>hyperweave.app/v1/strip/readme-ai/brutalist.static?data=gh:eli64s/readme-ai.stars,gh:eli64s/readme-ai.forks,pypi:readmeai.version&subtitle=eli64s/readme-ai&glyph=github&variant=celadon</code></sub></li>
+<li><sub><code>hyperweave.app/v1/strip/hyperweave/brutalist.static?data=gh:InnerAura/hyperweave.stars,pypi:hyperweave.version,gh:InnerAura/hyperweave.build&subtitle=InnerAura/hyperweave&glyph=github&variant=celadon</code></sub></li>
 </ul>
 </td>
 </tr>

{hyperweave-0.3.2 → hyperweave-0.3.3}/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.2'
-__version_tuple__ = version_tuple = (0, 3, 2)
+__version__ = version = '0.3.3'
+__version_tuple__ = version_tuple = (0, 3, 3)
 
 __commit_id__ = commit_id = None

{hyperweave-0.3.2 → hyperweave-0.3.3}/src/hyperweave/cli.py

@@ -361,39 +361,52 @@ def session(
 
     frame_type = "receipt" if action == "receipt" else "rhythm-strip"
     genome_slug = _normalize_genome_slug(genome) if genome else ""
+
+    # Pre-compute the receipt's on-disk filename (when applicable) so the
+    # footer can render the same human-readable basename as the file the
+    # user sees. The compose pipeline reads receipt_filename_hint when set;
+    # an empty hint falls back to the legacy UUID-path footer (HTTP / MCP).
+    filename_hint = ""
+    if action == "receipt" and not output:
+        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 / receipt_filename(
+            timestamp=ts,
+            session_name=session_name,
+            session_id=sid,
+            prompt_text=first_prompt,
+        )
+        filename_hint = output.name
+    elif action == "receipt" and output:
+        # Explicit --output: the user picked a basename; surface it.
+        filename_hint = output.name
+
     spec = ComposeSpec(
         type=frame_type,
         genome_id=genome_slug,
         telemetry_data=contract,
+        receipt_filename_hint=filename_hint,
     )
     result = do_compose(spec)
 
     if action == "receipt":
-        # Default output: .hyperweave/receipts/{date}_{time}_{slug}.svg
-        if not output:
-            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 / receipt_filename(
-                timestamp=ts,
-                session_name=session_name,
-                session_id=sid,
-                prompt_text=first_prompt,
-            )
-
+        # output is guaranteed non-None here: the receipt branch above either
+        # received an explicit --output or computed a default path.
+        assert output is not None
         output.parent.mkdir(parents=True, exist_ok=True)
         output.write_text(result.svg)
 

{hyperweave-0.3.2 → hyperweave-0.3.3}/src/hyperweave/compose/layout.py

@@ -110,6 +110,8 @@ def compute_badge_layout(
     value_font_size: float,
     right_canvas_inset: int = 0,
     min_total_w: int = 60,
+    inner_bit_ratio: float = 0.5,
+    rhythm_gap: int = 0,
 ) -> BadgeLayout:
     """Compute every position the badge templates need from input measurements.
 
@@ -121,44 +123,83 @@ def compute_badge_layout(
 
     The centering correctness is verified by ``tests/test_badge_layout``
     against short / long / version / license / python_requires values.
+
+    When ``rhythm_gap > 0`` (brutalist v0.3.3 sets 8), the layout collapses
+    every interior gap to a single value: accent_right→glyph_left,
+    glyph_right→label_first, label_last→seam_left, seam_right→value_first,
+    value_last→indicator_left, indicator_right→right_border. Caller must
+    also set ``ind_pad_r=rhythm_gap`` so the indicator gaps land on the
+    same rhythm.
     """
     # Glyph pixel position. Mirrors resolver.py logic: paradigms with a
     # left-edge decoration zone (cellular pattern strip x=2..~20) reserve
     # space via ``glyph_left_offset``; brutalist/chrome declare 0.
+    # When rhythm_gap is set, the glyph sits exactly ``rhythm_gap`` right
+    # of the accent bar so the accent→glyph gap matches the global rhythm.
     if has_glyph:
-        glyph_x = (inset + accent_w + 4) if inset else (accent_w + 3)
-        glyph_x += glyph_left_offset
+        if rhythm_gap > 0:
+            glyph_x = accent_w + rhythm_gap + glyph_left_offset
+        else:
+            glyph_x = (inset + accent_w + 4) if inset else (accent_w + 3)
+            glyph_x += glyph_left_offset
         glyph_y = round((height - glyph_size) / 2, 1)
     else:
         glyph_x, glyph_y = 0, 0.0
 
     # Label area starts after the glyph (or after the accent + paradigm
-    # left-edge decoration when there's no glyph). The no-glyph branch
-    # must respect glyph_left_offset too — cellular pattern strip runs
-    # to ~x=20 even when no glyph is rendered.
-    label_start = (glyph_x + glyph_size + glyph_gap) if has_glyph else (accent_w + 6 + glyph_left_offset)
+    # left-edge decoration when there's no glyph). When rhythm_gap > 0,
+    # the glyph→label gap (with-glyph) and accent→label gap (no-glyph)
+    # both equal rhythm_gap.
+    if rhythm_gap > 0:
+        label_start = (glyph_x + glyph_size + rhythm_gap) if has_glyph else (accent_w + rhythm_gap + glyph_left_offset)
+    else:
+        label_start = (glyph_x + glyph_size + glyph_gap) if has_glyph else (accent_w + 6 + glyph_left_offset)
 
     # Left panel width — fits the label plus paradigm-driven right padding.
-    label_pad_r = 9 if use_mono else 8
+    # rhythm_gap mode forces label_pad_r = rhythm_gap so label_last→seam_left
+    # equals the global rhythm. Legacy mode keeps the 9 (mono) / 8 (non-mono)
+    # default tuned for chrome/cellular's denser label kerning.
+    label_pad_r = rhythm_gap if rhythm_gap > 0 else (9 if use_mono else 8)
     left_panel = round(label_start + measured_label_w + label_pad_r)
     left_panel = max(left_panel, 30)
 
-    # Label text center is the midpoint of the label area. For uppercase
-    # labels the visual right edge is 6px shy of the panel boundary so
-    # the cap glyphs don't kiss the seam.
-    label_area_end = left_panel - (6 if label_uppercase else 0)
-    label_x = round((label_start + label_area_end) / 2, 1)
+    # Label text center. Legacy mode centers the label in [label_start,
+    # label_area_end] with a 6px shy-from-seam adjustment for uppercase
+    # labels. rhythm_gap mode aligns label_first with label_start exactly
+    # (label_x = label_start + w/2) so the accent_right→label_first gap
+    # lands at ``rhythm_gap`` regardless of label_w. The legacy area-center
+    # formula leaves a (panel_w - label_w)/2 interior gutter inside the
+    # label area, which collapses the structural gap to ~(rhythm_gap +
+    # interior_gutter)/2 — visible as 12.2/4.2 asymmetry on a 35.64px
+    # label in a 44px area when targeting an 8px rhythm.
+    if rhythm_gap > 0:
+        label_area_end = left_panel
+        label_x = round(label_start + measured_label_w / 2, 1)
+    else:
+        label_area_end = left_panel - (6 if label_uppercase else 0)
+        label_x = round((label_start + label_area_end) / 2, 1)
 
     # Right-panel allocation. ``ls_extra`` accounts for non-mono letter-
     # spacing overrun (each char carries 0.4 of trailing tracking).
     indicator_alloc = (indicator_size + ind_pad_r) if show_indicator else 0
     ls_extra = value_raw_len * 0.4 if (not use_mono and value_raw_len) else 0
-    # right_panel reserves: val_pad_l (left interior gutter), the measured
-    # value text + letter-spacing overrun, val_min_gap (right interior gutter),
-    # and indicator_alloc when stateful. Pre-v0.3.0 reserved 2 * val_min_gap
-    # which left ~val_min_gap of unaccounted slack on stateless badges
-    # (visible as ~4.5px right padding instead of symmetric ~3px).
-    right_panel = val_pad_l + measured_value_w + ls_extra + val_min_gap + indicator_alloc
+    # Gap between value text right edge and the indicator's left edge. For
+    # stateful badges this mirrors ``ind_pad_r`` (gap right of indicator) so
+    # the indicator sits with equal interior padding on both sides — the
+    # cohesive-balance contract the brutalist v16 prototype encodes. For
+    # stateless badges there's no indicator, so the trailing pad collapses
+    # to ``val_min_gap`` (3px tight right gutter; tighter than the stateful
+    # symmetric gap because there's no marker to balance against).
+    text_to_indicator_gap = ind_pad_r if show_indicator else val_min_gap
+    # rhythm_gap mode overrides ``val_pad_l`` (seam→value gap) to the
+    # global rhythm. Legacy mode keeps the resolver-supplied val_pad_l
+    # (3px) for chrome/cellular/default paradigms.
+    effective_val_pad_l = rhythm_gap if rhythm_gap > 0 else val_pad_l
+    # right_panel reserves: effective_val_pad_l (left interior gutter), the
+    # measured value text + letter-spacing overrun, text_to_indicator_gap
+    # (right interior gutter), and indicator_alloc when stateful. Symmetric
+    # stateful: text + ind_pad_r + indicator_size + ind_pad_r.
+    right_panel = effective_val_pad_l + measured_value_w + ls_extra + text_to_indicator_gap + indicator_alloc
     total_w = round(left_panel + sep_w + seam_w + right_panel)
     total_w = max(total_w, min_total_w)
 
@@ -176,13 +217,14 @@ def compute_badge_layout(
     # which is the midpoint of [zone_left, indicator_left_edge], not
     # [zone_left, zone_right]. Old formula skewed text by val_min_gap/2
     # toward the indicator and was undefined when no indicator rendered.
-    value_zone_left = right_panel_x + val_pad_l
+    value_zone_left = right_panel_x + effective_val_pad_l
     # When stateless (no indicator), the slab's right edge is total_w minus
-    # any paradigm-specific canvas inset (cellular: 2; brutalist/chrome: 0).
-    # val_min_gap is the symmetric trailing pad — together they place
-    # value_zone_right at the slab's interior right boundary so a centered
-    # text lands at slab geometric center.
-    value_zone_right = (indicator_x - val_min_gap) if show_indicator else (total_w - right_canvas_inset - val_min_gap)
+    # any paradigm-specific canvas inset (cellular: 2; brutalist/chrome: 0)
+    # minus val_min_gap (tight 3px trailing pad). When stateful, the right
+    # edge sits ind_pad_r inside the indicator's left edge — mirroring the
+    # right-of-indicator gap so the indicator reads as equidistant from
+    # the value text and from the badge's right border.
+    value_zone_right = (indicator_x - ind_pad_r) if show_indicator else (total_w - right_canvas_inset - val_min_gap)
     value_zone_width = value_zone_right - value_zone_left
     value_x = round((value_zone_left + value_zone_right) / 2, 1)
 
@@ -196,9 +238,12 @@ def compute_badge_layout(
     indicator_y = round(text_y - value_font_size * 0.3 - indicator_size / 2, 1)
 
     # Indicator inner-bit geometry — moved from cellular/brutalist
-    # template-side arithmetic. The bit is half the indicator side,
-    # centered.
-    inner_bit_w = indicator_size // 2
+    # template-side arithmetic. v0.3.3 generalizes the ratio so brutalist
+    # can render the prototype's 6/10 (0.6) bit instead of the cellular
+    # 4/8 (0.5) default — caller passes a paradigm-driven ratio. Rounded
+    # to the nearest integer so the bit lands on a pixel grid; offset is
+    # the half-difference, which can be a half-pixel for odd ratios.
+    inner_bit_w = round(indicator_size * inner_bit_ratio)
     inner_bit_offset = (indicator_size - inner_bit_w) / 2
 
     return BadgeLayout(

{hyperweave-0.3.2 → hyperweave-0.3.3}/src/hyperweave/compose/resolver.py

@@ -335,8 +335,30 @@ def resolve_badge(
         if badge_cfg_for_seam and badge_cfg_for_seam.seam_w > 0
         else profile.get("badge_seam_width", 3)
     )
-    indicator_size = profile.get("badge_indicator_size", 8)
-    ind_pad_r = profile.get("badge_indicator_pad_r", 8)
+    # Indicator geometry: paradigm overrides profile defaults. Brutalist v0.3.3
+    # declares 10x10 + ind_pad_r=10 to match the v16 prototype's translate(138,5);
+    # chrome and cellular continue to fall back to their profile defaults.
+    badge_cfg_for_indicator = paradigm_spec.badge if paradigm_spec else None
+    indicator_size = (
+        badge_cfg_for_indicator.indicator_size
+        if badge_cfg_for_indicator and badge_cfg_for_indicator.indicator_size > 0
+        else profile.get("badge_indicator_size", 8)
+    )
+    ind_pad_r = (
+        badge_cfg_for_indicator.indicator_pad_r
+        if badge_cfg_for_indicator and badge_cfg_for_indicator.indicator_pad_r > 0
+        else profile.get("badge_indicator_pad_r", 8)
+    )
+    indicator_stroke_width = (
+        badge_cfg_for_indicator.indicator_stroke_width
+        if badge_cfg_for_indicator and badge_cfg_for_indicator.indicator_stroke_width > 0
+        else 1.2
+    )
+    indicator_inner_bit_ratio = (
+        badge_cfg_for_indicator.indicator_inner_bit_ratio
+        if badge_cfg_for_indicator and badge_cfg_for_indicator.indicator_inner_bit_ratio > 0
+        else 0.5
+    )
     inset = profile.get("badge_inset", 0)
     # text_y_factor from paradigm (cellular uses 0.656 matching spec y=21 at
     # h=32; brutalist/chrome use 0.69 baseline). One place drives the math.
@@ -364,18 +386,26 @@ def resolve_badge(
         _label_size = max(round(_label_size * 0.78), 6)
         _value_size = max(round(_value_size * 0.78), 7)
 
-    # Monospace labels carry letter-spacing 0.06em (CSS declared in chrome-
-    # defs). Pre-v0.2.25 the resolver added len(text)*font_size*0.06 AFTER
-    # measure_text returned, double-counting and using the wrong (N vs N-1)
-    # formula. measure_text now applies (max(0, N-1) * font_size * em)
-    # internally — single source of truth in core/text.py.
+    # Letter-spacing values come from the paradigm's badge config so
+    # measure_text reserves the exact width the template will render. The
+    # paradigm's declared values are the canonical source; the
+    # ``0.06 if use_mono else 0.0`` fallback preserves pre-v0.3.3 behavior
+    # for paradigms (cellular, default) that haven't declared their badge
+    # letter-spacing yet. measure_text applies ``(max(0, N-1) * font_size
+    # * em)`` internally — single source of truth in core/text.py.
+    _label_ls_em = (
+        paradigm_spec.badge.label_letter_spacing_em
+        if paradigm_spec and paradigm_spec.badge.label_letter_spacing_em > 0
+        else (0.06 if use_mono else 0.0)
+    )
+    _value_ls_em = paradigm_spec.badge.value_letter_spacing_em if paradigm_spec else 0.0
     lw = (
         measure_text(
             label_display,
             font_family=_label_family,
             font_size=_label_size,
             font_weight=400 if use_mono else 700,
-            letter_spacing_em=0.06 if use_mono else 0.0,
+            letter_spacing_em=_label_ls_em,
         )
         if label_display
         else 0.0
@@ -386,6 +416,7 @@ def resolve_badge(
             font_family=_value_family,
             font_size=_value_size,
             font_weight=_value_weight,
+            letter_spacing_em=_value_ls_em,
         )
         if value_raw
         else 0.0
@@ -426,6 +457,16 @@ def resolve_badge(
     # All badge geometry now lives in compose/layout.py — single source of
     # truth, unit-tested independently. The v0.2.25 centering fix is in there
     # (value_x = zone_center, not midpoint of unrelated bounds).
+    # Uniform-rhythm gap: when the paradigm declares a positive
+    # ``rhythm_gap`` (brutalist v0.3.3 sets 8), every interior gap of the
+    # badge composition (accent→glyph or accent→label, glyph→label,
+    # label→seam, seam→value, value→indicator, indicator→right border)
+    # collapses to that single value. Paradigms that don't declare it
+    # (chrome / cellular / default) receive 0 and keep their legacy layout
+    # constants. When rhythm_gap > 0, ``ind_pad_r`` is also forced to the
+    # same value so the value→indicator and indicator→right-border gaps
+    # match the rest of the rhythm.
+    rhythm_gap = paradigm_spec.badge.rhythm_gap if paradigm_spec else 0
     layout = compute_badge_layout(
         height=height,
         measured_label_w=lw,
@@ -449,6 +490,8 @@ def resolve_badge(
         right_canvas_inset=right_canvas_inset,
         text_y_factor=text_y_factor,
         value_font_size=_value_size,
+        inner_bit_ratio=indicator_inner_bit_ratio,
+        rhythm_gap=rhythm_gap,
     )
 
     # Variant resolution and profile visual context (envelope, well, specular,
@@ -483,6 +526,7 @@ def resolve_badge(
             "indicator_size": layout.indicator_size,
             "inner_bit_w": layout.inner_bit_w,
             "inner_bit_offset": layout.inner_bit_offset,
+            "indicator_stroke_width": indicator_stroke_width,
             "accent_bar_width": accent_w,
             "has_glyph": has_glyph,
             "show_indicator": layout.show_indicator,
@@ -1100,10 +1144,18 @@ def resolve_divider(
         "divider_label": spec.value or "",
         "variant": spec.variant or "",
         # Pass through chrome chromosomes so chrome-band template's envelope_stops
-        # for-loop has data. brutalist-seam needs accent + accent_signal.
+        # for-loop has data. brutalist-seam needs accent + accent_complement (was
+        # accent_signal pre-v0.3.3 — see brutalist-seam.svg.j2 header for the
+        # chromatic-register rationale). zeropoint (editorial default) needs
+        # accent + accent_complement + surface_deep to drive its variant-aware
+        # aurora gradient + nexus beacon without hardcoded chromatic literals.
+        # accent_signal stays in context for backward-compat — currently no
+        # divider template reads it but other surfaces may grow into the field.
         "envelope_stops": genome.get("envelope_stops", []),
         "accent": genome.get("accent", ""),
+        "accent_complement": genome.get("accent_complement", ""),
         "accent_signal": genome.get("accent_signal", ""),
+        "surface_deep": genome.get("surface_2", ""),
     }
     # Profile visual context now injected centrally by the dispatcher.
 
@@ -1704,12 +1756,16 @@ def _truncate_path_left(
     """Truncate ``path`` from the LEFT (drop prefix, keep filename end) so the
     result fits inside ``max_w`` pixels at 9pt JetBrains Mono.
 
-    Receipt footer paths look like ``.hyperweave/receipts/<uuid>.svg``,
-    where the UUID suffix is the only distinguishing information; the
-    ``.hyperweave/receipts/`` prefix is constant noise across every
-    session. Left-truncation preserves the meaningful end and emits
-    ``…<unique-suffix>``, so a footer line that would otherwise collide
-    with the right-aligned session date stays inside the content track.
+    Receipt footer paths take one of two shapes depending on the caller:
+    the CLI write path emits a human-readable basename like
+    ``20260508_receipt_debug_v0226.svg`` (set via
+    ``ComposeSpec.receipt_filename_hint``); HTTP / MCP callers without the
+    hint emit the legacy ``.hyperweave/receipts/<uuid>.svg`` shape. In both
+    cases the *end* of the string carries the most identifying information
+    (the slug or the UUID), and any leading prefix is the lower-signal
+    portion to drop. Left-truncation emits ``…<unique-suffix>`` so a
+    footer line that would otherwise collide with the right-aligned
+    session date stays inside the content track.
 
     Returns the input unchanged when it already fits. Returns the empty
     string when ``max_w`` is too small even for a single ellipsis. Width
@@ -2169,7 +2225,16 @@ def resolve_receipt(
     git_branch = session.get("git_branch", "")
     project_path = session.get("project_path", "")
     project_name = Path(project_path).name if project_path else "session"
-    receipt_path = f".hyperweave/receipts/{session_id}.svg" if session_id else ""
+    # Footer filepath token: prefer the CLI-supplied human-readable basename
+    # (matches the file the user sees on disk — e.g. "20260508_receipt_debug_v0226.svg").
+    # Fall back to the legacy UUID path so HTTP / MCP callers that don't set
+    # receipt_filename_hint keep rendering rather than blanking the footer.
+    if spec.receipt_filename_hint:
+        receipt_path = spec.receipt_filename_hint
+    elif session_id:
+        receipt_path = f".hyperweave/receipts/{session_id}.svg"
+    else:
+        receipt_path = ""
 
     start_iso = session.get("start", "")
     start_formatted = ""

{hyperweave-0.3.2 → hyperweave-0.3.3}/src/hyperweave/core/models.py

@@ -147,6 +147,17 @@ class ComposeSpec(FrozenModel):
     telemetry_data: dict[str, object] | None = Field(
         default=None, description="Session data contract JSON (telemetry frames only)"
     )
+    receipt_filename_hint: str = Field(
+        default="",
+        description=(
+            "Human-readable filename basename for the receipt footer (e.g. "
+            "'20260508_receipt_debug_v0226.svg'). Set by the CLI write path "
+            "after computing the on-disk filename so the footer's filepath "
+            "token matches the file the user sees. Empty string falls back "
+            "to the legacy '.hyperweave/receipts/{uuid}.svg' path so HTTP / "
+            "MCP callers that don't set the hint keep rendering."
+        ),
+    )
 
     # -- Divider-specific --
     divider_variant: DividerVariant = Field(

{hyperweave-0.3.2 → hyperweave-0.3.3}/src/hyperweave/core/paradigm.py

@@ -283,6 +283,47 @@ class ParadigmBadgeConfig(FrozenModel):
     at ``x=2..width-2`` per cellular-content.j2:9). Without this override,
     ``value_zone_right`` lands ``right_canvas_inset`` past the actual slab
     edge and drifts the centered value text right by half that amount."""
+    indicator_size: int = 0
+    """Optional paradigm-specific indicator side length. ``> 0`` overrides
+    the profile's ``badge_indicator_size``. Brutalist v0.3.3 sets 10 to
+    match the v16 badge matrix prototype (concentric 10x10 outline + 6x6
+    inner bit). Zero (default) defers to the profile."""
+    indicator_pad_r: int = 0
+    """Optional paradigm-specific right padding for the indicator. ``> 0``
+    overrides the profile's ``badge_indicator_pad_r``. Brutalist v0.3.3
+    sets 10 so the 10x10 indicator anchors at x=138 in a 158px badge
+    (matches prototype's ``translate(138,5)``). Zero defers to the profile."""
+    indicator_stroke_width: float = 0.0
+    """Optional paradigm-specific outer-ring stroke width for the indicator.
+    ``> 0`` overrides the layout-engine default (1.2). Brutalist v0.3.3
+    sets 1.5 to match the prototype's heavier ring weight. Zero defers
+    to the default."""
+    indicator_inner_bit_ratio: float = 0.0
+    """Optional paradigm-specific inner-bit/outer-ring side-length ratio.
+    ``> 0`` overrides the layout-engine default (0.5 — bit half of outer).
+    Brutalist v0.3.3 sets 0.6 (10→6) to match the prototype's heavier
+    inner mark. Zero defers to the default."""
+    label_letter_spacing_em: float = 0.0
+    """CSS-rendered ``letter-spacing`` for the label text. Resolver passes
+    this to ``measure_text`` so the layout reserves the actual rendered
+    width. Pre-v0.3.3 the resolver hardcoded ``0.06 if use_mono else 0.0``;
+    paradigm-driven now so brutalist (0.06) and chrome (0.12) declare the
+    measurement value alongside the template's ``letter-spacing`` attribute."""
+    value_letter_spacing_em: float = 0.0
+    """CSS-rendered ``letter-spacing`` for the value text. Brutalist's value
+    text declares ``letter-spacing="0.04em"`` in the template; before this
+    field landed the resolver passed ``0.0`` to measure_text and the badge
+    layout under-reserved width by ``(n-1) * font_size * 0.04`` — visible as
+    the value text overflowing the value zone by ~2.6px on a 7-char value."""
+    rhythm_gap: int = 0
+    """When ``> 0``, the badge layout engine uses a uniform interior rhythm:
+    every interior gap (accent→glyph, glyph→label, label→seam, seam→value,
+    value→indicator, indicator→right border) equals ``rhythm_gap`` pixels.
+    Forces ``label_start = accent_w + rhythm_gap``, ``label_pad_r = rhythm_gap``,
+    ``val_pad_l = rhythm_gap``, ``glyph_gap = rhythm_gap``, and disables the
+    uppercase shy-from-seam adjustment. Zero (default) preserves legacy
+    layout for chrome/cellular/default paradigms; brutalist sets 8 to match
+    the v16 prototype's symmetric composition."""
 
 
 class ParadigmIconConfig(FrozenModel):