usage-cli 0.30.24__tar.gz → 0.31.1__tar.gz

{usage_cli-0.30.24/usage_cli.egg-info → usage_cli-0.31.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.30.24
+Version: 0.31.1
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -87,7 +87,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ### Experience & Customization
 
-- **14 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, and Catppuccin (official palette, all four flavors).
+- **16 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, Heart Monitor, and Catppuccin (official palette, all four flavors).
 - **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
@@ -147,7 +147,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 14 quota themes available on macOS (Default plus the other thirteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 
@@ -164,7 +164,7 @@ Privacy policy: this program will not transfer any information to other networke
 
 ## Theme Gallery
 
-Switch between **14 visual themes** directly from the UI:
+Switch between **16 visual themes** directly from the UI:
 
 <p align="center">
   <img src="docs/classic.en.png" width="32%" alt="Classic theme" />

{usage_cli-0.30.24 → usage_cli-0.31.1}/README.md

@@ -67,7 +67,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ### Experience & Customization
 
-- **14 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, and Catppuccin (official palette, all four flavors).
+- **16 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, Heart Monitor, and Catppuccin (official palette, all four flavors).
 - **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
@@ -127,7 +127,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 14 quota themes available on macOS (Default plus the other thirteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 
@@ -144,7 +144,7 @@ Privacy policy: this program will not transfer any information to other networke
 
 ## Theme Gallery
 
-Switch between **14 visual themes** directly from the UI:
+Switch between **16 visual themes** directly from the UI:
 
 <p align="center">
   <img src="docs/classic.en.png" width="32%" alt="Classic theme" />

{usage_cli-0.30.24 → usage_cli-0.31.1}/analyzer/reporter.py

@@ -43,7 +43,7 @@ _YEAR_WEEKS = 53
 YEAR_CACHE_PATH = Path(os.path.expanduser("~/.usage/year_cache.json"))
 YEAR_LEDGER_PATH = YEAR_CACHE_PATH.with_name("year_ledger.json")
 YEAR_CACHE_TTL_SECONDS = 6 * 3600
-_YEAR_CACHE_SCHEMA = 3
+_YEAR_CACHE_SCHEMA = 4
 _YEAR_LEDGER_SCHEMA = 1
 _YEAR_LEDGER_TRIM_BUFFER_DAYS = 60
 

{usage_cli-0.30.24 → usage_cli-0.31.1}/i18n.json

@@ -10,6 +10,8 @@
     "panel_prism_arcade": "稜鏡街機",
     "panel_stained_glass": "彩繪玻璃",
     "panel_migration": "候鳥遷徙",
+    "panel_sketchbook": "手繪筆記",
+    "panel_heart_monitor": "心電圖",
     "panel_origami": "摺紙",
     "panel_catppuccin": "Catppuccin",
     "panel_black_hole": "黑洞視界",
@@ -435,6 +437,8 @@
     "panel_prism_arcade": "Prism Arcade",
     "panel_stained_glass": "Stained Glass",
     "panel_migration": "Migration",
+    "panel_sketchbook": "Sketchbook",
+    "panel_heart_monitor": "Heart Monitor",
     "panel_origami": "Origami",
     "panel_catppuccin": "Catppuccin",
     "panel_black_hole": "Black Hole",
@@ -860,6 +864,8 @@
     "panel_prism_arcade": "棱镜街机",
     "panel_stained_glass": "彩绘玻璃",
     "panel_migration": "候鸟迁徙",
+    "panel_sketchbook": "手绘笔记",
+    "panel_heart_monitor": "心电图",
     "panel_origami": "折纸",
     "panel_catppuccin": "Catppuccin",
     "panel_black_hole": "黑洞视界",
@@ -1285,6 +1291,8 @@
     "panel_prism_arcade": "プリズムアーケード",
     "panel_stained_glass": "ステンドグラス",
     "panel_migration": "渡り鳥",
+    "panel_sketchbook": "手描きノート",
+    "panel_heart_monitor": "心電図モニター",
     "panel_origami": "折り紙",
     "panel_catppuccin": "Catppuccin",
     "panel_black_hole": "ブラックホール",
@@ -1710,6 +1718,8 @@
     "panel_prism_arcade": "프리즘 아케이드",
     "panel_stained_glass": "스테인드글라스",
     "panel_migration": "철새 이동",
+    "panel_sketchbook": "손그림 노트",
+    "panel_heart_monitor": "심전도 모니터",
     "panel_origami": "종이접기",
     "panel_catppuccin": "Catppuccin",
     "panel_black_hole": "블랙홀",

{usage_cli-0.30.24 → usage_cli-0.31.1}/loaders/agy_loader.py

@@ -38,7 +38,7 @@ AGY_SESSIONS_DIR = Path(os.path.expanduser("~/.gemini/antigravity-cli/conversati
 # below that count evicts databases parsed during the prior refresh, causing a
 # permanent full SQLite/protobuf reparse on every load (LRU thrashing).
 _FILE_CACHE_MAXSIZE = 4096
-_AGY_DB_CACHE_SCHEMA = 2
+_AGY_DB_CACHE_SCHEMA = 3
 AGY_CACHE_PATH = Path(os.path.expanduser("~/.usage/agy_db_cache.json"))
 _disk_cache_seeded = False
 _DISK_CACHE_FLUSH_INTERVAL_S = 300.0
@@ -239,10 +239,32 @@ def _parse_database(path: Path) -> tuple[list[AgyUsageEntry], int] | None:
         with sqlite3.connect(_readonly_sqlite_uri(path), uri=True) as connection:
             session_timestamp = _session_timestamp(connection, path)
             project = _session_project(connection)
-            rows = connection.execute("SELECT data FROM gen_metadata ORDER BY idx")
+            by_response_id: dict[str, datetime] = {}
+            by_gen_idx: dict[int, datetime] = {}
+            try:
+                for (metadata,) in connection.execute(
+                    "SELECT metadata FROM steps WHERE step_type = 15 AND metadata IS NOT NULL"
+                ):
+                    if not isinstance(metadata, bytes):
+                        continue
+                    timestamp = _timestamp(_message_field(metadata, 1))
+                    if timestamp is None:
+                        continue
+                    response_metadata = _message_field(metadata, 9)
+                    response_id = _string_field(response_metadata or b"", 11)
+                    if response_id and response_id.strip():
+                        by_response_id[response_id.strip()] = timestamp
+                    generation_metadata = _message_field(metadata, 20)
+                    gen_idx = _varint_field(generation_metadata or b"", 3)
+                    if gen_idx is not None:
+                        by_gen_idx[gen_idx] = timestamp
+            except sqlite3.Error:
+                by_response_id.clear()
+                by_gen_idx.clear()
+            rows = connection.execute("SELECT idx, data FROM gen_metadata ORDER BY idx")
             entries: list[AgyUsageEntry] = []
             skipped_missing_dedup_key = 0
-            for (blob,) in rows:
+            for gen_idx, blob in rows:
                 if not isinstance(blob, bytes):
                     continue
                 entry, missing_dedup_key = _parse_generation(
@@ -250,6 +272,9 @@ def _parse_database(path: Path) -> tuple[list[AgyUsageEntry], int] | None:
                     path.stem,
                     session_timestamp,
                     set(),
+                    gen_idx=gen_idx,
+                    by_response_id=by_response_id,
+                    by_gen_idx=by_gen_idx,
                     project=project,
                 )
                 skipped_missing_dedup_key += missing_dedup_key
@@ -304,6 +329,10 @@ def _parse_generation(
     session_id: str,
     session_timestamp: datetime,
     seen_dedup_keys: set[str],
+    *,
+    gen_idx: int,
+    by_response_id: dict[str, datetime],
+    by_gen_idx: dict[int, datetime],
     project: str = "",
 ) -> tuple[AgyUsageEntry | None, int]:
     chat_model = _message_field(blob, 1)
@@ -335,11 +364,16 @@ def _parse_generation(
         return None, 0
     seen_dedup_keys.add(dedup_key)
 
-    timestamp = _timestamp(_message_field(_message_field(chat_model, 9) or b"", 4))
+    timestamp = (
+        _timestamp(_message_field(_message_field(chat_model, 9) or b"", 4))
+        or by_response_id.get(dedup_key.strip())
+        or by_gen_idx.get(gen_idx)
+        or session_timestamp
+    )
     model = _string_field(chat_model, 19) or "unknown"
     return (
         AgyUsageEntry(
-            timestamp=timestamp or session_timestamp,
+            timestamp=timestamp,
             model=model,
             input_tokens=system_tokens + new_input_tokens,
             output_tokens=output_tokens,

{usage_cli-0.30.24 → usage_cli-0.31.1}/panels/__init__.py

@@ -130,6 +130,34 @@ def all_panels() -> tuple[Panel, ...]:
             status_wrap_extra_height=30.0,
             service_alert_height=32.0,
         ),
+        # Use classic's measured values as initial estimates for the same DOM;
+        # dynamic_height.py measures sketchbook's actual rendered height.
+        HTMLPanel(
+            "sketchbook",
+            "panel_sketchbook",
+            "sketchbook.html",
+            height=1132.0,
+            claude_card_height=192.0,
+            codex_card_height=192.0,
+            agy_card_height=192.0,
+            grok_card_height=128.0,
+            status_wrap_extra_height=30.0,
+            service_alert_height=32.0,
+        ),
+        # Use classic's measured values as initial estimates for the same DOM;
+        # dynamic_height.py measures heart_monitor's actual rendered height.
+        HTMLPanel(
+            "heart_monitor",
+            "panel_heart_monitor",
+            "heart_monitor.html",
+            height=1132.0,
+            claude_card_height=192.0,
+            codex_card_height=192.0,
+            agy_card_height=192.0,
+            grok_card_height=128.0,
+            status_wrap_extra_height=30.0,
+            service_alert_height=32.0,
+        ),
         # Reuse classic's measured values because the DOM structure is identical;
         # remeasure if a future render shows clipping.
         HTMLPanel(

{usage_cli-0.30.24 → usage_cli-0.31.1}/panels/dynamic_height.py

@@ -15,6 +15,10 @@ CONTENT_HEIGHT_SCRIPT = """
   if (typeof applyState !== "function") return;
   var scheduled = false;
   var lastPostedHeight = null;
+  var lastPostedDpr = null;
+  var fittingHeight = 0;
+  var contentChanged = false;
+  var lastMeasuredHeight = null;
   function naturalContentHeight() {
     var root = document.documentElement;
     // Measure in the displayed zoom: WebKit may enforce a minimum rendered
@@ -116,12 +120,30 @@ CONTENT_HEIGHT_SCRIPT = """
   function reportContentHeight() {
     scheduled = false;
     var height = naturalContentHeight();
+    // A zoom-only fit may grow to accommodate wrapping, but must not shrink
+    // again: fractional WebKit metrics can otherwise alternate between two
+    // heights, each producing the other's scale. Real content changes can
+    // still contract; identical state refreshes keep the settled fit.
+    if (contentChanged && height !== lastMeasuredHeight) fittingHeight = 0;
+    contentChanged = false;
+    lastMeasuredHeight = height;
+    if (Number.isFinite(height) && height > 0) {
+      fittingHeight = Math.max(fittingHeight, height);
+      height = fittingHeight;
+    }
     var bridge = window.webkit && window.webkit.messageHandlers
       && window.webkit.messageHandlers.usage;
-    if (Number.isFinite(height) && height > 0 && height !== lastPostedHeight && bridge
+    // The native side sizes its window from this height, so it also needs the
+    // ratio the page really renders at. On Windows that is the display scale
+    // times the "Text size" accessibility setting (125% x 109% = 1.3625), which
+    // GetDpiForWindow does not include.
+    var dpr = window.devicePixelRatio;
+    if (Number.isFinite(height) && height > 0
+        && (height !== lastPostedHeight || dpr !== lastPostedDpr) && bridge
         && typeof bridge.postMessage === "function") {
       lastPostedHeight = height;
-      bridge.postMessage(JSON.stringify({ action: "content_height", height: height }));
+      lastPostedDpr = dpr;
+      bridge.postMessage(JSON.stringify({ action: "content_height", height: height, dpr: dpr }));
     }
   }
   function requestContentHeight() {
@@ -137,15 +159,24 @@ CONTENT_HEIGHT_SCRIPT = """
   window.usageRequestContentHeight = requestContentHeight;
   window.usageInvalidateContentHeight = function() {
     lastPostedHeight = null;
+    lastPostedDpr = null;
+    fittingHeight = 0;
     requestContentHeight();
   };
-  window.usageApplyPanelZoom = function(scale, naturalHeight) {
+  function requestContentChange() {
+    contentChanged = true;
+    requestContentHeight();
+  }
+  window.usageApplyPanelZoom = function(scale, naturalHeight, scroll) {
     var value = Number(scale);
     var root = document.documentElement;
     var body = document.body;
     var height = Number(naturalHeight);
     var scaled = Number.isFinite(value) && value > 0 && value !== 1;
+    if (!scaled) fittingHeight = 0;
     root.style.zoom = scaled ? String(value) : "normal";
+    root.style.overflowY = scroll ? "auto" : "";
+    if (body) body.style.overflowY = scroll ? "auto" : "";
     // Chromium's CSS zoom scales the paint output but leaves its layout box at
     // the viewport height. Give that box the known natural content height so
     // flex children are not shrunk and clipped before they are painted.
@@ -161,12 +192,12 @@ CONTENT_HEIGHT_SCRIPT = """
   };
   window.usageApplyState = function usageApplyStateWithDynamicHeight(state) {
     var result = applyState.apply(this, arguments);
-    requestContentHeight();
+    requestContentChange();
     return result;
   };
   var wrap = document.querySelector(".wrap");
   if (wrap && typeof MutationObserver === "function") {
-    new MutationObserver(requestContentHeight).observe(wrap, {
+    new MutationObserver(requestContentChange).observe(wrap, {
       childList: true,
       characterData: true,
       subtree: true
@@ -176,7 +207,7 @@ CONTENT_HEIGHT_SCRIPT = """
     new ResizeObserver(requestContentHeight).observe(wrap);
   }
   if (document.fonts && document.fonts.ready) {
-    document.fonts.ready.then(requestContentHeight);
+    document.fonts.ready.then(requestContentChange);
   }
   requestContentHeight();
 })();

{usage_cli-0.30.24 → usage_cli-0.31.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usage-cli"
-version = "0.30.24"
+version = "0.31.1"
 description = "usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）"
 readme = "README.md"
 requires-python = ">=3.13"

{usage_cli-0.30.24 → usage_cli-0.31.1}/tests/test_agy_loader.py

@@ -72,11 +72,22 @@ def _trajectory_blob(timestamp: datetime) -> bytes:
     return _message_field(2, _timestamp_blob(timestamp))
 
 
+def _step_metadata_blob(timestamp: datetime, response_id: str, gen_idx: int) -> bytes:
+    return b"".join(
+        (
+            _message_field(1, _timestamp_blob(timestamp)),
+            _message_field(9, _message_field(11, response_id.encode())),
+            _message_field(20, _varint_field(3, gen_idx)),
+        )
+    )
+
+
 def _write_database(
     path: Path,
     rows: list[bytes],
     session_timestamp: datetime,
     steps_payloads: list[bytes] | None = None,
+    steps_metadata: list[tuple[int, bytes]] | None = None,
 ) -> None:
     path.parent.mkdir(parents=True, exist_ok=True)
     with sqlite3.connect(path) as connection:
@@ -92,11 +103,23 @@ def _write_database(
             "INSERT INTO trajectory_metadata_blob (data) VALUES (?)",
             (_trajectory_blob(session_timestamp),),
         )
-        if steps_payloads is not None:
-            connection.execute("CREATE TABLE steps (idx INTEGER PRIMARY KEY, step_payload BLOB);")
+        if steps_payloads is not None or steps_metadata is not None:
+            connection.execute(
+                "CREATE TABLE steps "
+                "(idx INTEGER PRIMARY KEY, step_payload BLOB, step_type INTEGER, metadata BLOB);"
+            )
             connection.executemany(
                 "INSERT INTO steps (idx, step_payload) VALUES (?, ?)",
-                [(index, payload) for index, payload in enumerate(steps_payloads)],
+                [(index, payload) for index, payload in enumerate(steps_payloads or [])],
+            )
+            connection.executemany(
+                "INSERT INTO steps (idx, step_type, metadata) VALUES (?, ?, ?)",
+                [
+                    (index, step_type, metadata)
+                    for index, (step_type, metadata) in enumerate(
+                        steps_metadata or [], start=len(steps_payloads or [])
+                    )
+                ],
             )
 
 
@@ -181,6 +204,76 @@ def test_load_entries_filters_on_generation_timestamp_and_falls_back_to_session_
     assert entries[0].timestamp == now
 
 
+def test_load_entries_uses_step_response_id_timestamp(sessions_dir: Path) -> None:
+    session_timestamp = datetime(2026, 1, 1, tzinfo=UTC)
+    step_timestamp = datetime(2026, 1, 2, 3, 4, 5, 123_456, tzinfo=UTC)
+    _write_database(
+        sessions_dir / "response_id.db",
+        [_generation_blob(timestamp=None, dedup_key=" response-id ")],
+        session_timestamp,
+        steps_metadata=[(15, _step_metadata_blob(step_timestamp, "response-id", 99))],
+    )
+
+    entries = agy_loader.load_entries()
+
+    assert len(entries) == 1
+    assert entries[0].timestamp == step_timestamp
+
+
+def test_load_entries_uses_step_generation_index_when_response_id_differs(
+    sessions_dir: Path,
+) -> None:
+    session_timestamp = datetime(2026, 1, 1, tzinfo=UTC)
+    step_timestamp = datetime(2026, 1, 2, tzinfo=UTC)
+    _write_database(
+        sessions_dir / "generation_index.db",
+        [_generation_blob(timestamp=None, dedup_key="generation")],
+        session_timestamp,
+        steps_metadata=[(15, _step_metadata_blob(step_timestamp, "other", 0))],
+    )
+
+    entries = agy_loader.load_entries()
+
+    assert len(entries) == 1
+    assert entries[0].timestamp == step_timestamp
+
+
+def test_load_entries_falls_back_when_step_does_not_match(sessions_dir: Path) -> None:
+    session_timestamp = datetime(2026, 1, 1, tzinfo=UTC)
+    step_timestamp = datetime(2026, 1, 2, tzinfo=UTC)
+    _write_database(
+        sessions_dir / "unmatched.db",
+        [_generation_blob(timestamp=None, dedup_key="generation")],
+        session_timestamp,
+        steps_metadata=[
+            (14, _step_metadata_blob(step_timestamp, "generation", 0)),
+            (15, _step_metadata_blob(step_timestamp, "other", 99)),
+        ],
+    )
+
+    entries = agy_loader.load_entries()
+
+    assert len(entries) == 1
+    assert entries[0].timestamp == session_timestamp
+
+
+def test_load_entries_prefers_legacy_generation_timestamp(sessions_dir: Path) -> None:
+    session_timestamp = datetime(2026, 1, 1, tzinfo=UTC)
+    step_timestamp = datetime(2026, 1, 2, tzinfo=UTC)
+    generation_timestamp = datetime(2026, 1, 3, tzinfo=UTC)
+    _write_database(
+        sessions_dir / "legacy.db",
+        [_generation_blob(timestamp=generation_timestamp, dedup_key="generation")],
+        session_timestamp,
+        steps_metadata=[(15, _step_metadata_blob(step_timestamp, "generation", 0))],
+    )
+
+    entries = agy_loader.load_entries()
+
+    assert len(entries) == 1
+    assert entries[0].timestamp == generation_timestamp
+
+
 def test_recent_input_output_tokens_excludes_cache_and_thinking(sessions_dir: Path) -> None:
     now = datetime.now(UTC)
     _write_database(
@@ -325,12 +418,13 @@ def test_load_entries_falls_back_to_empty_project_when_steps_table_missing(
     now = datetime.now(UTC)
     _write_database(
         sessions_dir / "no_steps.db",
-        [_generation_blob(timestamp=now, dedup_key="no-steps")],
+        [_generation_blob(timestamp=None, dedup_key="no-steps")],
         now,
     )
     entries = agy_loader.load_entries()
     assert len(entries) == 1
     assert entries[0].project == ""
+    assert entries[0].timestamp == now
 
 
 def test_load_entries_takes_first_cwd_and_handles_escapes(

{usage_cli-0.30.24 → usage_cli-0.31.1}/tests/test_analyzer_pipeline.py

@@ -252,6 +252,8 @@ def test_html_panels_expose_analyze_action() -> None:
         "lepidoptera.html",
         "matrix.html",
         "migration.html",
+        "sketchbook.html",
+        "heart_monitor.html",
         "newspaper.html",
         "origami.html",
         "prism_arcade.html",

{usage_cli-0.30.24 → usage_cli-0.31.1}/tests/test_dynamic_height.py

@@ -30,7 +30,7 @@ def test_script_wraps_state_application_and_measures_without_height_constraints(
     assert "requestAnimationFrame" in CONTENT_HEIGHT_SCRIPT
     assert "MutationObserver" in CONTENT_HEIGHT_SCRIPT
     assert "ResizeObserver" in CONTENT_HEIGHT_SCRIPT
-    assert "document.fonts.ready.then(requestContentHeight)" in CONTENT_HEIGHT_SCRIPT
+    assert "document.fonts.ready.then(requestContentChange)" in CONTENT_HEIGHT_SCRIPT
     assert "height !== lastPostedHeight" in CONTENT_HEIGHT_SCRIPT
     assert "requestContentHeight();" in CONTENT_HEIGHT_SCRIPT
     assert "window.usageInvalidateContentHeight" in CONTENT_HEIGHT_SCRIPT
@@ -40,7 +40,7 @@ def test_script_wraps_state_application_and_measures_without_height_constraints(
     assert "wrap.getBoundingClientRect().height / scale" in CONTENT_HEIGHT_SCRIPT
     assert "element.getBoundingClientRect().height / scale" in CONTENT_HEIGHT_SCRIPT
     assert "window.usageApplyPanelZoom" in CONTENT_HEIGHT_SCRIPT
-    assert "function(scale, naturalHeight)" in CONTENT_HEIGHT_SCRIPT
+    assert "function(scale, naturalHeight, scroll)" in CONTENT_HEIGHT_SCRIPT
     assert 'body.style.height = ""' in CONTENT_HEIGHT_SCRIPT
     assert 'String(height) + "px"' in CONTENT_HEIGHT_SCRIPT
     assert "innerHeight /" not in CONTENT_HEIGHT_SCRIPT
@@ -59,6 +59,19 @@ def test_script_wraps_state_application_and_measures_without_height_constraints(
     assert "body.style.height = bodyHeight" in CONTENT_HEIGHT_SCRIPT
 
 
+def test_script_reports_the_rendered_device_pixel_ratio_with_the_height() -> None:
+    # The window is sized from the reported height, so the native side needs the
+    # ratio the page really renders at: on Windows it includes the "Text size"
+    # setting that GetDpiForWindow leaves out.
+    assert "var dpr = window.devicePixelRatio;" in CONTENT_HEIGHT_SCRIPT
+    assert 'action: "content_height", height: height, dpr: dpr' in CONTENT_HEIGHT_SCRIPT
+    # A ratio change alone is worth reporting again, and invalidating the
+    # height must not leave a stale ratio behind.
+    assert "dpr !== lastPostedDpr" in CONTENT_HEIGHT_SCRIPT
+    assert "lastPostedDpr = dpr;" in CONTENT_HEIGHT_SCRIPT
+    assert "lastPostedDpr = null;" in CONTENT_HEIGHT_SCRIPT
+
+
 def test_world_cup_declares_its_pitch_height_floor() -> None:
     html = (PANEL_ASSETS / "world_cup.html").read_text(encoding="utf-8")
 

{usage_cli-0.30.24 → usage_cli-0.31.1}/tests/test_panel_footer_layout.py

@@ -23,7 +23,8 @@ ROOT = Path(__file__).resolve().parents[1]
     os.environ.get("USAGE_BROWSER_TESTS") != "1" or sys.platform != "darwin",
     reason="opt-in browser test using the macOS demo generator",
 )
-def test_footer_layout(tmp_path: Path) -> None:
+@pytest.mark.parametrize("script", ["panel_footer_layout.cjs", "panel_height_feedback.cjs"])
+def test_footer_layout(tmp_path: Path, script: str) -> None:
     node = shutil.which("node")
     assert node, "USAGE_BROWSER_TESTS requires Node and an existing playwright installation"
     subprocess.run(
@@ -34,10 +35,10 @@ def test_footer_layout(tmp_path: Path) -> None:
         text=True,
     )
     result = subprocess.run(
-        [node, str(ROOT / "tests/panel_footer_layout.cjs"), str(tmp_path)],
+        [node, str(ROOT / "tests" / script), str(tmp_path)],
         cwd=ROOT,
         capture_output=True,
         text=True,
-        timeout=240,
+        timeout=600,
     )
     assert result.returncode == 0, result.stdout + result.stderr

{usage_cli-0.30.24 → usage_cli-0.31.1}/tests/test_panels.py

@@ -32,6 +32,8 @@ CARD_PANEL_FILENAMES = (
     "lepidoptera.html",
     "matrix.html",
     "migration.html",
+    "sketchbook.html",
+    "heart_monitor.html",
     "newspaper.html",
     "origami.html",
     "prism_arcade.html",
@@ -68,6 +70,8 @@ def test_registered_panel_ids_are_unique() -> None:
         "prism_arcade",
         "stained_glass",
         "migration",
+        "sketchbook",
+        "heart_monitor",
         "origami",
         "black_hole",
         "lepidoptera",
@@ -90,6 +94,8 @@ def test_registered_panel_i18n_keys() -> None:
         "panel_prism_arcade",
         "panel_stained_glass",
         "panel_migration",
+        "panel_sketchbook",
+        "panel_heart_monitor",
         "panel_origami",
         "panel_black_hole",
         "panel_lepidoptera",