hyperweave 0.3.5__tar.gz → 0.3.7__tar.gz

{hyperweave-0.3.5 → hyperweave-0.3.7}/CHANGELOG.md

@@ -5,6 +5,50 @@ 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.7] - 2026-05-18
+
+Font payloads now embed only the characters each artifact actually renders, and fonts an artifact never displays are no longer embedded at all. Across every text-bearing artifact type — badges, strips, stats cards, star charts, marquees, receipts, and rhythm strips — and across all three genomes, gzip size drops by an average of 59% per artifact.
+
+### Changed
+
+- **Brutalist badge embedding** — single JetBrains Mono `@font-face` block. Barlow Condensed embeds only in stats, strips, and charts.
+- **Automata badge embedding** — Orbitron + Chakra Petch only. JetBrains Mono no longer ships in badges since no badge text uses it.
+- **Automata chart embedding** — Orbitron + JetBrains Mono only. Chakra Petch dropped since no chart text uses it.
+- **Per-genome, per-frame embed list** — `data/font-embedding.yaml` declares which fonts ship for each genome-and-artifact combination. Adding a font is a single YAML edit, no Python changes.
+
+### Fixed
+
+- **Codex Stop hook crash on receipt render** — `fonttools` and `brotli` are now runtime dependencies, so `uv tool install` users no longer hit `ModuleNotFoundError: fontTools` when the hook fires.
+
+### Notes
+
+- Repeat renders of the same text reuse a cached subset, so the first request pays the subsetting cost and subsequent requests don't.
+- CJK locale font embedding deferred to a future release.
+- Icons and dividers continue to embed zero fonts.
+
+## [0.3.6] - 2026-05-18
+
+Receipt active-duration sources from per-turn compute when the runtime emits it; long-running sessions no longer inflate via stage-span summation. Codex hooks migrate to the wrapped-matcher GA layout shipped in the Codex CLI v0.129 release. The `data-hw-genome` root attribute reflects the resolved genome ID instead of raw spec input.
+
+### Added
+
+- **`just tag VERSION MESSAGE`** — annotated tag plus automatic `_version.py` refresh so the `doctor` banner and metadata version stay in sync after release.
+- **`just version-refresh`** — standalone recipe to rebuild `_version.py` from the current git tag.
+
+### Changed
+
+- **Receipt active-duration** — Claude Code sessions source from `system.turn_duration` events; Codex and mocked fixtures fall back to the prior `min(stage-span sum, wall-clock span)` formula.
+- **Session contract** — new `turn_duration_minutes` field surfaces the parser's per-turn compute sum; null when the runtime emits no per-turn signal.
+- **Codex hooks file** — `install-hook` writes the wrapped-matcher GA format (Codex CLI v0.129+). Existing flat installs are migrated on next install.
+- **Hooks feature flag** — `codex_hooks` renames to `hooks` to match Codex's GA terminology; the legacy name continues to work for one release.
+- **`hyperweave doctor`** — traverses both the new wrapped format and the legacy flat layout, surfacing a migration prompt when a flat config is detected.
+- **Genome root attribute** — `data-hw-genome` reflects the resolved genome ID instead of raw spec input, so variants and auto-resolved genomes never emit empty.
+
+### Notes
+
+- Codex sessions hit the active-duration fallback because the runtime emits no per-turn duration signal.
+- `_version.py` refreshes automatically when tagging through `just tag`.
+
 ## [0.3.5] - 2026-05-17
 
 Receipt hero reads `token volume · $cost` with a four-cell decomposition strip below (IN / OUT / CACHED / WRITTEN), making the asymmetric cache-token math legible at a glance. Codex receipts now price tokens against the OpenAI rate card; figures previously inflated ~2× drop to actual GPT rates.

