usage-cli 0.34.12__tar.gz → 0.34.14__tar.gz

{usage_cli-0.34.12/usage_cli.egg-info → usage_cli-0.34.14}/PKG-INFO

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

usage_cli-0.34.14/analyzer/ledger_legacy_backfill.py

@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (C) 2026 lollapalooza <https://github.com/aqua5230>
+#
+# Part of "usage". Free software licensed under the GNU Affero General Public
+# License v3.0 only; see the LICENSE file for full terms and the warranty disclaimer.
+
+"""Restore dimensions of total-only ledger days from read-only Codex state."""
+
+from __future__ import annotations
+
+import logging
+import sqlite3
+from contextlib import closing
+from datetime import datetime
+from typing import TYPE_CHECKING
+
+from loaders import codex_loader
+
+from .ledger_backfill import _allocate
+
+if TYPE_CHECKING:
+    from .reporter import _YearDay
+
+logger = logging.getLogger(__name__)
+
+
+def backfill_days(days: dict[str, _YearDay]) -> bool:
+    """Mutate eligible days only after a successful source read; report changes."""
+    eligible = {
+        key: day
+        for key, day in days.items()
+        if day["total_tokens"] > 0 and all(tokens == 0 for tokens in day["agent_tokens"].values())
+    }
+    if not eligible:
+        return False
+    try:
+        with closing(
+            sqlite3.connect(codex_loader._readonly_sqlite_uri(codex_loader.STATE_DB), uri=True)
+        ) as connection:
+            rows = connection.execute(
+                "SELECT created_at, tokens_used, model, cwd FROM threads WHERE tokens_used > 0"
+            ).fetchall()
+    except (OSError, sqlite3.Error) as exc:
+        logger.warning("Legacy ledger backfill could not read %s: %s", codex_loader.STATE_DB, exc)
+        return False
+
+    models: dict[str, dict[str, int]] = {key: {} for key in eligible}
+    projects: dict[str, dict[str, int]] = {key: {} for key in eligible}
+    for created_at, tokens, model, cwd in rows:
+        if not isinstance(created_at, int | float) or not isinstance(tokens, int) or tokens <= 0:
+            logger.warning("Legacy ledger backfill skipped invalid thread counts or timestamp")
+            continue
+        try:
+            day_key = datetime.fromtimestamp(created_at).date().isoformat()
+        except (OSError, OverflowError, ValueError):
+            logger.warning("Legacy ledger backfill skipped invalid thread timestamp %r", created_at)
+            continue
+        if day_key not in eligible:
+            continue
+        model = model if isinstance(model, str) and model else "unknown"
+        project = codex_loader._project_from_cwd(cwd) if isinstance(cwd, str) and cwd else "unknown"
+        models[day_key][model] = models[day_key].get(model, 0) + tokens
+        projects[day_key][project] = projects[day_key].get(project, 0) + tokens
+
+    for day_key, day in eligible.items():
+        source_total = sum(models[day_key].values())
+        codex_tokens = min(source_total, day["total_tokens"])
+        unknown_tokens = day["total_tokens"] - codex_tokens
+        day["agent_tokens"] = {"codex": codex_tokens} if codex_tokens else {}
+        day["model_tokens"] = (
+            dict(_allocate(models[day_key], {}, codex_tokens)) if codex_tokens else {}
+        )
+        day["project_tokens"] = (
+            dict(_allocate(projects[day_key], {}, codex_tokens)) if codex_tokens else {}
+        )
+        if unknown_tokens:
+            for dimension in (day["agent_tokens"], day["model_tokens"], day["project_tokens"]):
+                dimension["unknown"] = dimension.get("unknown", 0) + unknown_tokens
+    return True

{usage_cli-0.34.12 → usage_cli-0.34.14}/analyzer/reporter.py

@@ -29,7 +29,7 @@ from adapters.types import AgentInfo, UsageEntry
 from usage_common.pricing import calculate_cost, is_model_priced
 
 from .aggregator import aggregate_sessions
-from . import diagnoser, dispatch_ledger, ledger_backfill, usage_snapshot
+from . import diagnoser, dispatch_ledger, ledger_backfill, ledger_legacy_backfill, usage_snapshot
 
 logger = logging.getLogger(__name__)
 
@@ -45,9 +45,9 @@ _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 = 6
+_YEAR_CACHE_SCHEMA = 7
 _YEAR_LEDGER_SCHEMA = 1
-_year_ledger_lock = threading.Lock()
+_year_ledger_lock = threading.RLock()
 _YEAR_LEDGER_TRIM_BUFFER_DAYS = 60
 
 
@@ -572,6 +572,14 @@ def _year_day_from_json(value: object) -> _YearDay | None:
 
 
 def _read_year_ledger() -> _YearLedger:
