cc-costline 0.2.3 → 0.3.0

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, statSync, 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,13 +30,22 @@ 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;
 }
+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 with 120s file cache
 function getCcclubRank() {
     const configPath = join(homedir(), ".ccclub", "config.json");
@@ -77,7 +86,7 @@ function getCcclubRank() {
         return null;
     }
 }
-function rankColor(rank) {
+export function rankColor(rank) {
     if (rank === 1)
         return FG_YELLOW;
     if (rank === 2)
@@ -89,10 +98,12 @@ function rankColor(rank) {
 // Claude usage fetcher with 60s file cache
 function getClaudeUsage() {
     const cacheFile = "/tmp/sl-claude-usage";
-    const now = Date.now() / 1000;
+    const hitFile = "/tmp/sl-claude-usage-hit";
+    const now = Date.now();
+    const nowSec = now / 1000;
     if (existsSync(cacheFile)) {
         const mtime = statSync(cacheFile).mtimeMs / 1000;
-        if (now - mtime <= 60) {
+        if (nowSec - mtime <= 60) {
             try {
                 return JSON.parse(readFileSync(cacheFile, "utf-8"));
             }
@@ -125,7 +136,42 @@ function getClaudeUsage() {
                 return Math.round(parseFloat(val.replace("%", "")));
             return 0;
         };
-        const result = { fiveHour: parseUtil(data.five_hour?.utilization), sevenDay: parseUtil(data.seven_day?.utilization) };
+        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(result), "utf-8");
         return result;
     }
@@ -169,24 +215,42 @@ export function render(input) {
     const cache = readCache();
     const config = readConfig();
     const claudeUsage = getClaudeUsage();
-    const parts = [];
-    // 1. Tokens ~ cost / context % + model
-    parts.push(`${FG_GRAY_DIM}∫ ${formatTokens(totalTokens)}${RESET} ${FG_GRAY_DIM}~${RESET} ${FG_YELLOW}${formatCost(cost)}${RESET} ${FG_GRAY_DIM}/${RESET} ${ctxColor(contextPct)}${contextPct}%${RESET} ${FG_GRAY_DIM}by${RESET} ${FG_MODEL}${model}${RESET}`);
-    // 2. Claude usage limits (colored by utilization)
+    const g = FG_GRAY_DIM;
+    const y = FG_YELLOW;
+    const m = FG_MODEL;
+    const gr = FG_GRAY;
+    const r = RESET;
+    const cx = ctxColor(contextPct);
+    const segments = [];
+    // tokens $cost · ctx% Model
+    segments.push(`${formatTokens(totalTokens)} ${y}${formatCost(cost)}${r} ${g}·${r} ${cx}${contextPct}%${r} ${m}${model}${r}`);
+    // 5h:100% · 7d:26% · 30d:$960
+    const usageParts = [];
     if (claudeUsage) {
-        parts.push(`${FG_GRAY_DIM}∝${RESET} ${ctxColor(claudeUsage.fiveHour)}5h: ${claudeUsage.fiveHour}%${RESET} ${FG_GRAY_DIM}/${RESET} ${ctxColor(claudeUsage.sevenDay)}7d: ${claudeUsage.sevenDay}%${RESET}`);
+        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(`${c7}7d:${claudeUsage.sevenDay}%${r}`);
     }
-    // 3. Period cost (default 30d, configurable)
     if (cache) {
         const period = config.period || "30d";
         const periodCost = period === "7d" ? cache.cost7d : cache.cost30d;
-        parts.push(`${FG_YELLOW}Σ ${period}: ${formatCost(periodCost)}${RESET}`);
+        usageParts.push(`${y}${period}:${formatCost(periodCost)}${r}`);
+    }
+    if (usageParts.length > 0) {
+        segments.push(usageParts.join(` ${g}·${r} `));
     }
-    // 4. ccclub rank (colored by position)
+    // #2 $53.6
     const ccclubRank = getCcclubRank();
     if (ccclubRank) {
         const rc = rankColor(ccclubRank.rank);
-        parts.push(`${rc}Ω #${ccclubRank.rank}/${ccclubRank.total} ${formatCost(ccclubRank.cost)}${RESET}`);
+        segments.push(`${rc}#${ccclubRank.rank} ${formatCost(ccclubRank.cost)}${r}`);
     }
-    return "\n " + parts.join(` ${FG_GRAY}|${RESET} `) + "\n";
+    return " " + segments.join(` ${gr}/${r} `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-costline",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "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"