@ugurcandede/cc-cost 0.1.0 → 0.1.1

package/README.md

@@ -3,7 +3,7 @@
   <h1>cc-cost</h1>
   <p>What your Claude Code usage would cost at API list prices, totalled across all your machines (Windows, Mac, Linux), with an archive that outlives Claude Code's transcript cleanup and a dashboard you open with a double-click.</p>
   <br>
-  <a href="https://github.com/ugurcandede/cc-cost" target="_blank"><img src="https://img.shields.io/badge/version-0.1.0-blue?style=flat-square" alt="Version 0.1.0"></a>
+  <a href="https://www.npmjs.com/package/@ugurcandede/cc-cost" target="_blank"><img src="https://img.shields.io/npm/v/@ugurcandede/cc-cost?style=flat-square&label=version" alt="npm version"></a>
   <img src="https://img.shields.io/badge/Node.js-22%2B%20·%20zero%20dependencies-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 22+, zero dependencies">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
   <br>  
@@ -32,7 +32,7 @@ npm i -g @ugurcandede/cc-cost          # or, with Yarn 1: yarn global add @ugurc
 cc-cost setup
 
 cc-cost                  # sync this machine, print a summary
-cc-cost report --open    # the dashboard
+cc-cost report           # open the dashboard
 ```
 
 Run `setup` on every machine and point them at the same folder. Each one adds its numbers; every one
@@ -59,6 +59,7 @@ cc-cost insights             # context size, cache efficiency, what drives the c
 cc-cost plan                 # API equivalent vs Pro / Max 5x / Max 20x, rate-limit hits
 cc-cost blocks               # usage in Claude's 5-hour windows
 cc-cost status               # settings, machines, schedule, hook
+cc-cost update               # update to the latest version
 ```
 
 ```

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { spawn } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 import { createRequire } from 'node:module';
 import path from 'node:path';
@@ -16,6 +16,7 @@ import { blocksReport, dimensionJson, dimensionReport, DIMENSIONS, insights, lim
 import { localClock } from "./scan.js";
 import { claudeSettingsFile, currentRunner, dataFolderIn, hookInstalled, installHook, installSchedule, isEphemeral, removeHook, removeSchedule, SCHEDULE_TIME, scheduleInstalled, syncFolders, } from "./setup.js";
 import { loadAll } from "./snapshot.js";
+import { installMethod, isNewer, latestVersion, updateCommand } from "./update.js";
 import { dashboardPath, sync } from "./sync.js";
 // Name, version and project page come from package.json only
 const pkg = createRequire(import.meta.url)('../package.json');
@@ -44,7 +45,7 @@ const { values: opt, positionals } = parseArgs({
         'no-sync': { type: 'boolean' },
         offline: { type: 'boolean' },
         quiet: { type: 'boolean' },
-        open: { type: 'boolean' },
+        location: { type: 'boolean' },
         refresh: { type: 'boolean' },
         'sync-dir': { type: 'string' },
         yes: { type: 'boolean', short: 'y' },
@@ -109,9 +110,11 @@ function openFile(file) {
     const [cmd, args] = process.platform === 'win32' ? ['cmd', ['/c', 'start', '""', file]]
         : process.platform === 'darwin' ? ['open', [file]]
             : ['xdg-open', [file]];
-    spawn(cmd, args, { detached: true, stdio: 'ignore' }).unref();
+    // No browser opener (a server, SSH): the path printed alongside is enough, so ignore the failure.
+    spawn(cmd, args, { detached: true, stdio: 'ignore' }).on('error', () => { }).unref();
 }
 const pricesCache = () => path.join(configDir(), 'pricing-cache.json');
+const updateCache = () => path.join(configDir(), 'update-check.json');
 async function data(verbose) {
     if (!opt['no-sync']) {
         const r = await sync(settings);
@@ -142,11 +145,42 @@ function dashboard(d) {
         site: pkg.author.url,
     }, dashboardPath(settings));
 }
-function footer(d) {
+async function footer(d) {
     if (d.prices.note)
         out(fill(L().pricesFallback, { reason: d.prices.note, source: d.prices.table.source, date: d.prices.table.date.slice(0, 10) }));
     if (d.unknown.size)
         out(fill(L().unknownModels, { list: [...d.unknown].join(', ') }));
+    // At most one registry check a day, and never in machine-readable or offline output
+    if (opt.json || opt.csv || opt.offline || opt.quiet)
+        return;
+    const latest = await latestVersion(pkg.name, updateCache());
+    if (latest && isNewer(latest, pkg.version))
+        out('\n' + paint('yellow', fill(L().update.available, { latest, current: pkg.version })));
+}
+async function update() {
+    const U = L().update;
+    const script = currentRunner().script;
+    const method = installMethod(script);
+    if (method === 'ephemeral')
+        return out(fill(U.ephemeral, { pkg: pkg.name }));
+    if (method === 'unknown')
+        return out(fill(U.manual, { path: script }));
+    let latest;
+    try {
+        latest = await latestVersion(pkg.name, updateCache(), { force: true });
+    }
+    catch {
+        fail(U.checkFailed);
+    }
+    if (!latest || !isNewer(latest, pkg.version))
+        return out(fill(U.upToDate, { current: pkg.version }));
+    const command = updateCommand[method](pkg.name).join(' ');
+    out(fill(U.running, { latest, command }));
+    // a fixed command line, no user input; the shell finds npm.cmd / yarn.cmd on Windows
+    const res = spawnSync(command, { stdio: 'inherit', shell: true });
+    if (res.status !== 0)
+        fail(fill(U.failed, { code: String(res.status), command }));
+    out(fill(U.done, { latest }));
 }
 // Print a table report as a table, CSV or JSON
 function emit(report, json, empty) {
@@ -307,13 +341,13 @@ async function main() {
             out(opt.json ? JSON.stringify(r.json, null, 2) : rows.length ? r.text : L().noData);
         }
         if (!opt.json && !opt.csv)
-            footer(d);
+            await footer(d);
         return;
     }
     if (cmd === 'report') {
         const file = dashboard(await data(false));
         out(fill(L().dashboard, { file }));
-        if (opt.open)
+        if (!opt.location)
             openFile(file);
         return;
     }
@@ -333,6 +367,8 @@ async function main() {
         return setup();
     if (cmd === 'status')
         return status();
+    if (cmd === 'update')
+        return update();
     if (cmd === 'config') {
         if (rest[0] === 'set') {
             const [key, value = ''] = rest.slice(1);

package/dist/i18n.js

@@ -14,10 +14,11 @@ Commands:
   blocks                        Usage in 5-hour windows
   insights                      Where the money goes and what drives it
   plan                          API equivalent vs subscription prices, rate-limit hits
-  report                        Write the HTML dashboard (--open to open it)
+  report                        Open the HTML dashboard (--location prints its path instead)
   pricing                       Prices in use (--refresh to fetch them again)
   setup                         Pick the shared folder, schedule daily runs, add the Claude Code hook
   status                        Settings, machines, last sync, scheduler and hook
+  update                        Update cc-cost to the latest version
   config                        Show settings; "config set <key> <value>" changes one
 
 Filters:
@@ -126,6 +127,16 @@ Docs and issues: {url}`,
     blocks: {
         active: 'active, {left} left',
     },
