cc-costline 0.2.4 → 0.3.1

package/README.es.md

@@ -23,7 +23,7 @@ Abre una nueva sesión de Claude Code y verás la statusline mejorada. Requiere
 | Segmento | Ejemplo | Descripción |
 |----------|---------|-------------|
 | Tokens ~ Costo / Contexto | `14.6k ~ $2.42 / 40% by Opus 4.6` | Tokens de la sesión, costo, uso de contexto y modelo |
-| Límites de uso | `5h: 45% / 7d: 8%` | Utilización de Claude a 5 horas y 7 días (coloreado como el contexto) |
+| Límites de uso | `5h: 45% / 7d: 8%` | Utilización de Claude a 5 horas y 7 días (coloreado como el contexto). Al 100%, muestra cuenta regresiva: `5h:-3:20` |
 | Costo del período | `30d: $866` | Costo acumulado (configurable: 7d o 30d) |
 | Ranking | `#2/22 $67.0` | Posición en [ccclub](https://github.com/mazzzystar/ccclub) (si está instalado) |
 
@@ -77,6 +77,12 @@ Los modelos desconocidos usan el precio de su familia, Sonnet por defecto.
 
 </details>
 
+## Desarrollo
+
+```bash
+npm test    # Build + ejecutar tests unitarios (node:test, sin dependencias)
+```
+
 ## Desinstalación
 
 ```bash

package/README.fr.md

@@ -23,7 +23,7 @@ Ouvrez une nouvelle session Claude Code et la statusline enrichie apparaîtra. N
 | Segment | Exemple | Description |
 |---------|---------|-------------|
 | Tokens ~ Coût / Contexte | `14.6k ~ $2.42 / 40% by Opus 4.6` | Nombre de tokens, coût, utilisation du contexte et modèle |
-| Limites d'utilisation | `5h: 45% / 7d: 8%` | Utilisation Claude sur 5 heures et 7 jours (colorée comme le contexte) |
+| Limites d'utilisation | `5h: 45% / 7d: 8%` | Utilisation Claude sur 5 heures et 7 jours (colorée comme le contexte). À 100 %, affiche un compte à rebours : `5h:-3:20` |
 | Coût périodique | `30d: $866` | Coût cumulé glissant (configurable : 7j ou 30j) |
 | Classement | `#2/22 $67.0` | Rang [ccclub](https://github.com/mazzzystar/ccclub) (si installé) |
 
@@ -77,6 +77,12 @@ Les modèles inconnus utilisent le prix de leur famille, Sonnet par défaut.
 
 </details>
 
+## Développement
+
+```bash
+npm test    # Build + exécuter les tests unitaires (node:test, zéro dépendance)
+```
+
 ## Désinstallation
 
 ```bash

package/README.ja.md

@@ -23,7 +23,7 @@ npm i -g cc-costline && cc-costline install
 | セグメント | 例 | 説明 |
 |-----------|---|------|
 | トークン ~ コスト / コンテキスト | `14.6k ~ $2.42 / 40% by Opus 4.6` | セッションのトークン数、コスト、コンテキスト使用率、モデル |
-| 使用制限 | `5h: 45% / 7d: 8%` | Claude の 5 時間・7 日間の使用率（コンテキストと同じ色分け） |
+| 使用制限 | `5h: 45% / 7d: 8%` | Claude の 5 時間・7 日間の使用率（コンテキストと同じ色分け）。100% 到達時はカウントダウン表示：`5h:-3:20` |
 | 期間コスト | `30d: $866` | ローリングコスト合計（7d または 30d で設定可能） |
 | リーダーボード | `#2/22 $67.0` | [ccclub](https://github.com/mazzzystar/ccclub) ランキング（インストール時） |
 
@@ -77,6 +77,12 @@ cc-costline config --period 7d   # 7 日間のコストを表示
 
 </details>
 
+## 開発
+
+```bash
+npm test    # ビルド + ユニットテスト実行（node:test、依存関係なし）
+```
+
 ## アンインストール
 
 ```bash

package/README.md

@@ -23,7 +23,7 @@ Open a new Claude Code session and you'll see the enhanced statusline. Requires
 | Segment | Example | Description |
 |---------|---------|-------------|
 | Tokens ~ Cost / Context | `14.6k ~ $2.42 / 40% by Opus 4.6` | Session token count, cost, context usage, and model |
-| Usage limits | `5h: 45% / 7d: 8%` | Claude 5-hour and 7-day utilization (auto-colored like context) |
+| Usage limits | `5h: 45% / 7d: 8%` | Claude 5-hour and 7-day utilization (auto-colored like context). At 100%, shows countdown: `5h:-3:20` |
 | Period cost | `30d: $866` | Rolling cost total (configurable: 7d or 30d) |
 | Leaderboard | `#2/22 $67.0` | [ccclub](https://github.com/mazzzystar/ccclub) rank (if installed) |
 
@@ -77,6 +77,12 @@ Unknown models fall back by family name, defaulting to Sonnet pricing.
 
 </details>
 
+## Development
+
+```bash
+npm test    # Build + run unit tests (node:test, zero dependencies)
+```
+
 ## Uninstall
 
 ```bash

package/README.zh-CN.md

@@ -23,7 +23,7 @@ npm i -g cc-costline && cc-costline install
 | 模块 | 示例 | 说明 |
 |------|------|------|
 | Token ~ 费用 / 上下文 | `14.6k ~ $2.42 / 40% by Opus 4.6` | 会话 token 数量、费用、上下文使用率和模型 |
-| 使用限额 | `5h: 45% / 7d: 8%` | Claude 5 小时和 7 天使用率（颜色同上下文） |
+| 使用限额 | `5h: 45% / 7d: 8%` | Claude 5 小时和 7 天使用率（颜色同上下文）。达到 100% 时显示倒计时：`5h:-3:20` |
 | 周期费用 | `30d: $866` | 滚动费用合计（可配置：7d 或 30d） |
 | 排行榜 | `#2/22 $67.0` | [ccclub](https://github.com/mazzzystar/ccclub) 排名（需安装） |
 
@@ -77,6 +77,12 @@ cc-costline config --period 7d   # 显示 7 天费用
 
 </details>
 
+## 开发
+
+```bash
+npm test    # 构建 + 运行单元测试（node:test，零依赖）
+```
+
 ## 卸载
 
 ```bash

package/dist/statusline.d.ts

@@ -1 +1,6 @@
+export declare function formatTokens(t: number): string;
+export declare function formatCost(n: number): string;
+export declare function ctxColor(pct: number): string;
+export declare function formatCountdown(resetsAtMs: number): string;
+export declare function rankColor(rank: number): string;
 export declare function render(input: string): string;

package/dist/statusline.js

@@ -1,4 +1,4 @@
-import { readFileSync, existsSync, statSync, writeFileSync } from "node:fs";
+import { readFileSync, existsSync, writeFileSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { execSync } from "node:child_process";
@@ -14,14 +14,14 @@ const FG_MODEL = "\x1b[38;2;202;124;94m";
 const FG_CYAN = "\x1b[38;5;109m";
 const FG_WHITE = "\x1b[38;5;255m";
 const RESET = "\x1b[0m";
-function formatTokens(t) {
+export function formatTokens(t) {
     if (t >= 1_000_000)
         return (t / 1_000_000).toFixed(1) + "M";
     if (t >= 1_000)
         return (t / 1_000).toFixed(1) + "k";
     return String(t);
 }
-function formatCost(n) {
+export function formatCost(n) {
     if (n >= 1000)
         return "$" + Math.round(n).toLocaleString("en-US");
     if (n >= 100)
@@ -30,54 +30,63 @@ function formatCost(n) {
         return "$" + n.toFixed(1);
     return "$" + n.toFixed(2);
 }
-function ctxColor(pct) {
+export function ctxColor(pct) {
     if (pct >= 80)
         return FG_RED;
     if (pct >= 60)
         return FG_ORANGE;
     return FG_GREEN;
 }
-// ccclub rank fetcher with 120s file cache
-function getCcclubRank() {
+export function formatCountdown(resetsAtMs) {
+    const remainingMs = resetsAtMs - Date.now();
+    if (remainingMs <= 0)
+        return "~0:00";
+    const totalMinutes = Math.ceil(remainingMs / 60000);
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    return `-${hours}:${String(minutes).padStart(2, "0")}`;
+}
+// ccclub rank fetcher — cached per session (stale fallback on failure)
+function getCcclubRank(sessionId) {
     const configPath = join(homedir(), ".ccclub", "config.json");
     if (!existsSync(configPath))
         return null;
     const cacheFile = "/tmp/sl-ccclub-rank";
-    const now = Date.now() / 1000;
+    let staleData = null;
     if (existsSync(cacheFile)) {
-        const mtime = statSync(cacheFile).mtimeMs / 1000;
-        if (now - mtime <= 120) {
-            try {
-                return JSON.parse(readFileSync(cacheFile, "utf-8"));
-            }
-            catch { }
+        try {
+            const cached = JSON.parse(readFileSync(cacheFile, "utf-8"));
+            staleData = cached.data ?? null;
+            if (cached.sessionId === sessionId)
+                return staleData;
         }
+        catch { }
     }
     try {
         const config = JSON.parse(readFileSync(configPath, "utf-8"));
         const code = config.groups?.[0];
         const userId = config.userId;
         if (!code || !userId)
-            return null;
+            return staleData;
         const tz = -(new Date()).getTimezoneOffset();
         const url = `${config.apiUrl}/api/rank/${code}?period=today&tz=${tz}`;
         const response = execSync(`curl -sf "${url}"`, { encoding: "utf-8", timeout: 5000 });
         if (!response)
-            return null;
+            return staleData;
         const data = JSON.parse(response);
         const rankings = data.rankings || [];
         const me = rankings.find((r) => r.userId === userId);
         if (!me)
-            return null;
+            return staleData;
         const result = { rank: me.rank, total: rankings.length, cost: me.costUSD };
-        writeFileSync(cacheFile, JSON.stringify(result), "utf-8");
+        writeFileSync(cacheFile, JSON.stringify({ sessionId, data: result }), "utf-8");
         return result;
     }
     catch {
-        return null;
+        return staleData;
     }
 }
-function rankColor(rank) {
+export function rankColor(rank) {
     if (rank === 1)
         return FG_YELLOW;
     if (rank === 2)
@@ -86,18 +95,20 @@ function rankColor(rank) {
         return FG_ORANGE;
     return FG_CYAN;
 }
-// Claude usage fetcher with 60s file cache
-function getClaudeUsage() {
+// Claude usage fetcher — cached per session (stale fallback on failure)
+function getClaudeUsage(sessionId) {
     const cacheFile = "/tmp/sl-claude-usage";
-    const now = Date.now() / 1000;
+    const hitFile = "/tmp/sl-claude-usage-hit";
+    const now = Date.now();
+    let staleData = null;
     if (existsSync(cacheFile)) {
-        const mtime = statSync(cacheFile).mtimeMs / 1000;
-        if (now - mtime <= 60) {
-            try {
-                return JSON.parse(readFileSync(cacheFile, "utf-8"));
-            }
-            catch { }
+        try {
+            const cached = JSON.parse(readFileSync(cacheFile, "utf-8"));
+            staleData = cached.data ?? null;
+            if (cached.sessionId === sessionId)
+                return staleData;
         }
+        catch { }
     }
     try {
         const username = process.env.USER || process.env.USERNAME;
@@ -125,12 +136,47 @@ function getClaudeUsage() {
                 return Math.round(parseFloat(val.replace("%", "")));
             return 0;
         };
-        const result = { fiveHour: parseUtil(data.five_hour?.utilization), sevenDay: parseUtil(data.seven_day?.utilization) };
-        writeFileSync(cacheFile, JSON.stringify(result), "utf-8");
+        const fiveHour = parseUtil(data.five_hour?.utilization);
+        const sevenDay = parseUtil(data.seven_day?.utilization);
+        let fiveHourResetsAt;
+        // Strategy 1: Use reset time from API if available
+        const resetsAtRaw = data.five_hour?.resets_at ?? data.five_hour?.reset_at ?? data.five_hour?.next_reset;
+        if (resetsAtRaw) {
+            const ts = typeof resetsAtRaw === "string" ? new Date(resetsAtRaw).getTime() : resetsAtRaw * 1000;
+            if (!isNaN(ts) && ts > now)
+                fiveHourResetsAt = ts;
+        }
+        // Strategy 2: Fallback - track when we first saw 100%
+        if (fiveHour >= 100) {
+            if (!fiveHourResetsAt) {
+                if (existsSync(hitFile)) {
+                    const hitTime = parseFloat(readFileSync(hitFile, "utf-8").trim());
+                    if (!isNaN(hitTime)) {
+                        fiveHourResetsAt = hitTime + 5 * 3600 * 1000;
+                    }
+                }
+                else {
+                    writeFileSync(hitFile, String(now), "utf-8");
+                    fiveHourResetsAt = now + 5 * 3600 * 1000;
+                }
+            }
+        }
+        else {
+            // Usage dropped below 100%, clear hit tracker
+            try {
+                if (existsSync(hitFile))
+                    unlinkSync(hitFile);
+            }
+            catch { }
+        }
+        const result = { fiveHour, sevenDay };
+        if (fiveHourResetsAt)
+            result.fiveHourResetsAt = fiveHourResetsAt;
+        writeFileSync(cacheFile, JSON.stringify({ sessionId, data: result }), "utf-8");
         return result;
     }
     catch {
-        return null;
+        return staleData;
     }
 }
 export function render(input) {
@@ -145,9 +191,11 @@ export function render(input) {
     const cost = data.cost?.total_cost_usd ?? 0;
     const model = data.model?.display_name ?? "—";
     const contextPct = Math.floor(data.context_window?.used_percentage ?? 0);
+    // Session ID from transcript path (filename without extension)
+    const transcriptPath = data.transcript_path ?? "";
+    const sessionId = transcriptPath ? transcriptPath.replace(/^.*\//, "").replace(/\.jsonl$/, "") : "";
     // Token stats from transcript
     let totalTokens = 0;
-    const transcriptPath = data.transcript_path ?? "";
     if (transcriptPath) {
         try {
             const content = readFileSync(transcriptPath, "utf-8");
@@ -168,7 +216,7 @@ export function render(input) {
     }
     const cache = readCache();
     const config = readConfig();
-    const claudeUsage = getClaudeUsage();
+    const claudeUsage = getClaudeUsage(sessionId);
     const g = FG_GRAY_DIM;
     const y = FG_YELLOW;
     const m = FG_MODEL;
@@ -181,9 +229,15 @@ export function render(input) {
     // 5h:100% · 7d:26% · 30d:$960
     const usageParts = [];
     if (claudeUsage) {
-        const c5 = ctxColor(claudeUsage.fiveHour);
+        if (claudeUsage.fiveHour >= 100 && claudeUsage.fiveHourResetsAt) {
+            const countdown = formatCountdown(claudeUsage.fiveHourResetsAt);
+            usageParts.push(`${FG_RED}5h:${countdown}${r}`);
+        }
+        else {
+            const c5 = ctxColor(claudeUsage.fiveHour);
+            usageParts.push(`${c5}5h:${claudeUsage.fiveHour}%${r}`);
+        }
         const c7 = ctxColor(claudeUsage.sevenDay);
-        usageParts.push(`${c5}5h:${claudeUsage.fiveHour}%${r}`);
         usageParts.push(`${c7}7d:${claudeUsage.sevenDay}%${r}`);
     }
     if (cache) {
@@ -195,7 +249,7 @@ export function render(input) {
         segments.push(usageParts.join(` ${g}·${r} `));
     }
     // #2 $53.6
-    const ccclubRank = getCcclubRank();
+    const ccclubRank = getCcclubRank(sessionId);
     if (ccclubRank) {
         const rc = rankColor(ccclubRank.rank);
         segments.push(`${rc}#${ccclubRank.rank} ${formatCost(ccclubRank.cost)}${r}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-costline",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "description": "Enhanced statusline for Claude Code with cost tracking, usage limits, and leaderboard",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "test": "tsc && node --experimental-strip-types --no-warnings --test test/*.test.ts"
   },
   "files": [
     "dist"