hyperweave 0.2.25__tar.gz → 0.2.26__tar.gz

{hyperweave-0.2.25 → hyperweave-0.2.26}/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.2.26] - 2026-05-07
+
+Two follow-ups to v0.2.25's badge state architecture: strip status indicators now color correctly when CI metrics fail, and the snapshot test suite no longer fails on local-vs-CI version differences.
+
+### Fixed
+
+- **Strip status indicator color tracks the most severe CI metric** — a strip with `BUILD:failing` next to `STARS` and `VERSION` now renders the right-edge diamond red, matching pre-v0.2.25 behavior. The v0.2.25 narrowing inadvertently dropped this for strips because their title is the repo identifier (`HYPERWEAVE`, `readme-ai`), not a state-bearing label. The engine now parses strip metric cells, runs state inference per allowlisted cell (`BUILD`, `COVERAGE`, `LINT`, etc.), and rolls up to the most severe state across them. Pure data strips (no allowlisted cells) stay neutral.
+- **Snapshot tests handle local-vs-CI version differences** — the URL stability suite was treating package version strings as content (`version="0.2.20"` vs `version="0.2.25"` from dynamic git-tag versioning), failing CI when local snapshots were captured at a different version than the runner. Versions in metadata are now normalized for comparison alongside UUIDs and timestamps.
+
+### Notes
+
+- 960 tests (was 955). 5 new tests pin the strip rollup contract across failing / passing / mixed-severity / pure-data / explicit-override cases.
+
 ## [0.2.25] - 2026-05-07
 
 Production badges on data-driven URLs (`STARS`, `FORKS`, `VERSION`, `LICENSE`, `PYTHON`) no longer trigger false-alarm status indicators on numeric values. Badge value text now centers correctly for every value length across all genomes.

