usage-cli 0.32.1__tar.gz → 0.32.2__tar.gz

{usage_cli-0.32.1 → usage_cli-0.32.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.1
+Version: 0.32.2
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13

{usage_cli-0.32.1 → usage_cli-0.32.2}/i18n.json

@@ -431,8 +431,19 @@
     "claude_pane_week": "週",
     "claude_pane_period": "期間",
     "claude_pane_sessions": "Claude 對話",
+    "claude_pane_session_done": "完成：{title}",
+    "claude_pane_session_waiting": "在等你：{title}",
     "claude_pane_busy": "忙",
     "claude_pane_waiting": "等你",
+    "claude_pane_unavailable_not_signed_in": "未登入 · 在它的 CLI 登入一次",
+    "claude_pane_unavailable_no_data": "還沒有資料 · 用過一次就會出現",
+    "claude_pane_unavailable_error": "讀不到 · 會自動重試",
+    "claude_pane_waiting_input": "要你回答",
+    "claude_pane_waiting_dialog": "對話框開著",
+    "claude_pane_waiting_sandbox": "要允許沙盒",
+    "claude_pane_waiting_worker": "子代理請求",
+    "claude_pane_waiting_goal": "確認目標",
+    "claude_pane_waiting_for": "等你：{reason}",
     "claude_pane_agent_running": "執行中",
     "claude_pane_agent_idle": "閒置",
     "claude_pane_agent_pending": "待執行",
@@ -913,8 +924,19 @@
     "claude_pane_week": "Week",
     "claude_pane_period": "Period",
     "claude_pane_sessions": "Claude sessions",
+    "claude_pane_session_done": "Done: {title}",
+    "claude_pane_session_waiting": "Waiting for you: {title}",
     "claude_pane_busy": "Busy",
     "claude_pane_waiting": "waiting for you",
+    "claude_pane_unavailable_not_signed_in": "Not signed in · sign in once in its CLI",
+    "claude_pane_unavailable_no_data": "No data yet · shows up after first use",
+    "claude_pane_unavailable_error": "Couldn't read · retrying automatically",
+    "claude_pane_waiting_input": "needs your answer",
+    "claude_pane_waiting_dialog": "dialog open",
+    "claude_pane_waiting_sandbox": "sandbox permission",
+    "claude_pane_waiting_worker": "subagent request",
+    "claude_pane_waiting_goal": "confirm the goal",
+    "claude_pane_waiting_for": "waiting: {reason}",
     "claude_pane_agent_running": "running",
     "claude_pane_agent_idle": "idle",
     "claude_pane_agent_pending": "pending",
@@ -1395,8 +1417,19 @@
     "claude_pane_week": "周",
     "claude_pane_period": "期间",
     "claude_pane_sessions": "Claude 对话",
+    "claude_pane_session_done": "完成：{title}",
+    "claude_pane_session_waiting": "在等你：{title}",
     "claude_pane_busy": "忙",
     "claude_pane_waiting": "等你",
+    "claude_pane_unavailable_not_signed_in": "未登录 · 在它的 CLI 登录一次",
+    "claude_pane_unavailable_no_data": "还没有数据 · 用过一次就会出现",
+    "claude_pane_unavailable_error": "读不到 · 会自动重试",
+    "claude_pane_waiting_input": "要你回答",
+    "claude_pane_waiting_dialog": "对话框开着",
+    "claude_pane_waiting_sandbox": "要允许沙盒",
+    "claude_pane_waiting_worker": "子代理请求",
+    "claude_pane_waiting_goal": "确认目标",
+    "claude_pane_waiting_for": "等你：{reason}",
     "claude_pane_agent_running": "运行中",
     "claude_pane_agent_idle": "空闲",
     "claude_pane_agent_pending": "待运行",
@@ -1877,8 +1910,19 @@
     "claude_pane_week": "週",
     "claude_pane_period": "期間",
     "claude_pane_sessions": "Claude セッション",
+    "claude_pane_session_done": "完了：{title}",
+    "claude_pane_session_waiting": "入力待ち：{title}",
     "claude_pane_busy": "実行中",
     "claude_pane_waiting": "入力待ち",
+    "claude_pane_unavailable_not_signed_in": "未ログイン · CLI で一度ログイン",
+    "claude_pane_unavailable_no_data": "まだデータなし · 一度使うと表示",
+    "claude_pane_unavailable_error": "読み取れません · 自動で再試行",
+    "claude_pane_waiting_input": "回答待ち",
+    "claude_pane_waiting_dialog": "ダイアログ表示中",
+    "claude_pane_waiting_sandbox": "サンドボックス許可",
+    "claude_pane_waiting_worker": "サブエージェント要求",
+    "claude_pane_waiting_goal": "目標の確認",
+    "claude_pane_waiting_for": "入力待ち：{reason}",
     "claude_pane_agent_running": "実行中",
     "claude_pane_agent_idle": "待機中",
     "claude_pane_agent_pending": "実行待ち",
@@ -2359,8 +2403,19 @@
     "claude_pane_week": "주간",
     "claude_pane_period": "기간",
     "claude_pane_sessions": "Claude 대화",
+    "claude_pane_session_done": "완료: {title}",
+    "claude_pane_session_waiting": "입력 대기: {title}",
     "claude_pane_busy": "작업 중",
     "claude_pane_waiting": "입력 대기",
+    "claude_pane_unavailable_not_signed_in": "로그인 안 됨 · CLI에서 한 번 로그인",
+    "claude_pane_unavailable_no_data": "아직 데이터 없음 · 한 번 사용하면 표시",
+    "claude_pane_unavailable_error": "읽을 수 없음 · 자동으로 재시도",
+    "claude_pane_waiting_input": "답변 필요",
+    "claude_pane_waiting_dialog": "대화 상자 열림",
+    "claude_pane_waiting_sandbox": "샌드박스 권한",
+    "claude_pane_waiting_worker": "하위 에이전트 요청",
+    "claude_pane_waiting_goal": "목표 확인",
+    "claude_pane_waiting_for": "입력 대기: {reason}",
     "claude_pane_agent_running": "실행 중",
     "claude_pane_agent_idle": "유휴",
     "claude_pane_agent_pending": "실행 대기",

{usage_cli-0.32.1 → usage_cli-0.32.2}/pyproject.toml

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

{usage_cli-0.32.1 → usage_cli-0.32.2}/tests/test_usage_cli.py

@@ -28,6 +28,8 @@ usage_cli: Any = import_module("usage_cli")
 @pytest.fixture(autouse=True)
 def _isolate_status_quotas(monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
     monkeypatch.setattr(agy_quota_probe, "CACHE_PATH", tmp_path / "agy_quota_cache.json")
+    monkeypatch.setattr(agy_quota_probe, "_TOKEN_PATH", tmp_path / "agy-token")
+    agy_quota_probe._TOKEN_PATH.touch()
     monkeypatch.setattr(grok_quota_probe, "load_quota", lambda: None)
 
 
@@ -363,6 +365,7 @@ def test_main_status_json_marks_none_loader_unavailable(
     payload = json.loads(capsys.readouterr().out)
     assert payload["agents"]["claude-code"] == {
         "available": False,
+        "reason": "no_data",
         "five_hour": {"used_percent": None, "resets_at": None, "resets_in_seconds": None},
         "seven_day": {"used_percent": None, "resets_at": None, "resets_in_seconds": None},
         "model": None,
@@ -1041,6 +1044,7 @@ def test_dashboard_sort_cycle_shape_and_order() -> None:
 def test_status_payload_antigravity_cache(monkeypatch: pytest.MonkeyPatch, age: int) -> None:
     now = datetime(2026, 10, 4, 14, tzinfo=UTC)
     fetched_at = datetime.fromtimestamp(now.timestamp() - age + 0.319588, UTC).isoformat()
+    agy_quota_probe._TOKEN_PATH.unlink()
     cache = {
         "fetched_at": fetched_at,
         "groups": [
@@ -1090,7 +1094,9 @@ def test_status_payload_antigravity_cache(monkeypatch: pytest.MonkeyPatch, age:
 def test_status_antigravity_unreadable_cache(content: str | None) -> None:
     if content is not None:
         agy_quota_probe.CACHE_PATH.write_bytes(content.encode("latin-1"))
-    assert usage_cli._status_antigravity(1_000_000) == usage_cli._status_agent(None, 1_000_000)
+    assert usage_cli._status_antigravity(1_000_000) == usage_cli._status_agent(
+        None, 1_000_000, "error" if content == "\xff" else "no_data"
+    )
 
 
 @pytest.mark.parametrize("tier", ["XPremium", None])
@@ -1127,3 +1133,32 @@ def test_status_payload_grok(
 
 def test_status_grok_none() -> None:
     assert usage_cli._status_grok(1_000_000) == usage_cli._status_agent(None, 1_000_000)
+
+
+@pytest.mark.parametrize("signed_in", [False, True])
+def test_status_antigravity_missing_quota_reason(signed_in: bool) -> None:
+    if not signed_in:
+        agy_quota_probe._TOKEN_PATH.unlink()
+    assert usage_cli._status_antigravity(0)["reason"] == (
+        "no_data" if signed_in else "not_signed_in"
+    )
+
+
+@pytest.mark.parametrize("agent_id", ["claude-code", "codex", "antigravity", "grok"])
+def test_status_loader_exception_reason(monkeypatch: pytest.MonkeyPatch, agent_id: str) -> None:
+    def fail() -> None:
+        raise OSError("quota read failed")
+
+    monkeypatch.setattr(
+        usage_cli, "RATE_LIMIT_LOADERS", {"claude-code": lambda: None, "codex": lambda: None}
+    )
+    if agent_id == "antigravity":
+        agy_quota_probe._TOKEN_PATH.unlink()
+        monkeypatch.setattr(agy_quota_probe, "_read_cache", fail)
+    elif agent_id == "grok":
+        monkeypatch.setattr(grok_quota_probe, "load_quota", fail)
+    else:
+        monkeypatch.setitem(usage_cli.RATE_LIMIT_LOADERS, agent_id, fail)
+    payload = usage_cli._status_payload()
+    assert payload["schema_version"] == 1
+    assert payload["agents"][agent_id]["reason"] == "error"

{usage_cli-0.32.1 → usage_cli-0.32.2}/usage_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.1
+Version: 0.32.2
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13

{usage_cli-0.32.1 → usage_cli-0.32.2}/usage_cli.py

@@ -358,10 +358,13 @@ def _age_seconds(updated_at: str | None, now: int) -> int | None:
     return None if parsed is None else max(0, now - int(parsed.timestamp()))
 
 
-def _status_agent(rate_limits: RateLimits | None, now: int) -> dict[str, Any]:
+def _status_agent(
+    rate_limits: RateLimits | None, now: int, reason: str = "no_data"
+) -> dict[str, Any]:
     if rate_limits is None:
         return {
             "available": False,
+            "reason": reason,
             "five_hour": _status_window(None, None, now),
             "seven_day": _status_window(None, None, now),
             "model": None,
@@ -386,9 +389,10 @@ def _status_antigravity(now: int) -> dict[str, Any]:
     try:
         quota = agy_quota_probe._read_cache()
     except (OSError, UnicodeError, ValueError):
-        quota = None
+        return _status_agent(None, now, "error")
     if quota is None:
-        return _status_agent(None, now)
+        reason = "no_data" if agy_quota_probe._TOKEN_PATH.exists() else "not_signed_in"
+        return _status_agent(None, now, reason)
     fetched_at = parse_optional_iso8601_utc(quota.fetched_at)
     if fetched_at is None:
         return _status_agent(None, now)
@@ -426,7 +430,7 @@ def _status_grok(now: int) -> dict[str, Any]:
         period_end = None if quota is None else parse_optional_iso8601_utc(quota.period_end)
         resets_at = None if period_end is None else int(period_end.timestamp())
     except (OSError, ValueError, OverflowError):
-        return _status_agent(None, now)
+        return _status_agent(None, now, "error")
     if quota is None or resets_at is None:
         return _status_agent(None, now)
     return {
@@ -446,8 +450,9 @@ def _status_payload(*, include_extra_agents: bool = True) -> dict[str, Any]:
         try:
             rate_limits = RATE_LIMIT_LOADERS[agent_id]()
         except Exception:
-            rate_limits = None
-        agents[agent_id] = _status_agent(rate_limits, now)
+            agents[agent_id] = _status_agent(None, now, "error")
+        else:
+            agents[agent_id] = _status_agent(rate_limits, now)
     if include_extra_agents:
         agents["antigravity"] = _status_antigravity(now)
         agents["grok"] = _status_grok(now)