+    with _year_ledger_lock:
+        ledger = _read_year_ledger_unlocked()
+        if ledger_legacy_backfill.backfill_days(ledger["days"]):
+            _write_year_ledger(ledger)
+        return ledger
+
+
+def _read_year_ledger_unlocked() -> _YearLedger:
     try:
         with YEAR_LEDGER_PATH.open(encoding="utf-8") as file:
             ledger = json.load(file)

{usage_cli-0.34.12 → usage_cli-0.34.14}/i18n.json

@@ -37,13 +37,19 @@
     "statusline_sync_menu": "狀態列同步額度",
     "statusline_sync_tooltip": "從 Claude Code 的狀態列讀取額度。關掉後，Claude 的額度就不會再更新。",
     "launch_at_login": "開機自動啟動",
+    "launch_at_login_failed": "無法設定開機自動啟動：{error}",
     "reset_panel_position": "重設面板位置",
     "hide_sections_menu": "隱藏區塊",
     "tray_provider_menu": "系統匣顯示來源",
     "quota_label_menu": "顯示工作列額度",
     "quota_label_format": "{provider}: {value}%",
     "quota_label_unknown": "{provider}: --",
+    "quota_label_countdown": "{provider}: {value}",
     "quota_notifications_menu": "用量提醒通知",
+    "quota_notifications_toggle": "開啟通知",
+    "quota_notifications_permission_denied": "系統已關閉 usage 的通知 — 打開系統設定…",
+    "quota_threshold_header": "提醒門檻",
+    "quota_threshold_item": "用到 {percent}%",
     "window_keeper_menu": "自動啟動 5 小時計時",
     "window_keeper_tooltip": "5 小時額度重置後，自動各送一則極小訊息（Claude 用 Haiku、agy 用 Gemini 3.8 Flash Low、Codex 用最省成本模型），讓下一輪 5 小時立刻開始計時（會消耗極少量額度）",
     "window_keeper_sleep_title": "🐾 自動啟動 5 小時計時已開啟",
@@ -130,8 +136,8 @@
     "grok_stale_minutes": "約 {minutes} 分鐘前",
     "grok_stale_hours": "約 {hours} 小時前",
     "grok_stale_tooltip": "資料來自 Grok CLI 本機 log，不是即時 API；請最近執行過 grok 指令後再查看，才會更新。",
-    "codex_stale_minutes": "約 {minutes} 分鐘前",
-    "codex_stale_hours": "約 {hours} 小時前",
+    "codex_stale_minutes": "約 {minutes} 分鐘前更新",
+    "codex_stale_hours": "約 {hours} 小時前更新",
     "codex_stale_tooltip": "Claude 有即時回報所以很準；Codex 沒有，usage 會讀它本機偶爾留下的紀錄，可能比實際略舊。繼續在終端機跑 Codex 就會自動更新。",
     "history_load_error_file": "讀不到使用紀錄檔",
     "history_load_error_parse": "使用紀錄格式異常",
@@ -143,7 +149,7 @@
     "project_range_7d": "7 日",
     "project_range_30d": "月",
     "project_range_all": "全部",
-    "session_label": "Session",
+    "session_label": "5 小時",
     "weekly_label": "本週",
     "monthly_label": "本月",
     "projects_empty": "無記錄",
@@ -256,12 +262,12 @@
     "report_wrapped_books_hint": "含重複的快取讀取，不等於實際產出的文字量。",
     "report_kpi_active_value": "{active} / {total} 天",
     "report_kpi_cost": "API 等值",
-    "report_kpi_cost_unpriced": "其中 {tokens} tokens 無公開價格，未計入",
+    "report_kpi_cost_unpriced": "其中 {tokens} tokens 沒有價格資料，未計入",
     "report_pricing_section": "API 價格覆蓋率（依 token 數）",
     "report_pricing_priced": "可換算 API 等值",
-    "report_pricing_unpriced": "無公開價格",
+    "report_pricing_unpriced": "沒有價格資料",
     "report_pricing_all_priced": "全部用量都有公開價格。",
-    "report_pricing_hint": "API 等值是用公開 API 價目表換算的等值金額，不是你的訂閱帳單；無公開價格的用量不計入 API 等值。 沒有公開價格不代表免費，只是無法換算。",
+    "report_pricing_hint": "API 等值是用公開 API 價目表換算的等值金額，不是你的訂閱帳單；沒有價格資料的用量不計入 API 等值，包括沒有公開價格的模型，以及只存了總量的舊紀錄。沒有價格資料不代表免費，只是無法換算。",
     "report_kpi_peak_day": "燒最兇的一天",
     "report_kpi_tokens": "燒掉 Tokens",
     "report_kpi_vs_prev_period": "較前期",
@@ -515,6 +521,7 @@
     "claude_pane_remaining": "剩",
     "claude_pane_reset_done": "已重置",
     "claude_pane_hours_ago": "{count}時前",