{hyperweave-0.2.25 → hyperweave-0.2.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.2.25
+Version: 0.2.26
 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

{hyperweave-0.2.25 → hyperweave-0.2.26}/src/hyperweave/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.25'
-__version_tuple__ = version_tuple = (0, 2, 25)
+__version__ = version = '0.2.26'
+__version_tuple__ = version_tuple = (0, 2, 26)
 
 __commit_id__ = commit_id = None

hyperweave-0.2.26/src/hyperweave/compose/engine.py

@@ -0,0 +1,167 @@
+"""Composition engine -- the single entry point for all artifact generation."""
+
+from __future__ import annotations
+
+import time
+
+from hyperweave.core.models import ArtifactMetadata, ComposeResult, ComposeSpec, ResolvedArtifact
+
+
+def compose(spec: ComposeSpec) -> ComposeResult:
+    """Compose an artifact from a ComposeSpec."""
+    start = time.monotonic()
+
+    # ── 0. Infer state from value when the caller left the default ──
+    # Any explicit override (?state=failing, --state passing, MCP state arg,
+    # etc.) sets spec.state to something other than "active" and survives
+    # this step untouched. This is the single chokepoint covering HTTP,
+    # CLI, MCP, and kit.
+    #
+    # v0.2.25: gated on the stateful-title allowlist (data/badge_modes.yaml).
+    # Pre-v0.2.25 the inference fired on EVERY frame regardless of title —
+    # so a STARS=42 badge was auto-inferred to state="critical" (leading
+    # digit 4) and rendered an orange/red status indicator on a value with
+    # no semantic state.
+    #
+    # Frame-aware logic:
+    #   Badge → title-keyed inference. Title in allowlist → run infer_state.
+    #   Strip → per-cell rolled-up inference. Strip's spec.title is the
+    #           repo identifier (HYPERWEAVE, readme-ai), not a state-
+    #           bearing label — state lives in the metric cells. Parse
+    #           cells, run infer_state on each allowlisted (label, value)
+    #           pair, take the most severe state.
+    if spec.state == "active" and spec.value:
+        from hyperweave.compose.layout import normalize_title
+        from hyperweave.config.loader import load_badge_modes
+        from hyperweave.core.enums import FrameType
+        from hyperweave.core.state import infer_state
+
+        allowlist = load_badge_modes()
+        # Severity ordering when rolling up across multiple metric cells.
+        # critical / failing share the most-severe slot — both render red.
+        _SEVERITY = {
+            "active": 0,
+            "passing": 1,
+            "building": 2,
+            "warning": 3,
+            "critical": 4,
+            "failing": 4,
+        }
+
+        inferred: str = "active"
+        if spec.type == FrameType.BADGE and spec.title:
+            if normalize_title(spec.title) in allowlist:
+                inferred = infer_state(spec.title, spec.value)
+        elif spec.type == FrameType.STRIP:
+            # Roll up across metric cells. v0.2.24 and earlier accidentally
+            # got this for free because infer_state ran on the strip's
+            # whole comma-separated value string and found "fail" in
+            # "BUILD:failing" — a happy substring-match accident. v0.2.25's
+            # title gate broke that path. Per-cell inference is the
+            # principled replacement: only allowlisted cells contribute
+            # state, and we pick the most severe.
+            best_severity = 0
+            for label, value in _parse_strip_metric_pairs(spec):
+                if normalize_title(label) in allowlist:
+                    cell_state = infer_state(label, value)
+                    sev = _SEVERITY.get(cell_state, 0)
+                    if sev > best_severity:
+                        inferred = cell_state
+                        best_severity = sev
+
+        if inferred != "active":
+            spec = spec.model_copy(update={"state": inferred})
+
+    # ── 1. Resolve genome, profile, frame ──
+    from hyperweave.compose.resolver import resolve
+
+    resolved = resolve(spec)
+
+    # ── 2. Assemble CSS ──
+    from hyperweave.compose.assembler import assemble_css
+
+    css_bundle = assemble_css(resolved, frame_type=spec.type)
+
+    # ── 3. Build template context ──
+    from hyperweave.compose.context import build_context
+
+    context = build_context(spec, resolved, css_bundle)
+
+    # ── 4. Enforce policy lanes ──
+    from hyperweave.compose.lanes import enforce
+
+    context = enforce(context, spec.regime)
+
+    # ── 5. Render template → SVG ──
+    from hyperweave.render.templates import render_artifact
+
+    svg = render_artifact(resolved.frame_template, context)
+
+    # ── 6. Build result ──
+    duration_ms = (time.monotonic() - start) * 1000
+
+    metadata = _build_metadata(spec, resolved, duration_ms)
+
+    result = ComposeResult(
+        svg=svg,
+        metadata=metadata,
+        width=resolved.width,
+        height=resolved.height,
+    )
+
+    # ── 7. Emit telemetry event (fire-and-forget) ──
+    try:
+        from hyperweave.telemetry.capture import emit_generation_event
+
+        emit_generation_event(spec, result)
+    except Exception:
+        pass  # telemetry must never break compose
+
+    return result
+
+
+def _parse_strip_metric_pairs(spec: ComposeSpec) -> list[tuple[str, str]]:
+    """Parse strip metric (label, value) pairs from spec.
+
+    Mirrors ``compose/resolver.py:_parse_metrics`` but lives here so engine
+    step 0 can run state inference before resolve() is called. Two sources:
+
+    * ``spec.slots`` entries with zones starting with ``metric`` —
+      ``slot.value`` of the form ``"LABEL:value"``.
+    * Comma-separated fallback in ``spec.value`` —
+      ``"STARS:2.9k,FORKS:278,BUILD:failing"``.
+    """
+    pairs: list[tuple[str, str]] = []
+    for slot in spec.slots:
+        if slot.zone.startswith("metric") and ":" in slot.value:
+            k, v = slot.value.split(":", 1)
+            pairs.append((k.strip(), v.strip()))
+    if not pairs and spec.value:
+        for pair_str in spec.value.split(","):
+            stripped = pair_str.strip()
+            if ":" in stripped:
+                k, v = stripped.split(":", 1)
+                pairs.append((k.strip(), v.strip()))
+    return pairs
+
+
+def _build_metadata(
+    spec: ComposeSpec,
+    resolved: ResolvedArtifact,
+    duration_ms: float,
+) -> ArtifactMetadata:
+    return ArtifactMetadata(
+        type=spec.type,
+        genome=spec.genome_id,
+        profile=resolved.profile_id,
+        divider_variant=spec.divider_variant,
+        motion=resolved.motion,
+        state=spec.state,
+        regime=spec.regime,
+        width=resolved.width,
+        height=resolved.height,
+        metadata_tier=spec.metadata_tier,
+        duration_ms=round(duration_ms, 2),
+        generation=spec.generation,
+        series=spec.series,
+    )

{hyperweave-0.2.25 → hyperweave-0.2.26}/tests/snapshots/url_stability/divider_band_chrome_static.svg

@@ -22,10 +22,10 @@
   <title id="hw-UID-title">HyperWeave divider artifact</title>
   <desc id="hw-UID-desc">A divider artifact, using chrome genome.</desc>
   <metadata>
-  <hw:artifact id="UUID" type="divider" series="core" version="0.2.20"
+  <hw:artifact id="UUID" type="divider" series="core" version="VERSION"
                xmlns:hw="https://hyperweave.app/hw/v1.0">
     <hw:provenance>
-      <hw:generator>HyperWeave Compositor v0.2.20 (InnerAura Labs)</hw:generator>
+      <hw:generator>HyperWeave Compositor vVERSION (InnerAura Labs)</hw:generator>
       <hw:created>TIMESTAMP</hw:created>
       <hw:human-directed>true</hw:human-directed>
     </hw:provenance>
@@ -34,7 +34,7 @@
   </hw:artifact>
   <hw:composition xmlns:hw="https://hyperweave.app/hw/v1.0">
     <hw:frame>divider</hw:frame>
-    <hw:genome>chrome@0.2.20</hw:genome>
+    <hw:genome>chrome@VERSION</hw:genome>
     <hw:profile>chrome</hw:profile>
     <hw:slots>
     </hw:slots>
@@ -44,7 +44,7 @@
            xmlns:dc="http://purl.org/dc/elements/1.1/">
     <rdf:Description>
       <dc:title>HyperWeave divider artifact</dc:title>
-      <dc:creator>HyperWeave Compositor v0.2.20 (InnerAura Labs)</dc:creator>
+      <dc:creator>HyperWeave Compositor vVERSION (InnerAura Labs)</dc:creator>
       <dc:date>TIMESTAMP</dc:date>
       <dc:rights>CC BY 4.0</dc:rights>
     </rdf:Description>

{hyperweave-0.2.25 → hyperweave-0.2.26}/tests/snapshots/url_stability/icon_github_chrome_static.svg

@@ -23,10 +23,10 @@
   <title id="hw-UID-title">github</title>
   <desc id="hw-UID-desc">A icon artifact, using chrome genome.</desc>
   <metadata>
-  <hw:artifact id="UUID" type="icon" series="core" version="0.2.20"
+  <hw:artifact id="UUID" type="icon" series="core" version="VERSION"
                xmlns:hw="https://hyperweave.app/hw/v1.0">
     <hw:provenance>
-      <hw:generator>HyperWeave Compositor v0.2.20 (InnerAura Labs)</hw:generator>
+      <hw:generator>HyperWeave Compositor vVERSION (InnerAura Labs)</hw:generator>
       <hw:created>TIMESTAMP</hw:created>
       <hw:human-directed>true</hw:human-directed>
     </hw:provenance>
@@ -35,7 +35,7 @@
   </hw:artifact>
   <hw:composition xmlns:hw="https://hyperweave.app/hw/v1.0">
     <hw:frame>icon</hw:frame>
-    <hw:genome>chrome@0.2.20</hw:genome>
+    <hw:genome>chrome@VERSION</hw:genome>
     <hw:profile>chrome</hw:profile>
     <hw:slots>
     </hw:slots>
@@ -45,7 +45,7 @@
            xmlns:dc="http://purl.org/dc/elements/1.1/">
     <rdf:Description>
       <dc:title>github</dc:title>
-      <dc:creator>HyperWeave Compositor v0.2.20 (InnerAura Labs)</dc:creator>
+      <dc:creator>HyperWeave Compositor vVERSION (InnerAura Labs)</dc:creator>
       <dc:date>TIMESTAMP</dc:date>
       <dc:rights>CC BY 4.0</dc:rights>
     </rdf:Description>
@@ -261,7 +261,7 @@ svg, :root {
   <circle r="42" fill="none" stroke="#000510" stroke-width="0.6"/>
   <circle r="42" fill="none" stroke="url(#hw-UID-rim)" stroke-width="1.0"/>
   <svg viewBox="0 0 24 24" width="48" height="48" x="-24" y="-24" overflow="visible">
-    <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" fill="#E0ECF6"/>
+    <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 VERSION.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-VERSION 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 VERSION 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 VERSION.108-.776.417-VERSION 0-VERSION 1.235-3.22-.135-.303-.54-VERSION 0 0 1.005-.322 3.3 VERSION 1.98-.399 3-.405 VERSION VERSION 3 .405 2.28-1.552 3.285-1.23 3.285-VERSION VERSION VERSION VERSION.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 VERSION.36.81 VERSION 2.22 0 1.606-.015 2.896-.015 3.286 0 .VERSION.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" fill="#E0ECF6"/>
   </svg>
 </g>
 

{hyperweave-0.2.25 → hyperweave-0.2.26}/tests/test_state_inference.py

@@ -99,3 +99,54 @@ def test_compose_empty_value_no_inference() -> None:
 def test_compose_unrecognizable_value_no_inference() -> None:
     """Value with no rule match leaves state at default."""
     assert _metadata_state("version", "v1.2.3") == "active"
+
+
+# ─────────────────────────────────────────────────────────────────────
+# Strip frames — per-cell rolled-up inference (v0.2.25)
+# ─────────────────────────────────────────────────────────────────────
+
+
+def _strip_metadata_state(value: str, state: str = "active") -> str:
+    """Compose a strip and return its post-inference metadata state.
+
+    Strip's title is a repo identifier (HYPERWEAVE), not a state-bearing
+    label — the engine inspects metric cells and rolls up the most severe
+    state across allowlisted ones.
+    """
+    spec = ComposeSpec(
+        type="strip",
+        genome_id="chrome",
+        title="HYPERWEAVE",
+        value=value,
+        state=state,
+    )
+    result = compose(spec)
+    assert result.metadata is not None
+    return str(result.metadata.state)
+
+
+def test_strip_infers_failing_from_build_cell() -> None:
+    """Pre-v0.2.25 README regression: strip with BUILD:failing cell
+    must roll up to failing state so the right-edge indicator goes red."""
+    assert _strip_metadata_state("BUILD:failing,VERSION:0.2.24,LICENSE:Apache-2.0") == "failing"
+
+
+def test_strip_infers_passing_from_build_cell() -> None:
+    assert _strip_metadata_state("BUILD:passing,VERSION:0.2.24") == "passing"
+
+
+def test_strip_picks_most_severe_state_across_cells() -> None:
+    """When multiple cells are stateful, the rolled-up state is the
+    most severe (failing > critical > warning > building > passing)."""
+    assert _strip_metadata_state("BUILD:failing,LINT:warning,STARS:42") == "failing"
+
+
+def test_strip_with_no_stateful_cells_stays_active() -> None:
+    """Pure data strips don't infer state — STARS, FORKS, VERSION are
+    not in the allowlist, so no cell contributes to the rollup."""
+    assert _strip_metadata_state("STARS:2.9k,FORKS:278,VERSION:0.2.24") == "active"
+
+
+def test_strip_explicit_state_survives_inference() -> None:
+    """User-set state overrides metric rollup."""
+    assert _strip_metadata_state("BUILD:failing,VERSION:0.2.24", state="passing") == "passing"

{hyperweave-0.2.25 → hyperweave-0.2.26}/tests/test_url_stability.py

@@ -49,6 +49,12 @@ _HW_UID_RE = re.compile(r"hw-[0-9a-f]{6,}")
 _FULL_UUID_RE = re.compile(r"\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b")
 # ISO 8601 timestamps that may appear in metadata (created/created_at).
 _TS_RE = re.compile(r"\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?")
+# Package version strings — `__version__` is dynamically computed from git
+# tags by hatch-vcs/setuptools-scm, so the same code produces "0.2.20"
+# locally (no tag) and "0.2.25" in CI (tagged release). Normalize all
+# semver-like version strings in metadata so backward-compat snapshots
+# track artifact STRUCTURE, not the version that happened to render them.
+_VERSION_RE = re.compile(r"\d+\.\d+\.\d+(?:[-+][0-9a-zA-Z.\-]+)?")
 
 
 def _normalize(svg: str) -> str:
@@ -56,6 +62,7 @@ def _normalize(svg: str) -> str:
     svg = _HW_UID_RE.sub("hw-UID", svg)
     svg = _FULL_UUID_RE.sub("UUID", svg)
     svg = _TS_RE.sub("TIMESTAMP", svg)
+    svg = _VERSION_RE.sub("VERSION", svg)
     return svg
 
 

hyperweave-0.2.25/src/hyperweave/compose/engine.py

@@ -1,106 +0,0 @@
-"""Composition engine -- the single entry point for all artifact generation."""
-
-from __future__ import annotations
-
-import time
-
-from hyperweave.core.models import ArtifactMetadata, ComposeResult, ComposeSpec, ResolvedArtifact
-
-
-def compose(spec: ComposeSpec) -> ComposeResult:
-    """Compose an artifact from a ComposeSpec."""
-    start = time.monotonic()
-
-    # ── 0. Infer state from value when the caller left the default ──
-    # Any explicit override (?state=failing, --state passing, MCP state arg,
-    # etc.) sets spec.state to something other than "active" and survives
-    # this step untouched. This is the single chokepoint covering HTTP,
-    # CLI, MCP, and kit.
-    #
-    # v0.2.25: gated on the stateful-title allowlist (data/badge_modes.yaml).
-    # Pre-v0.2.25 the inference fired on EVERY badge regardless of title —
-    # so a STARS=42 badge was auto-inferred to state="critical" (leading
-    # digit 4) and then re-classified as "explicit" mode by resolve_badge_mode,
-    # rendering an orange/red status indicator on a value with no semantic
-    # state. Now inference only fires for titles that meaningfully pass/fail
-    # (build / coverage / uptime / health / score / lint / ci / deploy / status).
-    if spec.state == "active" and spec.value and spec.title:
-        from hyperweave.compose.layout import normalize_title
-        from hyperweave.config.loader import load_badge_modes
-        from hyperweave.core.state import infer_state
-
-        # Normalize for separator-insensitive lookup (BUILD-STATUS,
-        # CI_CD, etc.) — same normalizer ``resolve_badge_mode`` uses.
-        if normalize_title(spec.title) in load_badge_modes():
-            inferred = infer_state(spec.title, spec.value)
-            if inferred != "active":
-                spec = spec.model_copy(update={"state": inferred})
-
-    # ── 1. Resolve genome, profile, frame ──
-    from hyperweave.compose.resolver import resolve
-
-    resolved = resolve(spec)
-
-    # ── 2. Assemble CSS ──
-    from hyperweave.compose.assembler import assemble_css
-
-    css_bundle = assemble_css(resolved, frame_type=spec.type)
-
-    # ── 3. Build template context ──
-    from hyperweave.compose.context import build_context
-
-    context = build_context(spec, resolved, css_bundle)
-
-    # ── 4. Enforce policy lanes ──
-    from hyperweave.compose.lanes import enforce
-
-    context = enforce(context, spec.regime)
-
-    # ── 5. Render template → SVG ──
-    from hyperweave.render.templates import render_artifact
-
-    svg = render_artifact(resolved.frame_template, context)
-
-    # ── 6. Build result ──
-    duration_ms = (time.monotonic() - start) * 1000
-
-    metadata = _build_metadata(spec, resolved, duration_ms)
-
-    result = ComposeResult(
-        svg=svg,
-        metadata=metadata,
-        width=resolved.width,
-        height=resolved.height,
-    )
-
-    # ── 7. Emit telemetry event (fire-and-forget) ──
-    try:
-        from hyperweave.telemetry.capture import emit_generation_event
-
-        emit_generation_event(spec, result)
-    except Exception:
-        pass  # telemetry must never break compose
-
-    return result
-
-
-def _build_metadata(
-    spec: ComposeSpec,
-    resolved: ResolvedArtifact,
-    duration_ms: float,
-) -> ArtifactMetadata:
-    return ArtifactMetadata(
-        type=spec.type,
-        genome=spec.genome_id,
-        profile=resolved.profile_id,
-        divider_variant=spec.divider_variant,
-        motion=resolved.motion,
-        state=spec.state,
-        regime=spec.regime,
-        width=resolved.width,
-        height=resolved.height,
-        metadata_tier=spec.metadata_tier,
-        duration_ms=round(duration_ms, 2),
-        generation=spec.generation,
-        series=spec.series,
-    )