savemytokens 0.2.0

package/dist/storage/paths.js

@@ -0,0 +1,29 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const HOME = process.env.SAVEMYTOKENS_HOME || path.join(os.homedir(), ".savemytokens");
+export const CACHE_DIR = path.join(HOME, "cache");
+export const RUNS_FILE = path.join(HOME, "runs.json");
+export const LAST_AUDIT_FILE = path.join(HOME, "last-audit.json");
+export const CONFIG_FILE = path.join(HOME, "config.json");
+export function ensureHome() {
+    fs.mkdirSync(CACHE_DIR, { recursive: true });
+}
+export function displayHome() {
+    const home = os.homedir();
+    return HOME.startsWith(home) ? "~" + HOME.slice(home.length) : HOME;
+}
+export function readJson(file, fallback) {
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch {
+        return fallback;
+    }
+}
+export function writeJson(file, value) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(value));
+    fs.renameSync(tmp, file);
+}

package/dist/storage/store.js

@@ -0,0 +1,48 @@
+import { LAST_AUDIT_FILE, RUNS_FILE, ensureHome, readJson, writeJson } from "./paths.js";
+const MAX_RUNS = 250;
+export function loadRuns() {
+    const runs = readJson(RUNS_FILE, []);
+    return Array.isArray(runs) ? runs : [];
+}
+export function scopeKey(audit) {
+    return `${audit.scope.days}d:${audit.scope.project ?? "all"}`;
+}
+export function previousRun(audit, runs) {
+    const key = scopeKey(audit);
+    for (let i = runs.length - 1; i >= 0; i--) {
+        const run = runs[i];
+        if (!run)
+            continue;
+        if (`${run.scope.days}d:${run.scope.project ?? "all"}` !== key)
+            continue;
+        if (run.ranAt >= audit.ranAt)
+            continue;
+        return run;
+    }
+    return null;
+}
+export function toRunRecord(audit) {
+    return {
+        ranAt: audit.ranAt,
+        score: audit.score,
+        wasteRatio: audit.wasteRatio,
+        upliftRatio: audit.upliftRatio,
+        scope: audit.scope,
+        totals: audit.totals,
+        findings: audit.findings.map((f) => ({
+            id: f.id,
+            title: f.title,
+            wasteRatio: f.wasteRatio,
+            confidence: f.confidence,
+        })),
+    };
+}
+export function saveRun(audit) {
+    ensureHome();
+    const runs = loadRuns();
+    runs.push(toRunRecord(audit));
+    const trimmed = runs.slice(-MAX_RUNS);
+    writeJson(RUNS_FILE, trimmed);
+    writeJson(LAST_AUDIT_FILE, audit);
+    return trimmed;
+}

package/dist/util/ansi.js

@@ -0,0 +1,35 @@
+const ESC = "\u001b[";
+const RESET = `${ESC}0m`;
+const enabled = process.env.NO_COLOR === undefined && process.env.TERM !== "dumb" && Boolean(process.stdout.isTTY);
+function wrap(code) {
+    return (text) => (enabled ? `${ESC}${code}m${text}${RESET}` : text);
+}
+export const bold = wrap("1");
+export const dim = wrap("2");
+export const green = wrap("32");
+export const yellow = wrap("33");
+export const red = wrap("31");
+export const colorEnabled = enabled;
+const ANSI_PATTERN = new RegExp("\\u001b\\[[0-9;]*m", "g");
+export function stripAnsi(text) {
+    return text.replace(ANSI_PATTERN, "");
+}
+export function visibleWidth(text) {
+    return stripAnsi(text).length;
+}
+export function padEndVisible(text, width) {
+    const pad = width - visibleWidth(text);
+    return pad > 0 ? text + " ".repeat(pad) : text;
+}
+export function padStartVisible(text, width) {
+    const pad = width - visibleWidth(text);
+    return pad > 0 ? " ".repeat(pad) + text : text;
+}
+export function clip(text, max) {
+    if (max <= 1)
+        return "";
+    const visible = visibleWidth(text);
+    if (visible <= max)
+        return text;
+    return `${text.slice(0, Math.max(0, text.length - (visible - max) - 1))}…`;
+}

