hyperweave 0.4.3__tar.gz → 0.4.4__tar.gz

{hyperweave-0.4.3 → hyperweave-0.4.4}/.gitignore

@@ -40,5 +40,4 @@ examples/
 !assets/examples/
 !scripts/examples/
 outputs/
-scripts/extract_svgs.py
 v04/.learn/

{hyperweave-0.4.3 → hyperweave-0.4.4}/CHANGELOG.md

@@ -5,6 +5,38 @@ 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.4.4] - 2026-08-26
+
+Ships procedural loop diagrams with turn and meter choreography, uses custom names for each receipt file, and reads current Codex transcripts.
+
+### Added
+
+- **`topology: loop`** — draw processes that cycle: decisions, guard chips, terminal exits, and a return rail. One spec renders vertical or horizontal.
+- **Loop patterns come from structure** — no new flags. Two decisions give you a retry. `tap-in`/`tap-out` edges give a supervised loop. A `station: scope` node nests an inner loop. `accumulates` on the return makes a flywheel. `lanes:` plus per-node `category` gives swimlanes.
+- **`motion_register`** — animate the loop five ways. `turn` traces each route as it arrives. `laps`, `budget`, and `accumulate` animate a gauge (`meter: N`) that grows, drains, or banks. `drift` leaves it static. Set with `--motion-register`, `?motion_register=`, or MCP.
+- **`style: pill`** — capsule cards: glyph, name, and description, with connectors meeting the cap rim.
+- **Fifteen loop presets** — render one by name: `hyperweave compose diagram --spec-file loop-hillclimb-turn`.
+- **Five new glyphs** — `pencil` · `stair-up` · `undo-arc` · `rotate-cw` · `trending-up`.
+- Visual polish: decision questions and discard routes carry their own colors on light and dark faces; long station names wrap to two balanced lines.
+
+### Changed
+
+- **Receipts are named for their session** — the filename carries the session title and a short id; renaming a session moves its receipt instead of leaving a copy.
+- **Rates are dated** — a turn is priced at the rate in effect the day it ran.
+
+### Fixed
+
+- **Codex transcripts** — turn counts read the record shape current Codex writes; tool calls are classed; the injected preamble no longer counts as a prompt or names the receipt.
+- **Model rates** — GPT-5.6 and Claude Opus 5 price from their own cards; an unpriced model warns instead of guessing.
+- **`just proofset`** — the recipe exited before rendering.
+- **Mixed icon columns** — a card without an icon, in a column where its siblings have icons, now lines its text up with theirs instead of leaving a lopsided gap.
+
+### Notes
+
+- A `loop` holds 10 nodes (7 horizontal); scopes nest one level; a meter caps at 8 segments. `caps:` and `chassis:` lift the limits per spec.
+- Upgrading doesn't rename receipt files on disk; a receipt picks up its new name the next time its session ends.
+- Receipt pricing: Claude Sonnet 5's introductory rate ends 2026-08-31.
+
 ## [0.4.3] - 2026-08-24
 
 Improves `dag` diagrams, which now declare an `orientation` of `horizontal` or `vertical`, and fixes a broad set of bugs across the diagram system.

