hyperweave 0.2.4__tar.gz → 0.2.5__tar.gz

hyperweave-0.2.5/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+# Runs `ruff check` + `ruff format` automatically on every `git commit`.
+# Mirrors the two lint steps CI enforces in .github/workflows/ci.yml so CI
+# never surfaces formatting or lint failures that local commits should catch.
+#
+# One-time setup after cloning:
+#   uv sync --group dev
+#   uv run pre-commit install
+#
+# Manual run across the whole repo:
+#   uv run pre-commit run --all-files
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: \.svg$
+      - id: end-of-file-fixer
+        exclude: \.(svg|b64)$
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: [--maxkb=500]

{hyperweave-0.2.4 → hyperweave-0.2.5}/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.5] - 2026-04-13
+
+### Fixed
+
+- **Chart bezier regression on certain data ranges.** The chrome chart bezier path used horizontal tangents at every anchor, which produced a smooth curve only when input points were widely and evenly spaced. On tighter or uneven distributions — common with real GitHub stargazer data — the curve degenerated into flat-then-vertical segments. Replaced with Fritsch-Carlson monotonic cubic interpolation (the same algorithm D3's `curveMonotoneX` uses), which guarantees the curve passes through every anchor, never overshoots between points, and handles any point spacing robustly.
+
 ## [0.2.4] - 2026-04-13
 
 ### Added

{hyperweave-0.2.4 → hyperweave-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.2.4
+Version: 0.2.5
 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
@@ -397,4 +397,4 @@ HyperWeave is early. If you're interested in building genomes, extending frame t
 [x]: https://x.com/InnerAuraLabs
 [youtube]: https://www.youtube.com/@InnerAuraLabs
 
-[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg
+[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg

{hyperweave-0.2.4 → hyperweave-0.2.5}/README.md

@@ -365,4 +365,4 @@ HyperWeave is early. If you're interested in building genomes, extending frame t
 [x]: https://x.com/InnerAuraLabs
 [youtube]: https://www.youtube.com/@InnerAuraLabs
 
-[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg
+[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg

{hyperweave-0.2.4 → hyperweave-0.2.5}/pyproject.toml

@@ -77,6 +77,7 @@ dev = [
     "ruff>=0.9",
     "mypy>=1.14",
     "types-pyyaml>=6.0.12.20250915",
+    "pre-commit>=4.0",
 ]
 
 [tool.pytest.ini_options]

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

{hyperweave-0.2.4 → hyperweave-0.2.5}/src/hyperweave/compose/resolvers/chart.py

@@ -40,11 +40,7 @@ def resolve_chart(
     # date labels at bottom, and hero value at right.
     # Dimensions match the target SVGs in tier2/genomes/.
     paradigm = genome.get("paradigms", {}).get("chart", "brutalist")
-    vp = (
-        Viewport(x=80, y=160, w=750, h=250)
-        if paradigm == "chrome"
-        else Viewport(x=80, y=150, w=760, h=245)
-    )
+    vp = Viewport(x=80, y=160, w=750, h=250) if paradigm == "chrome" else Viewport(x=80, y=150, w=760, h=245)
 
     # Three-state machine. "fresh" preserved (not renamed to "live") for
     # backward compat with the existing data-hw-status contract; "empty" is
@@ -59,12 +55,8 @@ def resolve_chart(
         current_stars = 0
         empty_message = "DATA UNAVAILABLE"
     else:
-        current_stars = int(
-            connector.get("current_stars") or connector.get("stars_total") or 0
-        )
-        raw_points = list(
-            connector.get("points") or connector.get("star_history") or []
-        )
+        current_stars = int(connector.get("current_stars") or connector.get("stars_total") or 0)
+        raw_points = list(connector.get("points") or connector.get("star_history") or [])
         if current_stars == 0:
             # Truthful zero-star state (brand-new repo) — render empty, don't fabricate.
             status = "empty"

{hyperweave-0.2.4 → hyperweave-0.2.5}/src/hyperweave/connectors/github.py

@@ -191,10 +191,7 @@ async def fetch_stargazer_history(
     # a duplicate-date "now" point, producing a zero time-range polyline. Use
     # each stargazer's own timestamp instead — the whole page fits in one call.
     if total_pages == 1:
-        single_page_url = (
-            f"https://api.github.com/repos/{identifier}/stargazers"
-            f"?per_page={_STARGAZER_PAGE_SIZE}&page=1"
-        )
+        single_page_url = f"https://api.github.com/repos/{identifier}/stargazers?per_page={_STARGAZER_PAGE_SIZE}&page=1"
         page_payload = await fetch_json(
             single_page_url,
             provider=PROVIDER,
@@ -204,9 +201,7 @@ async def fetch_stargazer_history(
         if isinstance(page_payload, list):
             for idx, entry in enumerate(page_payload):
                 if isinstance(entry, dict) and entry.get("starred_at"):
-                    single_page_points.append(
-                        {"date": entry["starred_at"], "count": idx + 1}
-                    )
+                    single_page_points.append({"date": entry["starred_at"], "count": idx + 1})
         single_page_result: dict[str, Any] = {
             "points": single_page_points,
             "current_stars": total_stars,

{hyperweave-0.2.4 → hyperweave-0.2.5}/src/hyperweave/render/chart_engine.py

@@ -136,11 +136,7 @@ def _project_points(
     for i, p in enumerate(points):
         # When all timestamps are identical (t_span <= 0), distribute points
         # evenly by index rather than collapsing them all to vp.x.
-        frac_t = (
-            i / max(1, n - 1)
-            if t_span <= 0
-            else (p.date.timestamp() - t0) / t_span
-        )
+        frac_t = i / max(1, n - 1) if t_span <= 0 else (p.date.timestamp() - t0) / t_span
         frac_v = (p.value - v_lo) / v_span
         px = vp.x + round(frac_t * vp.w)
         py = vp.y + vp.h - round(frac_v * vp.h)
@@ -157,30 +153,100 @@ def _build_polyline_points(projected: list[tuple[int, int]]) -> str:
 
 
 def _build_bezier_path(projected: list[tuple[int, int]]) -> str:
-    """Build a smooth cubic bezier path string through the projected points.
-
-    Uses the "Catmull-Rom-ish" trick: each segment's control points are at
-    one third of the previous/next delta. This produces a visually smooth
-    curve without cornering at every data point — matches the chrome-horizon
-    mockup's bezier style.
+    """Build a smooth cubic bezier path using Fritsch-Carlson monotonic cubic interpolation.
+
+    This is the same curve D3 renders via ``curveMonotoneX``. For data with
+    monotonically increasing x-coordinates (e.g. any time-series chart like
+    star history), the curve is guaranteed to:
+
+    - Pass through every anchor point (C0 continuity).
+    - Be C1-continuous (smooth tangent at every anchor).
+    - Be monotonic wherever the input is monotonic (no dips between rising
+      points).
+    - Not overshoot — control handles stay within their segment in x,
+      regardless of uneven x-spacing.
+
+    The previous implementation placed horizontal control handles at every
+    anchor (``c1y = y_prev``, ``c2y = y_cur``). That shape produced two
+    visual artifacts on real data:
+
+    1. **Flat-then-vertical** for bursty growth — horizontal tangents forced
+       each segment into a plateau → S-curve → plateau shape, so the chart
+       read as flat sections punctuated by sharp rises.
+
+    2. **Self-intersecting segments** when two adjacent anchors were close
+       in x — the hard-coded ``dx = max(4, (x_cur - x_prev) // 3)`` produced
+       ``c2.x < c1.x``, rasterizing badly on mobile/Camo.
+
+    Fritsch-Carlson solves both by computing per-segment slopes, deriving a
+    tangent at each point from the neighboring slopes, and then rescaling
+    tangent magnitudes with the ``α² + β² > 9`` test so control handles
+    never extend past their segment.
+
+    References:
+        Fritsch, F. N.; Carlson, R. E. (1980). "Monotone Piecewise Cubic
+        Interpolation". SIAM Journal on Numerical Analysis. 17 (2): 238-246.
     """
-    if not projected:
+    n = len(projected)
+    if n == 0:
         return ""
-    if len(projected) == 1:
+    if n == 1:
         x, y = projected[0]
         return f"M{x},{y}"
-
+    if n == 2:
+        # Two points → straight-line bezier (no interior tangents to compute).
+        x0, y0 = projected[0]
+        x1, y1 = projected[1]
+        dx = (x1 - x0) / 3
+        c1x, c1y = round(x0 + dx), y0
+        c2x, c2y = round(x1 - dx), y1
+        return f"M{x0},{y0} C{c1x},{c1y} {c2x},{c2y} {x1},{y1}"
+
+    # 1. Per-segment slopes m_i = (y_{i+1} - y_i) / (x_{i+1} - x_i).
+    slopes: list[float] = []
+    for i in range(n - 1):
+        sx = projected[i + 1][0] - projected[i][0]
+        sy = projected[i + 1][1] - projected[i][1]
+        slopes.append(sy / sx if sx != 0 else 0.0)
+
+    # 2. Initial tangents at each anchor. Endpoints use the one adjacent slope;
+    # interior points use the average of the two adjacent slopes, but set to 0
+    # at turning points (where the two slopes have opposite sign).
+    tangents: list[float] = [0.0] * n
+    tangents[0] = slopes[0]
+    tangents[-1] = slopes[-1]
+    for i in range(1, n - 1):
+        if slopes[i - 1] * slopes[i] > 0:
+            tangents[i] = (slopes[i - 1] + slopes[i]) / 2
+        # else: turning point → tangent stays 0
+
+    # 3. Fritsch-Carlson overshoot prevention. For each segment, if the
+    # (alpha, beta) pair falls outside the monotonicity circle of radius 3,
+    # rescale both tangents by tau = 3 / sqrt(alpha^2 + beta^2).
+    for i in range(n - 1):
+        if slopes[i] == 0:
+            tangents[i] = 0.0
+            tangents[i + 1] = 0.0
+            continue
+        alpha = tangents[i] / slopes[i]
+        beta = tangents[i + 1] / slopes[i]
+        if alpha * alpha + beta * beta > 9:
+            tau = 3.0 / (alpha * alpha + beta * beta) ** 0.5
+            tangents[i] = tau * alpha * slopes[i]
+            tangents[i + 1] = tau * beta * slopes[i]
+
+    # 4. Convert tangents to Bezier control points. For each segment, the
+    # control x-offset is 1/3 of segment width; the y-offset is that same
+    # 1/3 width scaled by the anchor's tangent (slope).
     parts: list[str] = [f"M{projected[0][0]},{projected[0][1]}"]
-    n = len(projected)
-    for i in range(1, n):
-        x_prev, y_prev = projected[i - 1]
-        x_cur, y_cur = projected[i]
-        # Horizontal offset for control handles — one third of segment width.
-        dx = max(4, (x_cur - x_prev) // 3)
-        c1x = x_prev + dx
-        c1y = y_prev
-        c2x = x_cur - dx
-        c2y = y_cur
+    for i in range(n - 1):
+        x_prev, y_prev = projected[i]
+        x_cur, y_cur = projected[i + 1]
+        seg_dx = (x_cur - x_prev) / 3
+        c1x = round(x_prev + seg_dx)
+        c1y = round(y_prev + tangents[i] * seg_dx)
+        c2x = round(x_cur - seg_dx)
+        c2y = round(y_cur - tangents[i + 1] * seg_dx)
         parts.append(f"C{c1x},{c1y} {c2x},{c2y} {x_cur},{y_cur}")
     return " ".join(parts)
 
@@ -413,9 +479,7 @@ def _format_y_tick(value: int) -> str:
     return f"{s}K"
 
 
-def _build_y_labels(
-    ticks: list[int], v_min: int, v_max: int, vp: Viewport
-) -> list[dict[str, Any]]:
+def _build_y_labels(ticks: list[int], v_min: int, v_max: int, vp: Viewport) -> list[dict[str, Any]]:
     """Project tick values into ``{y, text}`` dicts for template consumption.
 
     Uses the same (v_min, v_max) range the caller passes to
@@ -433,9 +497,7 @@ def _build_y_labels(
     return out
 
 
-def _build_x_year_labels(
-    points: list[ChartPoint], vp: Viewport
-) -> list[dict[str, Any]]:
+def _build_x_year_labels(points: list[ChartPoint], vp: Viewport) -> list[dict[str, Any]]:
     """Return year-string labels positioned at jan-1 boundaries in the data range.
 
     Matches star-history.com's convention: just year numbers (2024, 2025, 2026)
@@ -454,9 +516,7 @@ def _build_x_year_labels(
     t1 = points[-1].date.timestamp()
     t_span = max(1.0, t1 - t0)
 
-    labels: list[dict[str, Any]] = [
-        {"x": vp.x, "text": str(y_start), "anchor": "start"}
-    ]
+    labels: list[dict[str, Any]] = [{"x": vp.x, "text": str(y_start), "anchor": "start"}]
     for y in range(y_start + 1, y_end + 1):
         jan1 = datetime(y, 1, 1, tzinfo=UTC).timestamp()
         if t0 < jan1 <= t1:
@@ -489,9 +549,7 @@ def _build_empty_state(vp: Viewport, message: str) -> str:
     )
 
 
-def _build_gridlines_from_ticks(
-    y_labels: list[dict[str, Any]], vp: Viewport
-) -> str:
+def _build_gridlines_from_ticks(y_labels: list[dict[str, Any]], vp: Viewport) -> str:
     """Horizontal gridlines at each Y-tick's Y-position.
 
     Replaces the uniform ``_build_gridlines`` when real data is present — so
@@ -501,10 +559,7 @@ def _build_gridlines_from_ticks(
     lines: list[str] = []
     for label in y_labels:
         y = int(label["y"])
-        lines.append(
-            f'<line x1="{vp.x}" y1="{y}" x2="{vp.x + vp.w}" y2="{y}" '
-            f'class="hw-chart-gridline"/>'
-        )
+        lines.append(f'<line x1="{vp.x}" y1="{y}" x2="{vp.x + vp.w}" y2="{y}" class="hw-chart-gridline"/>')
     return "".join(lines)
 
 
@@ -621,9 +676,7 @@ def build_chart_svg(
     # Empty state overlay: only when there are no data points AND a message
     # was provided. Without a message the chart degrades silently (useful for
     # embedded charts in stats.py that don't need a user-facing label).
-    empty_state_fragment = (
-        _build_empty_state(viewport, empty_message or "") if not points else ""
-    )
+    empty_state_fragment = _build_empty_state(viewport, empty_message or "") if not points else ""
 
     return {
         "defs": "",

{hyperweave-0.2.4 → hyperweave-0.2.5}/tests/fixtures/session.json

@@ -120,4 +120,4 @@
     }
   ],
   "agents": []
-}
+}

{hyperweave-0.2.4 → hyperweave-0.2.5}/tests/test_chart_engine.py

@@ -140,6 +140,45 @@ def test_build_bezier_path_starts_with_M() -> None:
     assert "C" in out  # cubic bezier control points present
 
 
+def test_build_bezier_path_no_degenerate_segments_on_close_points() -> None:
+    """When adjacent anchors are close in x, control handles must not cross.
+
+    Regression for the chrome "flat-then-vertical" bug: the previous
+    horizontal-handle implementation used ``dx = max(4, (x_cur - x_prev) // 3)``,
+    which produced ``c2.x < c1.x`` when points were close. Catmull-Rom tangents
+    scale with local chord length and avoid this.
+    """
+    import re
+
+    # Points clustered tightly in x (simulates slow-growth early period).
+    points = [(80, 410), (81, 390), (88, 368), (103, 348), (128, 325), (830, 169)]
+    path = _build_bezier_path(points)
+    segments = re.findall(r"C(\d+),(\d+) (\d+),(\d+) (\d+),(\d+)", path)
+    assert len(segments) == len(points) - 1
+    for c1x, _, c2x, _, _, _ in segments:
+        assert int(c2x) >= int(c1x), f"degenerate segment: c1x={c1x}, c2x={c2x} (c2 must not precede c1)"
+
+
+def test_build_bezier_path_tangents_follow_neighbor_slope() -> None:
+    """Tangents should respect data slope — not force horizontal tangent at every anchor.
+
+    With the old horizontal-handle approach, the first segment's c1 always had
+    ``c1.y == y_prev``. For data that rises, the new Catmull-Rom code shifts c1
+    toward the next point's y, producing a non-horizontal start.
+    """
+    # Rising data: y decreases (flipped SVG coords mean smaller y = higher on chart).
+    points = [(0, 400), (100, 300), (200, 200), (300, 100)]
+    path = _build_bezier_path(points)
+    import re
+
+    first_segment = re.match(r"M0,400 C(\d+),(\d+)", path)
+    assert first_segment is not None
+    c1y = int(first_segment.group(2))
+    # Old code produced c1y == 400 (horizontal tangent). New code should
+    # tilt toward y_next=300, so c1y < 400.
+    assert c1y < 400, f"expected tangent to tilt upward, got c1y={c1y}"
+
+
 def test_build_area_polygon_closes_to_baseline() -> None:
     pts = [(10, 50), (30, 30), (50, 20)]
     out = _build_area_polygon_points(pts, baseline_y=100)
@@ -285,9 +324,7 @@ def test_build_chart_svg_empty_with_message_renders_overlay(
     sample_viewport: Viewport,
 ) -> None:
     """Zero-data path with an empty_message renders a centered overlay label."""
-    result = build_chart_svg(
-        [], sample_viewport, structural={}, empty_message="NEW REPO · NO STARS YET"
-    )
+    result = build_chart_svg([], sample_viewport, structural={}, empty_message="NEW REPO · NO STARS YET")
     assert "NEW REPO" in result["empty_state"]
     assert 'data-hw-zone="empty-state"' in result["empty_state"]
 

{hyperweave-0.2.4 → hyperweave-0.2.5}/tests/test_chart_frame.py

@@ -118,10 +118,7 @@ def test_chart_six_stars_renders_real_polyline_with_derived_labels() -> None:
     timestamps yield distinct x-coordinates, and the derived Y ticks show
     [0, 2, 4, 6] — never the hardcoded "3K".
     """
-    points = [
-        {"date": f"2025-{m:02d}-01T00:00:00Z", "count": i + 1}
-        for i, m in enumerate((1, 3, 5, 7, 9, 11))
-    ]
+    points = [{"date": f"2025-{m:02d}-01T00:00:00Z", "count": i + 1} for i, m in enumerate((1, 3, 5, 7, 9, 11))]
     spec = ComposeSpec(
         type="chart",
         genome_id="brutalist-emerald",
@@ -167,15 +164,10 @@ async def test_fetch_stargazer_history_single_page_uses_per_stargazer_timestamps
         if url.endswith("/repos/jiahongc/cc-companion"):
             return {"stargazers_count": 6}
         if "page=1" in url:
-            return [
-                {"starred_at": f"2025-0{m}-01T00:00:00Z"}
-                for m in range(1, 7)
-            ]
+            return [{"starred_at": f"2025-0{m}-01T00:00:00Z"} for m in range(1, 7)]
         return {}
 
-    with patch(
-        "hyperweave.connectors.github.fetch_json", side_effect=fake_fetch_json
-    ):
+    with patch("hyperweave.connectors.github.fetch_json", side_effect=fake_fetch_json):
         result = await fetch_stargazer_history("jiahongc", "cc-companion")
 
     assert result["current_stars"] == 6

{hyperweave-0.2.4 → hyperweave-0.2.5}/tests/test_serve_live_state.py

@@ -53,24 +53,18 @@ async def test_badge_route_infers_passing_state(client: AsyncClient) -> None:
 
 async def test_badge_route_explicit_state_wins(client: AsyncClient) -> None:
     """?state=passing must override the "failing" value inference."""
-    resp = await client.get(
-        "/v1/badge/build/failing/brutalist-emerald.static?state=passing"
-    )
+    resp = await client.get("/v1/badge/build/failing/brutalist-emerald.static?state=passing")
     assert resp.status_code == 200
     assert _root_status(resp.text) == "passing"
 
 
 async def test_badge_route_percentage_ladder(client: AsyncClient) -> None:
     """Coverage 95%% should infer passing; 50%% should infer critical."""
-    resp_high = await client.get(
-        "/v1/badge/coverage/95%25/brutalist-emerald.static"
-    )
+    resp_high = await client.get("/v1/badge/coverage/95%25/brutalist-emerald.static")
     assert resp_high.status_code == 200
     assert _root_status(resp_high.text) == "passing"
 
-    resp_low = await client.get(
-        "/v1/badge/coverage/50%25/brutalist-emerald.static"
-    )
+    resp_low = await client.get("/v1/badge/coverage/50%25/brutalist-emerald.static")
     assert resp_low.status_code == 200
     assert _root_status(resp_low.text) == "critical"
 

{hyperweave-0.2.4 → hyperweave-0.2.5}/uv.lock

@@ -171,6 +171,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" },
 ]
 
+[[package]]
+name = "cfgv"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/b5/721b8799b04bf9afe054a3899c6cf4e880fcf8563cc71c15610242490a0c/cfgv-3.5.0.tar.gz", hash = "sha256:d5b1034354820651caa73ede66a6294d6e95c1b00acc5e9b098e917404669132", size = 7334, upload-time = "2025-11-19T20:55:51.612Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/db/3c/33bac158f8ab7f89b2e59426d5fe2e4f63f7ed25df84c036890172b412b5/cfgv-3.5.0-py2.py3-none-any.whl", hash = "sha256:a8dc6b26ad22ff227d2634a65cb388215ce6cc96bbcc5cfde7641ae87e8dacc0", size = 7445, upload-time = "2025-11-19T20:55:50.744Z" },
+]
+
 [[package]]
 name = "click"
 version = "8.3.1"
@@ -344,6 +353,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/06/06/d68a5d5d292c2ad2bc6a02e5ca2cb1bb9c15e941ab02f004a06a342d7f0f/cyclopts-4.10.0-py3-none-any.whl", hash = "sha256:50f333382a60df8d40ec14aa2e627316b361c4f478598ada1f4169d959bf9ea7", size = 204097, upload-time = "2026-03-14T14:09:32.504Z" },
 ]
 
+[[package]]
+name = "distlib"
+version = "0.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/96/8e/709914eb2b5749865801041647dc7f4e6d00b549cfe88b65ca192995f07c/distlib-0.4.0.tar.gz", hash = "sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d", size = 614605, upload-time = "2025-07-17T16:52:00.465Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/33/6b/e0547afaf41bf2c42e52430072fa5658766e3d65bd4b03a563d1b6336f57/distlib-0.4.0-py2.py3-none-any.whl", hash = "sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16", size = 469047, upload-time = "2025-07-17T16:51:58.613Z" },
+]
+
 [[package]]
 name = "dnspython"
 version = "2.8.0"
@@ -453,6 +471,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/70/ea/570122de7e24f72138d006f799768e14cc1ccf7fcb22b7750b2bd276c711/fastmcp-3.1.1-py3-none-any.whl", hash = "sha256:8132ba069d89f14566b3266919d6d72e2ec23dd45d8944622dca407e9beda7eb", size = 633754, upload-time = "2026-03-14T19:12:22.736Z" },
 ]
 
+[[package]]
+name = "filelock"
+version = "3.25.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/b8/00651a0f559862f3bb7d6f7477b192afe3f583cc5e26403b44e59a55ab34/filelock-3.25.2.tar.gz", hash = "sha256:b64ece2b38f4ca29dd3e810287aa8c48182bbecd1ae6e9ae126c9b35f1382694", size = 40480, upload-time = "2026-03-11T20:45:38.487Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a4/a5/842ae8f0c08b61d6484b52f99a03510a3a72d23141942d216ebe81fefbce/filelock-3.25.2-py3-none-any.whl", hash = "sha256:ca8afb0da15f229774c9ad1b455ed96e85a81373065fb10446672f64444ddf70", size = 26759, upload-time = "2026-03-11T20:45:37.437Z" },
+]
+
 [[package]]
 name = "h11"
 version = "0.16.0"
@@ -546,6 +573,7 @@ dependencies = [
 [package.dev-dependencies]
 dev = [
     { name = "mypy" },
+    { name = "pre-commit" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
@@ -574,6 +602,7 @@ requires-dist = [
 [package.metadata.requires-dev]
 dev = [
     { name = "mypy", specifier = ">=1.14" },
+    { name = "pre-commit", specifier = ">=4.0" },
     { name = "pytest", specifier = ">=8.0" },
     { name = "pytest-asyncio", specifier = ">=0.24" },
     { name = "pytest-cov", specifier = ">=6.0" },
@@ -586,6 +615,15 @@ dev = [
     { name = "types-pyyaml", specifier = ">=6.0.12.20250915" },
 ]
 
+[[package]]
+name = "identify"
+version = "2.6.18"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/46/c4/7fb4db12296cdb11893d61c92048fe617ee853f8523b9b296ac03b43757e/identify-2.6.18.tar.gz", hash = "sha256:873ac56a5e3fd63e7438a7ecbc4d91aca692eb3fefa4534db2b7913f3fc352fd", size = 99580, upload-time = "2026-03-15T18:39:50.319Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/46/33/92ef41c6fad0233e41d3d84ba8e8ad18d1780f1e5d99b3c683e6d7f98b63/identify-2.6.18-py2.py3-none-any.whl", hash = "sha256:8db9d3c8ea9079db92cafb0ebf97abdc09d52e97f4dcf773a2e694048b7cd737", size = 99394, upload-time = "2026-03-15T18:39:48.915Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.11"
@@ -957,6 +995,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/24/bf/d1bda4f6168e0b2e9e5958945e01910052158313224ada5ce1fb2e1113b8/nodeenv-1.10.0.tar.gz", hash = "sha256:996c191ad80897d076bdfba80a41994c2b47c68e224c542b48feba42ba00f8bb", size = 55611, upload-time = "2025-12-20T14:08:54.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/b2/d0896bdcdc8d28a7fc5717c305f1a861c26e18c05047949fb371034d98bd/nodeenv-1.10.0-py2.py3-none-any.whl", hash = "sha256:5bb13e3eed2923615535339b3c620e76779af4cb4c6a90deccc9e36b274d3827", size = 23438, upload-time = "2025-12-20T14:08:52.782Z" },
+]
+
 [[package]]
 name = "openapi-pydantic"
 version = "0.5.1"
@@ -1027,6 +1074,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "pre-commit"
+version = "4.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/40/f1/6d86a29246dfd2e9b6237f0b5823717f60cad94d47ddc26afa916d21f525/pre_commit-4.5.1.tar.gz", hash = "sha256:eb545fcff725875197837263e977ea257a402056661f09dae08e4b149b030a61", size = 198232, upload-time = "2025-12-16T21:14:33.552Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/19/fd3ef348460c80af7bb4669ea7926651d1f95c23ff2df18b9d24bab4f3fa/pre_commit-4.5.1-py2.py3-none-any.whl", hash = "sha256:3b3afd891e97337708c1674210f8eba659b52a38ea5f822ff142d10786221f77", size = 226437, upload-time = "2025-12-16T21:14:32.409Z" },
+]
+
 [[package]]
 name = "py-key-value-aio"
 version = "0.4.4"
@@ -1304,6 +1367,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ca/31/d4e37e9e550c2b92a9cbc2e4d0b7420a27224968580b5a447f420847c975/pytest_xdist-3.8.0-py3-none-any.whl", hash = "sha256:202ca578cfeb7370784a8c33d6d05bc6e13b4f25b5053c30a152269fd10f0b88", size = 46396, upload-time = "2025-07-01T13:30:56.632Z" },
 ]
 
+[[package]]
+name = "python-discovery"
+version = "1.2.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/de/ef/3bae0e537cfe91e8431efcba4434463d2c5a65f5a89edd47c6cf2f03c55f/python_discovery-1.2.2.tar.gz", hash = "sha256:876e9c57139eb757cb5878cbdd9ae5379e5d96266c99ef731119e04fffe533bb", size = 58872, upload-time = "2026-04-07T17:28:49.249Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d8/db/795879cc3ddfe338599bddea6388cc5100b088db0a4caf6e6c1af1c27e04/python_discovery-1.2.2-py3-none-any.whl", hash = "sha256:e1ae95d9af875e78f15e19aed0c6137ab1bb49c200f21f5061786490c9585c7a", size = 31894, upload-time = "2026-04-07T17:28:48.09Z" },
+]
+
 [[package]]
 name = "python-dotenv"
 version = "1.2.2"
@@ -1706,6 +1782,21 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e4/16/c1fd27e9549f3c4baf1dc9c20c456cd2f822dbf8de9f463824b0c0357e06/uvloop-0.22.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6cde23eeda1a25c75b2e07d39970f3374105d5eafbaab2a4482be82f272d5a5e", size = 4296730, upload-time = "2025-10-16T22:17:00.744Z" },
 ]
 
+[[package]]
+name = "virtualenv"
+version = "21.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+    { name = "python-discovery" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/97/c5/aff062c66b42e2183201a7ace10c6b2e959a9a16525c8e8ca8e59410d27a/virtualenv-21.2.1.tar.gz", hash = "sha256:b66ffe81301766c0d5e2208fc3576652c59d44e7b731fc5f5ed701c9b537fa78", size = 5844770, upload-time = "2026-04-09T18:47:11.482Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/0e/f083a76cb590e60dff3868779558eefefb8dfb7c9ed020babc7aa014ccbf/virtualenv-21.2.1-py3-none-any.whl", hash = "sha256:bd16b49c53562b28cf1a3ad2f36edb805ad71301dee70ddc449e5c88a9f919a2", size = 5828326, upload-time = "2026-04-09T18:47:09.331Z" },
+]
+
 [[package]]
 name = "watchfiles"
 version = "1.1.1"