{hyperweave-0.3.5 → hyperweave-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.3.5
+Version: 0.3.7
 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
@@ -19,8 +19,10 @@ Classifier: Topic :: Multimedia :: Graphics
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
+Requires-Dist: brotli>=1.2.0
 Requires-Dist: fastapi>=0.115
 Requires-Dist: fastmcp>=3.0
+Requires-Dist: fonttools>=4.62.1
 Requires-Dist: httpx[http2]>=0.28
 Requires-Dist: jinja2>=3.1
 Requires-Dist: pydantic-settings>=2.0
@@ -241,11 +243,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon" alt="github — celadon" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=circle&variant=carbon" alt="discord — carbon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=circle&variant=celadon" alt="spotify — celadon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=carbon" alt="github — carbon" width="56"/>
   <img src="https://hyperweave.app/v1/icon/docker/brutalist.static?shape=circle&variant=alloy" alt="docker — alloy" width="56"/>
   <img src="https://hyperweave.app/v1/icon/npm/brutalist.static?shape=square&variant=temper" alt="npm — temper" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=square&variant=pigment" alt="spotify — pigment" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=square&variant=pigment" alt="discord — pigment" width="56"/>
   <img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic — ember" width="56"/>
   <br/>
   <ul>
@@ -269,11 +271,23 @@ 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/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/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=violet&size=compact" alt="PYPI — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=teal&size=compact" alt="PYPI — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=bone&size=compact" alt="PYPI — bone variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=steel&size=compact" alt="PYPI — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=amber&size=compact" alt="PYPI — amber variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=jade&size=compact" alt="PYPI — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=magenta&size=compact" alt="PYPI — magenta variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=cobalt&size=compact" alt="PYPI — cobalt variant"/>
+  <br/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=toxic&size=compact" alt="PYPI — toxic variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=solar&size=compact" alt="PYPI — solar variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal&size=compact" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=crimson&size=compact" alt="PYPI — crimson variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=sulfur&size=compact" alt="PYPI — sulfur variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=indigo&size=compact" alt="PYPI — indigo variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=burgundy&size=compact" alt="PYPI — burgundy variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=copper&size=compact" alt="PYPI — copper variant"/>
 </p>
 
 <p align="center">
@@ -370,11 +384,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/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"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=horizon" alt="PYPI — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=lightning" alt="PYPI — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=graphite" alt="PYPI — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=moth" alt="PYPI — moth variant"/>
 </p>
 
 <p align="center">
@@ -442,10 +456,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon" alt="youtube" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=horizon" alt="notion" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/npm/chrome.static?shape=square&variant=horizon" alt="npm" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/instagram/chrome.static?shape=square&variant=horizon" alt="instagram" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/chrome.static?shape=circle&variant=horizon" alt="github — horizon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=graphite" alt="notion — graphite" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/rust/chrome.static?shape=square&variant=moth" alt="rust — moth" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/docker/chrome.static?shape=square&variant=lightning" alt="docker — lightning" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/chrome.static?shape=square&variant=abyssal" alt="spotify — abyssal" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>

{hyperweave-0.3.5 → hyperweave-0.3.7}/README.md

@@ -209,11 +209,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon" alt="github — celadon" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=circle&variant=carbon" alt="discord — carbon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=circle&variant=celadon" alt="spotify — celadon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=carbon" alt="github — carbon" width="56"/>
   <img src="https://hyperweave.app/v1/icon/docker/brutalist.static?shape=circle&variant=alloy" alt="docker — alloy" width="56"/>
   <img src="https://hyperweave.app/v1/icon/npm/brutalist.static?shape=square&variant=temper" alt="npm — temper" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=square&variant=pigment" alt="spotify — pigment" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=square&variant=pigment" alt="discord — pigment" width="56"/>
   <img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic — ember" width="56"/>
   <br/>
   <ul>
@@ -237,11 +237,23 @@ 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/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/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=violet&size=compact" alt="PYPI — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=teal&size=compact" alt="PYPI — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=bone&size=compact" alt="PYPI — bone variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=steel&size=compact" alt="PYPI — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=amber&size=compact" alt="PYPI — amber variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=jade&size=compact" alt="PYPI — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=magenta&size=compact" alt="PYPI — magenta variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=cobalt&size=compact" alt="PYPI — cobalt variant"/>
+  <br/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=toxic&size=compact" alt="PYPI — toxic variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=solar&size=compact" alt="PYPI — solar variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal&size=compact" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=crimson&size=compact" alt="PYPI — crimson variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=sulfur&size=compact" alt="PYPI — sulfur variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=indigo&size=compact" alt="PYPI — indigo variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=burgundy&size=compact" alt="PYPI — burgundy variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=copper&size=compact" alt="PYPI — copper variant"/>
 </p>
 
 <p align="center">
@@ -338,11 +350,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/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"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=horizon" alt="PYPI — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=lightning" alt="PYPI — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=graphite" alt="PYPI — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=moth" alt="PYPI — moth variant"/>
 </p>
 
 <p align="center">
@@ -410,10 +422,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon" alt="youtube" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=horizon" alt="notion" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/npm/chrome.static?shape=square&variant=horizon" alt="npm" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/instagram/chrome.static?shape=square&variant=horizon" alt="instagram" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/chrome.static?shape=circle&variant=horizon" alt="github — horizon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=graphite" alt="notion — graphite" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/rust/chrome.static?shape=square&variant=moth" alt="rust — moth" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/docker/chrome.static?shape=square&variant=lightning" alt="docker — lightning" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/chrome.static?shape=square&variant=abyssal" alt="spotify — abyssal" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>

{hyperweave-0.3.5 → hyperweave-0.3.7}/justfile

@@ -48,3 +48,13 @@ docs:
 
 build:
     uv build
+
+version-refresh:
+    uv pip install -e . --force-reinstall --no-deps --quiet
+    @uv run python -c "import hyperweave; print(f'_version.py refreshed to {hyperweave.__version__}')"
+
+tag VERSION MESSAGE:
+    git tag -a {{VERSION}} -m "{{MESSAGE}}"
+    just version-refresh
+    @echo ""
+    @echo "Tagged {{VERSION}}. Push with: git push --follow-tags"

{hyperweave-0.3.5 → hyperweave-0.3.7}/pyproject.toml

@@ -42,6 +42,13 @@ dependencies = [
     "httpx[http2]>=0.28",
     "fastmcp>=3.0",
     "pyyaml>=6.0",
+    # Font subsetting (v0.3.7). Runtime — not dev-only — because
+    # render/fonts.py imports fontTools at module top-level, which
+    # executes on every receipt render. brotli is the WOFF2 codec
+    # fontTools uses inside font.save(flavor="woff2") and must be
+    # importable on every install (uv tool install, pip install, etc.).
+    "fonttools>=4.62.1",
+    "brotli>=1.2.0",
 ]
 
 [project.urls]
@@ -81,8 +88,6 @@ dev = [
     "mypy>=1.14",
     "types-pyyaml>=6.0.12.20250915",
     "pre-commit>=4.0",
-    "fonttools>=4.62.1",
-    "brotli>=1.2.0",
 ]
 
 [tool.pytest.ini_options]

{hyperweave-0.3.5 → hyperweave-0.3.7}/scripts/generate_proofset.py

@@ -1691,6 +1691,18 @@ def main() -> None:
     parser.add_argument("--live", action="store_true", help="Include network-dependent artifacts")
     args = parser.parse_args()
 
+    # Wipe outputs/proofset/ before regenerating so renamed/retired artifacts
+    # (paired-variant pairings, telemetry size variants) don't carry stale
+    # payloads forward and create false audit noise. READMEs live one level up
+    # (outputs/README*.md) and are preserved.
+    import shutil
+
+    proofset_dir = OUT / "proofset"
+    if proofset_dir.exists():
+        stale = sum(1 for _ in proofset_dir.rglob("*.svg"))
+        shutil.rmtree(proofset_dir)
+        print(f"Cleaned {stale} stale artifacts from {proofset_dir}")
+
     print("Generating static proof set...")
     total = generate_static()
     print(f"  {total} static artifacts")

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

{hyperweave-0.3.5 → hyperweave-0.3.7}/src/hyperweave/cli.py

@@ -567,8 +567,45 @@ def _install_claude_code_hook(hook_command: str, full_slug: str) -> None:
     typer.echo(f"Installed SessionEnd hook in {settings_path}{pinned}")
 
 
+# Codex hook event names (v0.129.0 GA). Used by ``_install_codex_hook`` and
+# ``_doctor_runtime_status`` to detect pre-GA flat-format event keys sitting
+# at the top of ``hooks.json`` and lift them under the canonical ``hooks``
+# wrapper introduced when hooks went GA.
+_CODEX_HOOK_EVENTS = frozenset(
+    {
+        "SessionStart",
+        "PreToolUse",
+        "PermissionRequest",
+        "PostToolUse",
+        "UserPromptSubmit",
+        "Stop",
+    }
+)
+
+
+def _wrap_legacy_codex_hook_entry(entry: object) -> object:
+    """Lift a pre-GA bare-command hook entry into the GA matcher+hooks group.
+
+    Codex v0.129 (hooks GA) changed each event-array entry from a bare
+    ``{type, command, timeout}`` to a matcher group
+    ``{matcher, hooks: [{type, command, timeout}]}``. Idempotent: an entry
+    already carrying a list-valued ``hooks`` key is returned unchanged so
+    repeated migrations stay stable. Bare-command entries are wrapped under
+    a universal ``"*"`` matcher; the matcher is parsed-but-ignored for Stop
+    today per the spec, but we use ``"*"`` for forward-compat against any
+    future Codex release that begins to honor it on Stop.
+    """
+    if not isinstance(entry, dict):
+        return entry
+    if isinstance(entry.get("hooks"), list):
+        return entry  # already in GA shape
+    if entry.get("type") == "command":
+        return {"matcher": "*", "hooks": [entry]}
+    return entry  # unknown shape — preserve as-is
+
+
 def _install_codex_hook(hook_command: str, full_slug: str) -> None:
-    """Write a Stop hook to ``~/.codex/hooks.json`` + enable codex_hooks feature.
+    """Write a Stop hook to ``~/.codex/hooks.json`` + enable hooks feature.
 
     Per developers.openai.com/codex/hooks, Codex CLI fires Stop hooks
     PER-TURN (after every assistant response). The receipt rewrites the
@@ -579,9 +616,21 @@ def _install_codex_hook(hook_command: str, full_slug: str) -> None:
     will lean into live-receipt consumers (file watchers, dashboards)
     rather than collapse it back to a single session-end event.
 
-    Also writes ``[features] codex_hooks = true`` to ``~/.codex/config.toml``
-    (preserving any other keys); the feature flag is required for the
-    hook system to fire.
+    Codex v0.129.0 (2026-05-07) took hooks GA with two shape changes the
+    installer handles via migration-on-write:
+
+    * ``hooks.json`` moved from flat ``{Stop: [{type, command, timeout}]}``
+      to wrapped ``{hooks: {Stop: [{matcher, hooks: [{type, command,
+      timeout}]}]}}``. Any pre-GA event keys at the top level are lifted
+      under the new wrapper; each bare-command entry is wrapped under a
+      universal ``"*"`` matcher group.
+    * ``[features].codex_hooks`` was aliased as ``[features].hooks``. The
+      installer strips any legacy ``codex_hooks`` entry and writes the
+      canonical ``hooks = true``.
+
+    Both migrations are idempotent — re-running install-hook over any
+    combination of pre-GA, partially-migrated, or GA configs converges to
+    the canonical GA shape with exactly one hyperweave entry.
     """
     import json
 
@@ -590,48 +639,99 @@ def _install_codex_hook(hook_command: str, full_slug: str) -> None:
     config_path = codex_dir / "config.toml"
     codex_dir.mkdir(parents=True, exist_ok=True)
 
-    # ── Update hooks.json: remove prior hyperweave Stop entries, append new one ──
+    # ── Update hooks.json: lift any pre-GA flat keys into the wrapper, then
+    # operate on hooks.Stop as the canonical GA structure ──
     config: dict[str, object] = {}
     if hooks_path.exists():
-        config = json.loads(hooks_path.read_text())
-
-    raw_stop = config.setdefault("Stop", [])
-    stop_hooks: list[object] = raw_stop if isinstance(raw_stop, list) else []
-    if not isinstance(raw_stop, list):
-        config["Stop"] = stop_hooks
+        loaded = json.loads(hooks_path.read_text())
+        if isinstance(loaded, dict):
+            config = loaded
+
+    # GA wrapper: hooks lives under config["hooks"]. Pre-GA configs may not
+    # have it yet; create it (or reset if it's the wrong shape).
+    wrapper_raw = config.setdefault("hooks", {})
+    hooks_wrapper: dict[str, object]
+    if isinstance(wrapper_raw, dict):
+        hooks_wrapper = wrapper_raw
+    else:
+        hooks_wrapper = {}
+        config["hooks"] = hooks_wrapper
+
+    # Lift any pre-GA top-level event keys (Stop, PreToolUse, etc.) into the
+    # wrapper, wrapping bare-command entries with a universal matcher group.
+    # Iterate over a snapshot of keys since we mutate during traversal.
+    for legacy_event in list(config.keys()):
+        if legacy_event == "hooks" or legacy_event not in _CODEX_HOOK_EVENTS:
+            continue
+        legacy_value = config.pop(legacy_event)
+        if not isinstance(legacy_value, list):
+            continue
+        target_raw = hooks_wrapper.setdefault(legacy_event, [])
+        target: list[object]
+        if isinstance(target_raw, list):
+            target = target_raw
+        else:
+            target = []
+            hooks_wrapper[legacy_event] = target
+        for entry in legacy_value:
+            target.append(_wrap_legacy_codex_hook_entry(entry))
+
+    # Now drop any prior hyperweave matcher groups under hooks.Stop and
+    # append the fresh one. A hyperweave group is identified by ANY inner
+    # handler whose command mentions "hyperweave session".
+    raw_stop = hooks_wrapper.setdefault("Stop", [])
+    stop_groups: list[object]
+    if isinstance(raw_stop, list):
+        stop_groups = raw_stop
+    else:
+        stop_groups = []
+        hooks_wrapper["Stop"] = stop_groups
 
-    cleaned = []
-    for entry in stop_hooks:
-        if not isinstance(entry, dict):
-            cleaned.append(entry)
+    cleaned: list[object] = []
+    for group in stop_groups:
+        if not isinstance(group, dict):
+            cleaned.append(group)
             continue
-        cmd = str(entry.get("command", ""))
-        if "hyperweave session" in cmd:
-            continue  # drop prior hyperweave hook
-        cleaned.append(entry)
-    cleaned.append({"type": "command", "command": hook_command, "timeout": 10})
-    config["Stop"] = cleaned
+        inner_hooks = group.get("hooks", [])
+        if isinstance(inner_hooks, list) and any(
+            isinstance(h, dict) and "hyperweave session" in str(h.get("command", "")) for h in inner_hooks
+        ):
+            continue  # drop the whole matcher group — owned by hyperweave
+        cleaned.append(group)
+    cleaned.append(
+        {
+            "matcher": "*",
+            "hooks": [{"type": "command", "command": hook_command, "timeout": 10}],
+        }
+    )
+    hooks_wrapper["Stop"] = cleaned
     hooks_path.write_text(json.dumps(config, indent=2) + "\n")
 
-    # ── Update config.toml: ensure [features] codex_hooks = true (preserve other keys) ──
+    # ── Update config.toml: ensure [features] hooks = true (preserve other keys) ──
+    # Codex v0.130.0 renamed the gate from `codex_hooks` to `hooks`; strip any
+    # legacy key on the way in so re-running install-hook over an older config
+    # upgrades cleanly instead of leaving a dead key. Key detection is exact-
+    # match (split-on-=, strip), not prefix, so `hooks_*` lookalikes can't
+    # spoof a hit.
     config_lines: list[str] = []
     if config_path.exists():
         config_lines = config_path.read_text().splitlines()
+    config_lines = [line for line in config_lines if line.split("=", 1)[0].strip() != "codex_hooks"]
     has_features_section = any(line.strip() == "[features]" for line in config_lines)
-    has_codex_hooks_key = any(line.strip().startswith("codex_hooks") for line in config_lines)
+    has_hooks_key = any("=" in line and line.split("=", 1)[0].strip() == "hooks" for line in config_lines)
     if not has_features_section:
-        config_lines.extend(["", "[features]", "codex_hooks = true"])
-    elif not has_codex_hooks_key:
-        # Insert codex_hooks = true right after [features] header
+        config_lines.extend(["", "[features]", "hooks = true"])
+    elif not has_hooks_key:
+        # Insert hooks = true right after [features] header
         for i, line in enumerate(config_lines):
             if line.strip() == "[features]":
-                config_lines.insert(i + 1, "codex_hooks = true")
+                config_lines.insert(i + 1, "hooks = true")
                 break
     config_path.write_text("\n".join(config_lines) + "\n")
 
     pinned = f" (pinned to {full_slug})" if full_slug else " (auto-detect skin)"
     typer.echo(f"Installed Stop hook in {hooks_path}{pinned}")
-    typer.echo(f"Set [features] codex_hooks = true in {config_path}")
+    typer.echo(f"Set [features] hooks = true in {config_path}")
     typer.echo(
         "Note: Codex Stop fires per-turn — the receipt file refreshes live as the "
         "session progresses, always reflecting current cumulative state.",
@@ -702,7 +802,7 @@ def install_hook(
                 "auto-detects installed runtimes (~/.claude, ~/.codex, or 'claude'/"
                 "'codex' on PATH) and registers for each present. 'claude-code' "
                 "writes a SessionEnd hook to ~/.claude/settings.json. 'codex' writes "
-                "a Stop hook to ~/.codex/hooks.json plus [features] codex_hooks in "
+                "a Stop hook to ~/.codex/hooks.json plus [features] hooks in "
                 "~/.codex/config.toml. 'all' forces both regardless of detection."
             ),
         ),
@@ -771,8 +871,8 @@ def _doctor_runtime_status(runtime: str, home_dir: Path) -> str:
     Returns ``✓`` when the hyperweave hook is wired correctly, ``✗`` when
     the runtime is initialized but no hyperweave hook is registered, or
     ``⚠`` when the wiring is partial (malformed config; codex missing the
-    [features] codex_hooks flag). The string is rendered verbatim by
-    ``doctor``.
+    [features] hooks flag — renamed from ``codex_hooks`` in Codex v0.130.0).
+    The string is rendered verbatim by ``doctor``.
     """
     import json
 
@@ -802,24 +902,56 @@ def _doctor_runtime_status(runtime: str, home_dir: Path) -> str:
         hooks_path = home_dir / "hooks.json"
         config_path = home_dir / "config.toml"
         registered_cmd: str | None = None
+        legacy_flat_cmd: str | None = None
         if hooks_path.exists():
             try:
                 hooks = json.loads(hooks_path.read_text())
             except json.JSONDecodeError:
                 return f"⚠ {runtime}: ~/.codex/hooks.json is malformed"
-            for entry in hooks.get("Stop", []) or []:
-                if not isinstance(entry, dict):
-                    continue
-                cmd = str(entry.get("command", ""))
-                if "hyperweave session" in cmd:
-                    registered_cmd = cmd
-                    break
+            # GA traversal (Codex v0.129+):
+            #   hooks["hooks"]["Stop"][group].hooks[handler].command
+            wrapper = hooks.get("hooks") if isinstance(hooks, dict) else None
+            if isinstance(wrapper, dict):
+                for group in wrapper.get("Stop") or []:
+                    if not isinstance(group, dict):
+                        continue
+                    for handler in group.get("hooks") or []:
+                        if not isinstance(handler, dict):
+                            continue
+                        cmd = str(handler.get("command", ""))
+                        if "hyperweave session" in cmd:
+                            registered_cmd = cmd
+                            break
+                    if registered_cmd:
+                        break
+            # Pre-GA flat fallback (kept for one release): hooks["Stop"][entry]
+            # with command directly on the entry. Detected separately so a
+            # legacy install surfaces as ⚠ with an upgrade pointer instead of
+            # silently misreporting the hook as missing.
+            if not registered_cmd and isinstance(hooks, dict):
+                for entry in hooks.get("Stop") or []:
+                    if not isinstance(entry, dict):
+                        continue
+                    cmd = str(entry.get("command", ""))
+                    if "hyperweave session" in cmd:
+                        legacy_flat_cmd = cmd
+                        break
+        if legacy_flat_cmd and not registered_cmd:
+            return (
+                f"⚠ {runtime}: hook registered in legacy pre-GA flat format — "
+                f"re-run 'hyperweave install-hook --runtime {runtime}' to lift "
+                f"it to the GA wrapped structure (Codex v0.129+)"
+            )
         if not registered_cmd:
             return (
                 f"✗ {runtime}: initialized but no hyperweave hook — run 'hyperweave install-hook --runtime {runtime}'"
             )
-        # [features] codex_hooks = true must be present for the hook to fire;
-        # the install command writes it, but a hand-edited config could miss it.
+        # [features] hooks = true must be present for the hook to fire; the
+        # install command writes it, but a hand-edited config could miss it.
+        # Codex v0.130.0 renamed the gate from `codex_hooks` to `hooks`; key
+        # detection is exact-match within the [features] section so a stale
+        # `codex_hooks = true` left over from older installs is not mistaken
+        # for the live gate (and so `hooks_*` lookalikes can't spoof a hit).
         feature_ok = False
         if config_path.exists():
             in_features = False
@@ -831,12 +963,14 @@ def _doctor_runtime_status(runtime: str, home_dir: Path) -> str:
                 if in_features and stripped.startswith("["):
                     in_features = False
                     continue
-                if in_features and stripped.startswith("codex_hooks") and "true" in stripped:
-                    feature_ok = True
-                    break
+                if in_features and "=" in stripped:
+                    key, _, value = stripped.partition("=")
+                    if key.strip() == "hooks" and "true" in value:
+                        feature_ok = True
+                        break
         if not feature_ok:
             return (
-                f"⚠ {runtime}: hook registered but [features] codex_hooks = true "
+                f"⚠ {runtime}: hook registered but [features] hooks = true "
                 f"is missing — re-run 'hyperweave install-hook --runtime {runtime}'"
             )
         return f"✓ {runtime}: hook registered — {registered_cmd}"