+    "claude_pane_updated_ago": "{ago}更新",
     "update_check_failed_offline": "連不上 GitHub，請確認網路後再試。",
     "update_check_failed_rate_limited": "GitHub 暫時拒絕請求，可能太頻繁了，稍後再試。",
     "update_check_failed_server": "GitHub 回應錯誤，稍後再試。",
@@ -610,13 +617,19 @@
     "statusline_sync_menu": "Sync quota via status line",
     "statusline_sync_tooltip": "Reads the Claude quota from Claude Code's status line. Turn it off and the Claude quota stops updating.",
     "launch_at_login": "Launch at Login",
+    "launch_at_login_failed": "Unable to set launch at login: {error}",
     "reset_panel_position": "Reset panel position",
     "hide_sections_menu": "Hide Sections",
     "tray_provider_menu": "Tray Display Source",
     "quota_label_menu": "Show Taskbar Quota",
     "quota_label_format": "{provider}: {value}%",
     "quota_label_unknown": "{provider}: --",
+    "quota_label_countdown": "{provider}: {value}",
     "quota_notifications_menu": "Usage Alert Notifications",
+    "quota_notifications_toggle": "Enable notifications",
+    "quota_notifications_permission_denied": "System notifications for usage are off — Open System Settings…",
+    "quota_threshold_header": "Alert thresholds",
+    "quota_threshold_item": "At {percent}%",
     "window_keeper_menu": "Auto-start 5-hour Session",
     "window_keeper_tooltip": "After your 5-hour quotas reset, automatically send one tiny message to each tool (Claude with Haiku, agy with Gemini 3.8 Flash Low, Codex with its cheapest model) so the next 5-hour sessions start counting right away (uses a tiny bit of quota).",
     "window_keeper_sleep_title": "🐾 Auto-start 5-hour Session is on",
@@ -703,8 +716,8 @@
     "grok_stale_minutes": "about {minutes} minutes ago",
     "grok_stale_hours": "about {hours} hours ago",
     "grok_stale_tooltip": "Data comes from Grok CLI's local log, not a live API. Run a grok command recently for it to update.",
-    "codex_stale_minutes": "about {minutes} minutes ago",
-    "codex_stale_hours": "about {hours} hours ago",
+    "codex_stale_minutes": "updated about {minutes} min ago",
+    "codex_stale_hours": "updated about {hours} hr ago",
     "codex_stale_tooltip": "Claude is accurate because it reports in real time; Codex does not, so usage reads the local records it leaves occasionally, which may be slightly older than reality. Keep running Codex in the terminal and it will update automatically.",
     "history_load_error_file": "Couldn't read usage files",
     "history_load_error_parse": "Usage data format issue",
@@ -829,12 +842,12 @@
     "report_wrapped_books_hint": "Includes repeated cache reads; this is not the amount of text actually generated.",
     "report_kpi_active_value": "{active} / {total} days",
     "report_kpi_cost": "API equivalent",
-    "report_kpi_cost_unpriced": "Includes {tokens} tokens without public pricing, excluded from the API equivalent",
+    "report_kpi_cost_unpriced": "Includes {tokens} tokens without pricing data, excluded from the API equivalent",
     "report_pricing_section": "API pricing coverage (by token count)",
     "report_pricing_priced": "Convertible to API equivalent",
-    "report_pricing_unpriced": "No public price",
+    "report_pricing_unpriced": "No pricing data",
     "report_pricing_all_priced": "All usage has a public price.",
-    "report_pricing_hint": "API equivalent is the API-equivalent value from public price lists, not your subscription bill. Usage without a public price is left out of API equivalent. No public price does not mean free; the API equivalent cannot be calculated.",
+    "report_pricing_hint": "API equivalent is the API-equivalent value from public price lists, not your subscription bill. Usage without pricing data is left out of API equivalent: models with no public price, and older records that kept only totals. Missing pricing data does not mean free; the API equivalent cannot be calculated.",
     "report_kpi_peak_day": "Peak Day",
     "report_kpi_tokens": "Burned Tokens",
     "report_kpi_vs_prev_period": "vs previous period",
@@ -1088,6 +1101,7 @@
     "claude_pane_remaining": "left",
     "claude_pane_reset_done": "Reset",
     "claude_pane_hours_ago": "{count}h ago",
+    "claude_pane_updated_ago": "updated {ago}",
     "update_check_failed_offline": "Cannot reach GitHub. Check your connection and try again.",
     "update_check_failed_rate_limited": "GitHub is limiting requests. Try again later.",
     "update_check_failed_server": "GitHub returned an error. Try again later.",
@@ -1183,13 +1197,19 @@
     "statusline_sync_menu": "状态栏同步额度",
     "statusline_sync_tooltip": "从 Claude Code 的状态栏读取额度。关闭后，Claude 的额度就不会再更新。",
     "launch_at_login": "开机自动启动",