{hyperweave-0.4.3 → hyperweave-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hyperweave
-Version: 0.4.3
+Version: 0.4.4
 Summary: Artifact layer for agent-human representations. One API call, one SVG. Zero dependencies, renders in any markdown.
 Project-URL: Homepage, https://hyperweave.app
 Project-URL: Documentation, https://hyperweave.app/docs
@@ -48,8 +48,8 @@ Description-Content-Type: text/markdown
 <div id="top">
 
 <picture>
-  <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_light.svg" media="(prefers-color-scheme: light)">
-  <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_dark.svg" alt="HyperWeave" width="100%"
+  <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_stacked_light.svg" media="(prefers-color-scheme: light)">
+  <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_stacked_dark.svg" alt="HyperWeave" width="100%"
   >
 </picture>
 
@@ -154,7 +154,7 @@ hyperweave install-hook --genome raw     # the paper receipt
 
 ## Diagrams
 
-Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: `pipeline`, `fanout`, `fanin`, `hub`, `cycle`, `dag`, `lanes`, `state-machine`, `sequence`, `tree`, and `comparison`. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
+Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: `pipeline`, `fanout`, `fanin`, `hub`, `cycle`, `loop`, `dag`, `lanes`, `state-machine`, `sequence`, `tree`, and `comparison`. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
 
 <p align="center">
   <picture>
@@ -313,10 +313,29 @@ hyperweave compose diagram --spec-file cycle-flow -g primer --variant porcelain
 
 </details>
 
+<p align="center">
+  <picture>
+    <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-light.svg" media="(prefers-color-scheme: light)">
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-dark.svg" alt="One turn of the loop, performed: change, measure, keep or revert — guard chips inside the Stop? holder decide whether the loop returns or the champion ships" width="70%"
+    >
+  </picture>
+</p>
+
+<details>
+<summary>Compose this inline</summary>
+
+```bash
+hyperweave compose diagram --spec-file loop-hillclimb-turn -g primer --variant porcelain --surface inlay --face light -o loop-hillclimb-turn-light.svg
+```
+
+`loop-hillclimb-turn` is a bundled preset; the URL API renders it by name at `/v1/diagram/loop-hillclimb-turn/primer.static`.
+
+</details>
+
 <p align="center">
   <picture>
     <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-light.svg" media="(prefers-color-scheme: light)">
-    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-dark.svg" alt="Dependency audit tree: my-app roots direct dependencies react, lodash, and axios, transitive children hang on dashed edges, and health dots flag what is outdated or vulnerable" width="65%"
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-dark.svg" alt="Dependency audit tree: my-app roots direct dependencies react, lodash, and axios, transitive children hang on dashed edges, and health dots flag what is outdated or vulnerable" width="100%"
     >
   </picture>
 </p>
@@ -337,7 +356,7 @@ hyperweave compose diagram --spec-file tree-health -g primer --variant porcelain
 | | | |
 |:---|:---|:---|
 | **Flows** | `pipeline` · `fanout` · `fanin` | stages in a line, one-to-many, many-to-one |
-| **Cycles** | `cycle` · `state-machine` | a loop, legal state transitions |
+| **Cycles** | `cycle` · `loop` · `state-machine` | a closed ring, a procedural loop with exits, legal state transitions |
 | **Structure** | `dag` · `tree` · `lanes` | dependencies, hierarchy, ownership rows |
 | **Centered** | `hub` | one thing at the middle of its world |
 | **Time** | `sequence` | who calls whom, in order |
@@ -351,6 +370,7 @@ Eleven layouts, forty-four bundled presets, one spec vocabulary. Variations are
 | `fanout` | `horizontal` &middot; `bilateral` &middot; `upward` &middot; `downward` &middot; `radial` |
 | `tree` | `horizontal` &middot; `radial` |
 | `cycle` | `ring` &middot; `orbit` |
+| `loop` | `vertical` &middot; `horizontal` |
 | `fanin` &middot; `hub` &middot; `lanes` &middot; `sequence` &middot; `state-machine` &middot; `comparison` | `horizontal` |
 
 Render any preset by name at `/v1/diagram/{preset}/primer.static`, or run `hyperweave discover diagram` for every preset, orientation and field.
@@ -960,7 +980,7 @@ hyperweave extract services-vertical.svg --respond payload \
 <p align="center">
   <picture>
     <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-light.svg" media="(prefers-color-scheme: light)">
-    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-dark.svg" alt="The same service graph turned vertical and rendered in the noir variant: the fan flows top to bottom, Billing keeps its place in it, and the writes edge takes the outside gutter into Postgres" width="62%"
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-dark.svg" alt="The same service graph turned vertical and rendered in the noir variant: the fan flows top to bottom, Billing keeps its place in it, and the writes edge takes the outside gutter into Postgres" width="100%"
     >
   </picture>
 </p>

{hyperweave-0.4.3 → hyperweave-0.4.4}/README.md

@@ -1,8 +1,8 @@
 <div id="top">
 
 <picture>
-  <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_light.svg" media="(prefers-color-scheme: light)">
-  <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_dark.svg" alt="HyperWeave" width="100%"
+  <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_stacked_light.svg" media="(prefers-color-scheme: light)">
+  <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/hero/hyperweave_hero_stacked_dark.svg" alt="HyperWeave" width="100%"
   >
 </picture>
 
@@ -107,7 +107,7 @@ hyperweave install-hook --genome raw     # the paper receipt
 
 ## Diagrams
 
-Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: `pipeline`, `fanout`, `fanin`, `hub`, `cycle`, `dag`, `lanes`, `state-machine`, `sequence`, `tree`, and `comparison`. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
+Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: `pipeline`, `fanout`, `fanin`, `hub`, `cycle`, `loop`, `dag`, `lanes`, `state-machine`, `sequence`, `tree`, and `comparison`. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
 
 <p align="center">
   <picture>
@@ -266,10 +266,29 @@ hyperweave compose diagram --spec-file cycle-flow -g primer --variant porcelain
 
 </details>
 
+<p align="center">
+  <picture>
+    <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-light.svg" media="(prefers-color-scheme: light)">
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/loop-hillclimb-turn-dark.svg" alt="One turn of the loop, performed: change, measure, keep or revert — guard chips inside the Stop? holder decide whether the loop returns or the champion ships" width="70%"
+    >
+  </picture>
+</p>
+
+<details>
+<summary>Compose this inline</summary>
+
+```bash
+hyperweave compose diagram --spec-file loop-hillclimb-turn -g primer --variant porcelain --surface inlay --face light -o loop-hillclimb-turn-light.svg
+```
+
+`loop-hillclimb-turn` is a bundled preset; the URL API renders it by name at `/v1/diagram/loop-hillclimb-turn/primer.static`.
+
+</details>
+
 <p align="center">
   <picture>
     <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-light.svg" media="(prefers-color-scheme: light)">
-    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-dark.svg" alt="Dependency audit tree: my-app roots direct dependencies react, lodash, and axios, transitive children hang on dashed edges, and health dots flag what is outdated or vulnerable" width="65%"
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/tree-health-dark.svg" alt="Dependency audit tree: my-app roots direct dependencies react, lodash, and axios, transitive children hang on dashed edges, and health dots flag what is outdated or vulnerable" width="100%"
     >
   </picture>
 </p>
@@ -290,7 +309,7 @@ hyperweave compose diagram --spec-file tree-health -g primer --variant porcelain
 | | | |
 |:---|:---|:---|
 | **Flows** | `pipeline` · `fanout` · `fanin` | stages in a line, one-to-many, many-to-one |
-| **Cycles** | `cycle` · `state-machine` | a loop, legal state transitions |
+| **Cycles** | `cycle` · `loop` · `state-machine` | a closed ring, a procedural loop with exits, legal state transitions |
 | **Structure** | `dag` · `tree` · `lanes` | dependencies, hierarchy, ownership rows |
 | **Centered** | `hub` | one thing at the middle of its world |
 | **Time** | `sequence` | who calls whom, in order |
@@ -304,6 +323,7 @@ Eleven layouts, forty-four bundled presets, one spec vocabulary. Variations are
 | `fanout` | `horizontal` &middot; `bilateral` &middot; `upward` &middot; `downward` &middot; `radial` |
 | `tree` | `horizontal` &middot; `radial` |
 | `cycle` | `ring` &middot; `orbit` |
+| `loop` | `vertical` &middot; `horizontal` |
 | `fanin` &middot; `hub` &middot; `lanes` &middot; `sequence` &middot; `state-machine` &middot; `comparison` | `horizontal` |
 
 Render any preset by name at `/v1/diagram/{preset}/primer.static`, or run `hyperweave discover diagram` for every preset, orientation and field.
@@ -913,7 +933,7 @@ hyperweave extract services-vertical.svg --respond payload \
 <p align="center">
   <picture>
     <source srcset="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-light.svg" media="(prefers-color-scheme: light)">
-    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-dark.svg" alt="The same service graph turned vertical and rendered in the noir variant: the fan flows top to bottom, Billing keeps its place in it, and the writes edge takes the outside gutter into Postgres" width="62%"
+    <img src="https://raw.githubusercontent.com/InnerAura/hyperweave/main/assets/examples/diagrams/service-dependencies-vertical-dark.svg" alt="The same service graph turned vertical and rendered in the noir variant: the fan flows top to bottom, Billing keeps its place in it, and the writes edge takes the outside gutter into Postgres" width="100%"
     >
   </picture>
 </p>