package/dist/util/fmt.js

@@ -0,0 +1,76 @@
+export function compactNumber(value) {
+    const n = Math.round(value);
+    if (n < 1_000)
+        return String(n);
+    if (n < 999_500)
+        return `${(n / 1_000).toFixed(n < 10_000 ? 1 : 0)}k`;
+    if (n < 999_500_000)
+        return `${(n / 1_000_000).toFixed(n < 10_000_000 ? 1 : 0)}M`;
+    return `${(n / 1_000_000_000).toFixed(1)}B`;
+}
+export function bytes(chars) {
+    if (chars < 1_024)
+        return `${chars} B`;
+    if (chars < 1_024 * 1_024)
+        return `${(chars / 1_024).toFixed(0)} KB`;
+    return `${(chars / (1_024 * 1_024)).toFixed(1)} MB`;
+}
+export function money(value) {
+    if (value >= 1000)
+        return `$${Math.round(value).toLocaleString("en-US")}`;
+    if (value >= 10)
+        return `$${Math.round(value)}`;
+    if (value >= 1)
+        return `$${value.toFixed(1)}`;
+    return `$${value.toFixed(2)}`;
+}
+export function percent(ratio, digits = 0) {
+    return `${(ratio * 100).toFixed(digits)}%`;
+}
+const SPARK = "▁▂▃▄▅▆▇█";
+export function bar(value, max, width = 8) {
+    if (max <= 0 || value <= 0)
+        return "";
+    const filled = Math.round((value / max) * width);
+    return "▇".repeat(Math.max(1, Math.min(width, filled)));
+}
+export function sparkline(values) {
+    if (values.length < 3)
+        return "";
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    if (max === min)
+        return "▄".repeat(values.length);
+    const span = max - min;
+    return values
+        .map((value) => SPARK[Math.min(SPARK.length - 1, Math.floor(((value - min) / span) * (SPARK.length - 1)))] ?? " ")
+        .join("");
+}
+export function shortPath(value, max = 44) {
+    if (value.length <= max)
+        return value;
+    const parts = value.split("/").filter(Boolean);
+    const tail = parts.slice(-2).join("/");
+    return tail.length <= max ? `…/${tail}` : `…/${parts[parts.length - 1] ?? value}`;
+}
+export function plural(count, one, many = `${one}s`) {
+    return count === 1 ? one : many;
+}
+export function ago(ts, now = Date.now()) {
+    const diff = Math.max(0, now - ts);
+    const minutes = Math.round(diff / 60_000);
+    if (minutes < 1)
+        return "just now";
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.round(hours / 24);
+    return `${days}d ago`;
+}
+export function shortDate(ts) {
+    const d = new Date(ts);
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "savemytokens",
+  "version": "0.2.0",
+  "description": "Give every Claude Code session a target share of your Claude window, and keep Claude aware of it. Local, private, zero setup.",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "statusline",
+    "rate-limit",
+    "quota",
+    "scheduler",
+    "tokens",
+    "cost",
+    "tui",
+    "cli"
+  ],
+  "homepage": "https://savemytokens.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/offbeatport/savemytokens.git"
+  },
+  "bugs": {
+    "url": "https://github.com/offbeatport/savemytokens/issues"
+  },
+  "license": "MIT",
+  "author": "Offbeatport",
+  "type": "module",
+  "bin": {
+    "savemytokens": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-runtime.mjs",
+    "dev": "npm run build && node dist/cli.js",
+    "test": "npm run build && node --test test/*.test.js",
+    "screenshot": "npm run build && COLORTERM=truecolor node scripts/screenshot.mjs",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "packageManager": "pnpm@10.30.3+sha256.ff0a72140f6a6d66c0b284f6c9560aff605518e28c29aeac25fb262b74331588"
+}