+    "launch_at_login_failed": "无法设置开机自动启动：{error}",
     "reset_panel_position": "重设面板位置",
     "hide_sections_menu": "隐藏区块",
     "tray_provider_menu": "托盘显示来源",
     "quota_label_menu": "显示任务栏额度",
     "quota_label_format": "{provider}: {value}%",
     "quota_label_unknown": "{provider}: --",
+    "quota_label_countdown": "{provider}: {value}",
     "quota_notifications_menu": "用量提醒通知",
+    "quota_notifications_toggle": "开启通知",
+    "quota_notifications_permission_denied": "系统已关闭 usage 的通知 — 打开系统设置…",
+    "quota_threshold_header": "提醒阈值",
+    "quota_threshold_item": "用到 {percent}%",
     "window_keeper_menu": "自动启动 5 小时计时",
     "window_keeper_tooltip": "5 小时额度重置后，自动各发送一则极小消息（Claude 用 Haiku、agy 用 Gemini 3.8 Flash Low、Codex 用最省成本模型），让下一轮 5 小时立刻开始计时（会消耗极少量额度）",
     "window_keeper_sleep_title": "🐾 已开启自动启动 5 小时计时",
@@ -1276,8 +1296,8 @@
     "grok_stale_minutes": "约 {minutes} 分钟前",
     "grok_stale_hours": "约 {hours} 小时前",
     "grok_stale_tooltip": "资料来自 Grok CLI 本地日志，不是即时 API；请最近运行过 grok 指令后再查看，才会更新。",
-    "codex_stale_minutes": "约 {minutes} 分钟前",
-    "codex_stale_hours": "约 {hours} 小时前",
+    "codex_stale_minutes": "约 {minutes} 分钟前更新",
+    "codex_stale_hours": "约 {hours} 小时前更新",
     "codex_stale_tooltip": "Claude 有实时回报所以很准；Codex 没有，usage 会读取它本机偶尔留下的记录，可能比实际略旧。继续在终端运行 Codex 就会自动更新。",
     "history_load_error_file": "读不到使用记录文件",
     "history_load_error_parse": "使用记录格式异常",
@@ -1289,7 +1309,7 @@
     "project_range_7d": "7 日",
     "project_range_30d": "月",
     "project_range_all": "全部",
-    "session_label": "Session",
+    "session_label": "5 小时",
     "weekly_label": "本周",
     "monthly_label": "本月",
     "projects_empty": "无记录",
@@ -1402,12 +1422,12 @@
     "report_wrapped_books_hint": "含重复的缓存读取，不等于实际生成的文字量。",
     "report_kpi_active_value": "{active} / {total} 天",
     "report_kpi_cost": "API 等值",
-    "report_kpi_cost_unpriced": "其中 {tokens} tokens 无公开价格，未计入",
+    "report_kpi_cost_unpriced": "其中 {tokens} tokens 没有价格数据，未计入",
     "report_pricing_section": "API 价格覆盖率（按 token 数）",
     "report_pricing_priced": "可换算 API 等值",
-    "report_pricing_unpriced": "无公开价格",
+    "report_pricing_unpriced": "没有价格数据",
     "report_pricing_all_priced": "全部用量都有公开价格。",
-    "report_pricing_hint": "API 等值是用公开 API 价目表换算的等值金额，不是你的订阅账单；无公开价格的用量不计入 API 等值。 没有公开价格不代表免费，只是无法换算。",
+    "report_pricing_hint": "API 等值是用公开 API 价目表换算的等值金额，不是你的订阅账单；没有价格数据的用量不计入 API 等值，包括没有公开价格的模型，以及只存了总量的旧记录。没有价格数据不代表免费，只是无法换算。",
     "report_kpi_peak_day": "烧最猛的一天",
     "report_kpi_tokens": "烧掉 Tokens",
     "report_kpi_vs_prev_period": "较前期",
@@ -1661,6 +1681,7 @@
     "claude_pane_remaining": "剩",
     "claude_pane_reset_done": "已重置",
     "claude_pane_hours_ago": "{count}时前",
+    "claude_pane_updated_ago": "{ago}更新",
     "update_check_failed_offline": "连不上 GitHub，请确认网络后再试。",
     "update_check_failed_rate_limited": "GitHub 暂时拒绝请求，可能太频繁了，稍后再试。",
     "update_check_failed_server": "GitHub 响应错误，稍后再试。",
@@ -1756,13 +1777,19 @@
     "statusline_sync_menu": "ステータスラインで使用量を同期",
     "statusline_sync_tooltip": "Claude Code のステータスラインから使用量を読み取ります。オフにすると Claude の使用量は更新されなくなります。",
     "launch_at_login": "ログイン時に起動",
+    "launch_at_login_failed": "ログイン時の起動を設定できません：{error}",
     "reset_panel_position": "パネルの位置をリセット",
     "hide_sections_menu": "セクションを非表示",
     "tray_provider_menu": "トレイの表示元",
     "quota_label_menu": "タスクバーにクォータを表示",
     "quota_label_format": "{provider}: {value}%",
     "quota_label_unknown": "{provider}: --",