+    update: {
+        available: 'cc-cost {latest} is available (you have {current}). Run: cc-cost update',
+        upToDate: 'cc-cost {current} is up to date.',
+        running: 'Updating to {latest}: {command}',
+        done: 'Updated to cc-cost {latest}. The schedule and hook keep working; no need to run setup again.',
+        failed: 'The update failed (exit code {code}). Run it yourself: {command}',
+        checkFailed: 'Could not reach the npm registry to check for a newer version.',
+        ephemeral: 'cc-cost is running through npx or dlx, which fetch it each time. For the newest version: npx {pkg}@latest',
+        manual: 'cc-cost runs from {path}, not from a package-manager install. Update it the way you installed it (a git checkout: git pull, then yarn build).',
+    },
     setup: {
         title: 'cc-cost {version} setup',
         found: 'Shared folders found: {list}',
@@ -216,10 +227,11 @@ Komutlar:
   blocks                        5 saatlik pencerelerde kullanım
   insights                      Para nereye gidiyor, neyden kaynaklanıyor
   plan                          API karşılığı ve abonelik fiyatları, limit aşımları
-  report                        HTML dashboard'u yaz (--open ile aç)
+  report                        HTML dashboard'u aç (--location sadece yolunu basar)
   pricing                       Kullanılan fiyatlar (--refresh ile yeniden çek)
   setup                         Paylaşılan klasörü seç, günlük çalışmayı zamanla, Claude Code hook'unu ekle
   status                        Ayarlar, makineler, son senkron, zamanlayıcı ve hook
+  update                        cc-cost'u en son sürüme güncelle
   config                        Ayarları göster; "config set <anahtar> <değer>" ile değiştir
 
 Filtreler:
@@ -328,6 +340,16 @@ Dokümantasyon ve hata bildirimi: {url}`,
     blocks: {
         active: 'aktif, {left} kaldı',
     },
+    update: {
+        available: 'cc-cost {latest} yayında (sizdeki {current}). Güncellemek için: cc-cost update',
+        upToDate: 'cc-cost {current} güncel.',
+        running: '{latest} sürümüne güncelleniyor: {command}',
+        done: 'cc-cost {latest} sürümüne güncellendi. Zamanlama ve hook çalışmaya devam eder; setup\'ı yeniden çalıştırmaya gerek yok.',
+        failed: 'Güncelleme başarısız oldu (çıkış kodu {code}). Kendiniz çalıştırın: {command}',
+        checkFailed: 'Yeni sürümü kontrol etmek için npm registry\'ye ulaşılamadı.',
+        ephemeral: 'cc-cost npx ya da dlx ile çalışıyor; bunlar her seferinde paketi indirir. En yeni sürüm için: npx {pkg}@latest',
+        manual: 'cc-cost {path} konumundan çalışıyor, bir paket yöneticisi kurulumu değil. Nasıl kurduysanız öyle güncelleyin (git kopyası: git pull, ardından yarn build).',
+    },
     setup: {
         title: 'cc-cost {version} kurulumu',
         found: 'Bulunan paylaşılan klasörler: {list}',

package/dist/update.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const MAX_AGE_MS = 24 * 60 * 60 * 1000;
+// x.y.z comparison; a pre-release (x.y.z-beta) never counts as newer than its release
+export function isNewer(candidate, current) {
+    const parse = (v) => {
+        const [core, pre] = v.split('-');
+        return { n: (core ?? '').split('.').map((x) => Number(x) || 0), pre: !!pre };
+    };
+    const a = parse(candidate), b = parse(current);
+    for (let i = 0; i < 3; i++)
+        if ((a.n[i] ?? 0) !== (b.n[i] ?? 0))
+            return (a.n[i] ?? 0) > (b.n[i] ?? 0);
+    return !a.pre && b.pre;
+}
+// Latest published version, asked of the registry at most once a day unless `force`.
+export async function latestVersion(name, cacheFile, opts = {}) {
+    let cached;
+    try {
+        cached = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+    }
+    catch {
+        // first check
+    }
+    const fresh = cached && Date.now() - Date.parse(cached.checked) < MAX_AGE_MS;
+    if (opts.offline || (fresh && !opts.force))
+        return cached?.latest;
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${name.replace('/', '%2f')}/latest`, { signal: AbortSignal.timeout(3000) });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const latest = String((await res.json()).version ?? '');
+        if (!latest)
+            throw new Error('no version');
+        fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
+        fs.writeFileSync(cacheFile, JSON.stringify({ checked: new Date().toISOString(), latest }));
+        return latest;
+    }
+    catch {
+        if (opts.force)
+            throw new Error('registry unreachable');
+        return cached?.latest; // offline or registry down: say nothing new
+    }
+}
+// How this copy was installed, read from where its script lives
+export function installMethod(script) {
+    if (/[\\/](_npx|dlx(-\d+)?)[\\/]/.test(script))
+        return 'ephemeral';
+    if (!/[\\/]node_modules[\\/]@ugurcandede[\\/]cc-cost[\\/]/.test(script))
+        return 'unknown'; // e.g. a git checkout
+    if (/[\\/]pnpm[\\/]/i.test(script))
+        return 'pnpm';
+    if (/[\\/]yarn[\\/](data[\\/])?global[\\/]/i.test(script))
+        return 'yarn';
+    return 'npm';
+}
+export const updateCommand = {
+    npm: (pkg) => ['npm', 'i', '-g', `${pkg}@latest`],
+    yarn: (pkg) => ['yarn', 'global', 'add', `${pkg}@latest`],
+    pnpm: (pkg) => ['pnpm', 'add', '-g', `${pkg}@latest`],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ugurcandede/cc-cost",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "API-equivalent cost of your Claude Code usage across all your machines, with an archive that outlives transcript cleanup and an offline dashboard.",
   "keywords": [
     "claude",