+    "quota_label_countdown": "{provider}: {value}",
     "quota_notifications_menu": "使用量アラート通知",
+    "quota_notifications_toggle": "通知を有効にする",
+    "quota_notifications_permission_denied": "usage の通知はシステムで無効です — システム設定を開く…",
+    "quota_threshold_header": "通知のしきい値",
+    "quota_threshold_item": "使用量 {percent}%",
     "window_keeper_menu": "5 時間セッションを自動開始",
     "window_keeper_tooltip": "5 時間枠のリセット後、各ツールにごく小さなメッセージを自動送信します（Claude は Haiku、agy は Gemini 3.8 Flash Low、Codex は最も低コストなモデル）。次の 5 時間のカウントをすぐに開始します（ごくわずかな枠を消費します）。",
     "window_keeper_sleep_title": "🐾 5 時間セッションの自動開始をオンにしました",
@@ -1849,8 +1876,8 @@
     "grok_stale_minutes": "約 {minutes} 分前",
     "grok_stale_hours": "約 {hours} 時間前",
     "grok_stale_tooltip": "データは Grok CLI のローカルログから読み取るもので、リアルタイム API ではありません。更新するには最近 grok コマンドを実行してください。",
-    "codex_stale_minutes": "約 {minutes} 分前",
-    "codex_stale_hours": "約 {hours} 時間前",
+    "codex_stale_minutes": "約 {minutes} 分前に更新",
+    "codex_stale_hours": "約 {hours} 時間前に更新",
     "codex_stale_tooltip": "Claude はリアルタイムに報告するので正確です。Codex にはそれがないため、usage は Codex がローカルに時々残す記録を読み取り、実際より少し古い場合があります。ターミナルで Codex を使い続けると自動的に更新されます。",
     "history_load_error_file": "使用履歴ファイルを読み込めません",
     "history_load_error_parse": "使用履歴データの形式に問題があります",
@@ -1862,7 +1889,7 @@
     "project_range_7d": "7日間",
     "project_range_30d": "月",
     "project_range_all": "全期間",
-    "session_label": "セッション",
+    "session_label": "5時間",
     "weekly_label": "週間",
     "monthly_label": "月間",
     "projects_empty": "記録なし",
@@ -1975,12 +2002,12 @@
     "report_wrapped_books_hint": "繰り返しのキャッシュ読み込みを含むため、実際に生成した文章量とは異なります。",
     "report_kpi_active_value": "{active} / {total} 日",
     "report_kpi_cost": "API 換算",
-    "report_kpi_cost_unpriced": "うち {tokens} tokens は公開価格がなく、API 換算に含みません",
+    "report_kpi_cost_unpriced": "うち {tokens} tokens は価格データがなく、API 換算に含みません",
     "report_pricing_section": "API 価格カバー率（トークン数ベース）",
     "report_pricing_priced": "API 相当額に換算可能",
-    "report_pricing_unpriced": "公開価格なし",
+    "report_pricing_unpriced": "価格データなし",
     "report_pricing_all_priced": "すべての使用量に公開価格があります。",
-    "report_pricing_hint": "API 換算は公開 API 価格表で換算した相当額で、サブスクリプションの請求額ではありません。公開価格のない使用量はAPI 換算に含まれません。 公開価格がないことは無料を意味しません。API 相当額に換算できないだけです。",
+    "report_pricing_hint": "API 換算は公開 API 価格表で換算した相当額で、サブスクリプションの請求額ではありません。価格データのない使用量（公開価格のないモデルや、合計だけが残っている古い記録）は API 換算に含まれません。価格データがないことは無料を意味しません。API 相当額に換算できないだけです。",
     "report_kpi_peak_day": "最も使った日",
     "report_kpi_tokens": "使った Tokens",
     "report_kpi_vs_prev_period": "前期比",
@@ -2234,6 +2261,7 @@
     "claude_pane_remaining": "残り",
     "claude_pane_reset_done": "リセット済み",
     "claude_pane_hours_ago": "{count}時間前",
+    "claude_pane_updated_ago": "{ago}に更新",
     "update_check_failed_offline": "GitHub に接続できません。ネット接続を確認して再試行してください。",
     "update_check_failed_rate_limited": "GitHub がリクエストを制限しています。後でもう一度お試しください。",
     "update_check_failed_server": "GitHub でエラーが発生しました。後でもう一度お試しください。",
@@ -2329,13 +2357,19 @@
     "statusline_sync_menu": "상태 표시줄로 사용량 동기화",
     "statusline_sync_tooltip": "Claude Code 상태 표시줄에서 사용량을 읽습니다. 끄면 Claude 사용량이 더 이상 업데이트되지 않습니다.",
     "launch_at_login": "로그인 시 시작",
+    "launch_at_login_failed": "로그인 시 시작을 설정할 수 없습니다: {error}",
     "reset_panel_position": "패널 위치 재설정",
     "hide_sections_menu": "섹션 숨기기",
     "tray_provider_menu": "트레이 표시 소스",
     "quota_label_menu": "작업 표시줄 할당량 표시",
     "quota_label_format": "{provider}: {value}%",
     "quota_label_unknown": "{provider}: --",
+    "quota_label_countdown": "{provider}: {value}",
     "quota_notifications_menu": "사용량 알림",
+    "quota_notifications_toggle": "알림 켜기",
+    "quota_notifications_permission_denied": "시스템에서 usage 알림이 꺼져 있습니다 — 시스템 설정 열기…",
+    "quota_threshold_header": "알림 기준",
+    "quota_threshold_item": "사용량 {percent}%",
     "window_keeper_menu": "5시간 세션 자동 시작",
     "window_keeper_tooltip": "5시간 할당량이 리셋되면 각 도구에 아주 작은 메시지를 자동 전송합니다 (Claude는 Haiku, agy는 Gemini 3.8 Flash Low, Codex는 가장 저렴한 모델). 다음 5시간 카운트를 바로 시작합니다 (극소량의 할당량을 소모합니다).",
     "window_keeper_sleep_title": "🐾 5시간 세션 자동 시작이 켜졌어요",
@@ -2422,8 +2456,8 @@
     "grok_stale_minutes": "약 {minutes}분 전",
     "grok_stale_hours": "약 {hours}시간 전",
     "grok_stale_tooltip": "데이터는 Grok CLI의 로컬 로그에서 읽으며 실시간 API가 아닙니다. 업데이트하려면 최근에 grok 명령을 실행하세요.",
-    "codex_stale_minutes": "약 {minutes}분 전",
-    "codex_stale_hours": "약 {hours}시간 전",
+    "codex_stale_minutes": "약 {minutes}분 전 업데이트",
+    "codex_stale_hours": "약 {hours}시간 전 업데이트",
     "codex_stale_tooltip": "Claude는 실시간으로 보고하므로 정확합니다. Codex는 그렇지 않아 usage가 Codex가 로컬에 가끔 남기는 기록을 읽으며, 실제보다 조금 오래된 값일 수 있습니다. 터미널에서 Codex를 계속 실행하면 자동으로 업데이트됩니다.",
     "history_load_error_file": "사용 기록 파일을 읽을 수 없습니다",
     "history_load_error_parse": "사용 기록 형식에 문제가 있습니다",
@@ -2435,7 +2469,7 @@
     "project_range_7d": "7일",
     "project_range_30d": "월",
     "project_range_all": "전체",
-    "session_label": "세션",
+    "session_label": "5시간",
     "weekly_label": "주간",
     "monthly_label": "월간",
     "projects_empty": "기록 없음",
@@ -2548,12 +2582,12 @@
     "report_wrapped_books_hint": "반복된 캐시 읽기를 포함하므로 실제로 생성한 글의 양과는 다릅니다.",
     "report_kpi_active_value": "{active} / {total}일",
     "report_kpi_cost": "API 환산",
-    "report_kpi_cost_unpriced": "이 중 {tokens} tokens는 공개 가격이 없어 API 환산에서 제외됨",
+    "report_kpi_cost_unpriced": "이 중 {tokens} tokens는 가격 데이터가 없어 API 환산에서 제외됨",
     "report_pricing_section": "API 가격 적용률 (토큰 수 기준)",
     "report_pricing_priced": "API 환산액 계산 가능",
-    "report_pricing_unpriced": "공개 가격 없음",
+    "report_pricing_unpriced": "가격 데이터 없음",
     "report_pricing_all_priced": "모든 사용량에 공개 가격이 있습니다.",
-    "report_pricing_hint": "API 환산은 공개 API 가격표로 환산한 금액이며 구독 청구액이 아닙니다. 공개 가격이 없는 사용량은 API 환산에서 제외됩니다. 공개 가격이 없다고 무료인 것은 아닙니다. API 환산액을 계산할 수 없다는 뜻입니다.",
+    "report_pricing_hint": "API 환산은 공개 API 가격표로 환산한 금액이며 구독 청구액이 아닙니다. 가격 데이터가 없는 사용량(공개 가격이 없는 모델, 합계만 남은 이전 기록)은 API 환산에서 제외됩니다. 가격 데이터가 없다고 무료인 것은 아닙니다. API 환산액을 계산할 수 없다는 뜻입니다.",
     "report_kpi_peak_day": "가장 많이 쓴 날",
     "report_kpi_tokens": "쓴 Tokens",
     "report_kpi_vs_prev_period": "이전 기간 대비",
@@ -2807,6 +2841,7 @@
     "claude_pane_remaining": "남음",
     "claude_pane_reset_done": "리셋됨",
     "claude_pane_hours_ago": "{count}시간 전",
+    "claude_pane_updated_ago": "{ago} 업데이트",
     "update_check_failed_offline": "GitHub에 연결할 수 없어요. 인터넷 연결을 확인하고 다시 시도하세요.",
     "update_check_failed_rate_limited": "GitHub가 요청을 제한하고 있어요. 잠시 후 다시 시도하세요.",
     "update_check_failed_server": "GitHub에서 오류가 발생했어요. 잠시 후 다시 시도하세요.",

{usage_cli-0.34.12 → usage_cli-0.34.14}/installer/login_item.py

@@ -113,14 +113,15 @@ def _launchctl_bootstrap() -> None:
         )
     except FileNotFoundError as exc:
         _log_launchctl_error("bootstrap", str(exc))
-        return
+        raise
     except subprocess.TimeoutExpired as exc:
         _log_launchctl_error("bootstrap", f"timed out after {exc.timeout} seconds")
-        return
+        raise
 
     if result.returncode not in (0, 17):
         stderr = _stderr_summary(result.stderr)
         _log_launchctl_error("bootstrap", f"returncode={result.returncode} stderr={stderr!r}")
+        raise RuntimeError(stderr or f"launchctl: {result.returncode}")
 
 
 def enable() -> None:

{usage_cli-0.34.12 → usage_cli-0.34.14}/installer/session_hooks.py

@@ -60,7 +60,7 @@ CODEX_CONFIG = setup_hook.CODEX_CONFIG
 # session. Off by default: enabled only via the menu toggle, never by self_heal.
 RESUME_HOOK_TARGET = Path(os.path.expanduser("~/.claude/usage-session-resume.py"))
 RESUME_PROMPT_SIDECAR = Path(os.path.expanduser("~/.claude/usage-resume-prompt.json"))
-RESUME_HOOK_VERSION = "1.12"
+RESUME_HOOK_VERSION = "1.13"
 RESUME_MATCHER = "startup|clear|resume"
 RESUME_LANGS = ("zh-TW", "zh-CN", "en", "ja", "ko")
 _RESUME_MARKER = "usage-session-resume"
@@ -95,7 +95,7 @@ _TERSE_REMINDER_MARKER = "usage-terse-reminder"
 _TERSE_REMINDER_MARKERS = (_TERSE_REMINDER_MARKER, "usage_terse_reminder")
 # Independent, opt-in Claude Code UserPromptSubmit hook.
 QUOTA_AWARE_HOOK_TARGET = Path(os.path.expanduser("~/.claude/usage-quota-aware.py"))
-QUOTA_AWARE_HOOK_VERSION = "1.3"
+QUOTA_AWARE_HOOK_VERSION = "1.5"
 QUOTA_AWARE_MATCHER = ""
 _QUOTA_AWARE_MARKER = "usage-quota-aware"
 _QUOTA_AWARE_MARKERS = (_QUOTA_AWARE_MARKER, "usage_quota_aware")
@@ -622,7 +622,9 @@ def _self_heal_codex_terse() -> None:
     script_missing = not CODEX_TERSE_HOOK_TARGET.exists()
     entry_missing = not _is_codex_terse_installed()
     old_version = _installed_codex_terse_version()
-    version_stale = CODEX_TERSE_HOOK_TARGET.exists() and old_version != TERSE_HOOK_VERSION
+    version_stale = CODEX_TERSE_HOOK_TARGET.exists() and setup_hook.is_older(
+        old_version, TERSE_HOOK_VERSION
+    )
 
     if not (script_missing or entry_missing or version_stale or not hooks_enabled):
         return
@@ -859,7 +861,7 @@ def _self_heal_resume() -> None:
         _copy_resume_script()
         _write_resume_sidecar()
         _append_self_heal_log("restore_resume_hook", detail)
-    elif _installed_resume_version() != RESUME_HOOK_VERSION:
+    elif setup_hook.is_older(_installed_resume_version(), RESUME_HOOK_VERSION):
         old = _installed_resume_version()
         _copy_resume_script()
         _write_resume_sidecar()
@@ -896,7 +898,7 @@ def _self_heal_terse_mode() -> None:
         _append_self_heal_log("restore_terse_hook", f"missing={','.join(missing)}")
     else:
         old = _installed_terse_version()
-        if old != TERSE_HOOK_VERSION:
+        if setup_hook.is_older(old, TERSE_HOOK_VERSION):
             _copy_terse_script()
             _write_terse_sidecar()
             _append_self_heal_log(
@@ -926,7 +928,7 @@ def _self_heal_terse_reminder() -> None:
         _append_self_heal_log("restore_terse_reminder_hook", f"missing={','.join(parts)}")
         return
     old = _installed_terse_reminder_version()
-    if old != TERSE_REMINDER_HOOK_VERSION:
+    if setup_hook.is_older(old, TERSE_REMINDER_HOOK_VERSION):
         _copy_terse_reminder_script()
         _append_self_heal_log(
             "update_terse_reminder_hook",
@@ -1149,8 +1151,8 @@ def _debug_self_heal_failure(action: str, exc: BaseException) -> None:
         print(f"usage self-heal {action} failed: {type(exc).__name__}: {exc}", file=sys.stderr)
 
 
-def self_heal() -> None:
-    """Best-effort startup repair for usage-owned Claude statusLine hooks."""
+def _self_heal_statuslines() -> None:
+    """Best-effort startup repair for usage-owned status lines."""
     try:
         settings = _load_settings()
         state = _detect_current_state(settings)
@@ -1261,6 +1263,11 @@ def self_heal() -> None:
             raise
         _debug_self_heal_failure("setup_codex", exc)
 
+
+def self_heal() -> None:
+    """Repair status lines and independently repair opt-in session hooks."""
+    _self_heal_statuslines()
+
     try:
         _self_heal_resume()
     except BaseException as exc:
@@ -1379,7 +1386,7 @@ def _self_heal_quota_aware() -> None:
     if not is_quota_aware_enabled():
         return
     old = _installed_quota_aware_version()
-    if old != QUOTA_AWARE_HOOK_VERSION:
+    if setup_hook.is_older(old, QUOTA_AWARE_HOOK_VERSION):
         _copy_quota_aware_script()
         _append_self_heal_log(
             "update_quota_aware_hook", f"{old or 'unknown'} -> {QUOTA_AWARE_HOOK_VERSION}"

{usage_cli-0.34.12 → usage_cli-0.34.14}/installer/setup_hook.py

@@ -86,7 +86,7 @@ PREV_SL_KEY = "previousStatusLine"
 # Where the status-line switch parks the live statusLine while it is off, so it
 # never overwrites the pre-install backup under PREV_SL_KEY.
 DISABLED_SL_KEY = "disabledStatusLine"
-HOOK_VERSION = "1.17"
+HOOK_VERSION = "1.18"
 FORWARDER_VERSION = "1.1"
 # Antigravity's Go runner hands its status-line command to cmd.exe unquoted, so
 # every character cmd.exe treats specially has to be kept out of the path.
@@ -1231,16 +1231,30 @@ def _installed_forwarder_version() -> str | None:
     return None
 
 
+def is_older(installed: str | None, current: str) -> bool:
+    """True when an installed hook should be replaced: missing, unreadable, or older.
+
+    Never downgrade: an older usage build would otherwise swap back a hook that a newer
+    build installed, and the two would keep replacing each other on every self-heal.
+    """
+    if installed is None:
+        return True
+    try:
+        return tuple(map(int, installed.split("."))) < tuple(map(int, current.split(".")))
+    except ValueError:
+        return True
+
+
 def needs_update() -> bool:
     if not HOOK_TARGET.parent.exists():
         return False
-    return _installed_hook_version() != HOOK_VERSION
+    return is_older(_installed_hook_version(), HOOK_VERSION)
 
 
 def forwarder_needs_update() -> bool:
     if not FORWARDER_TARGET.exists():
         return False
-    return _installed_forwarder_version() != FORWARDER_VERSION
+    return is_older(_installed_forwarder_version(), FORWARDER_VERSION)
 
 
 def update_hook() -> None:

{usage_cli-0.34.12 → usage_cli-0.34.14}/installer/statusline_settings.py

@@ -110,7 +110,8 @@ def _disable_statusline_settings() -> int:
     _sync_agy_statusline(False)
     _sync_grok_statusline(False)
     settings = _load_claude_settings()
-    if "statusLine" not in settings:
+    # The switch can be on for agy alone; a user's own Claude status line is not ours to stash.
+    if "statusLine" not in settings or setup_hook._detect_current_state(settings) == "external":
         return 0
     usage_settings = settings.setdefault("usage", {})
     if not isinstance(usage_settings, dict):
@@ -129,7 +130,9 @@ def _enable_statusline_settings() -> int:
     _sync_grok_statusline(True)
     settings = _load_claude_settings()
     if "statusLine" in settings:
-        return 0
+        if setup_hook._detect_current_state(settings) in {"us-direct", "us-forwarder"}:
+            return 0
+        return setup_hook.setup()
     raw_usage_settings = settings.get("usage")
     usage_settings = raw_usage_settings if isinstance(raw_usage_settings, dict) else None
     # Older versions parked the switch's statusLine under previousStatusLine.
@@ -169,7 +172,9 @@ def _statusline_enabled() -> bool:
         settings = _load_claude_settings()
     except (OSError, ValueError, json.JSONDecodeError):
         return False
-    if "statusLine" in settings:
+    from installer import setup_hook
+
+    if setup_hook._detect_current_state(settings) in {"us-direct", "us-forwarder"}:
         return True
     if sys.platform not in {"darwin", "win32"}:
         return False