@empirical-gauzza/cli 1.0.36 → 1.0.37

package/lib/usageCommands.js

@@ -0,0 +1,52 @@
+'use strict';
+
+// `empirical usage`: memory, blueprint installs this month, and Empirical Tokens (spec 8.4).
+// Reads GET /api/v1/billing/me. The Empirical Tokens line appears only while they are enforced
+// for this account, so the command stays dark until rollout. A missing or null
+// empiricalTokenUsage, or any mode other than 'enforce', is hidden.
+const { httpJson, printApiError } = require('./http');
+const { requireAccessToken, resolveApiBaseUrl, buildApiAuthHeaders } = require('./auth');
+const { log } = require('./ui');
+const { resetLabel } = require('./empiricalTokensFormat');
+
+const fmt = (n) => Number(n).toLocaleString('en-US');
+
+function empiricalTokensLine(usage) {
+  if (!usage || usage.mode !== 'enforce') return null;
+  // An admin account has no limit: the server sends unlimited true with null granted and remaining.
+  if (usage.unlimited) return `Empirical Tokens: unlimited. ${fmt(usage.spent || 0)} used this month.`;
+  // Free has nothing granted (Writing Voice is paid only): same idea as the portal card, not '0 of 0 left'.
+  if (usage.tier === 'free' && !(Number(usage.granted) + Number(usage.adjust || 0) > 0)) return 'Empirical Tokens: building a writing voice is part of the paid plans.';
+  const reset = resetLabel(usage.resetsAt);
+  return `Empirical Tokens: ${fmt(usage.remaining)} of ${fmt(usage.granted + usage.adjust)} left this month.${reset ? ` Resets ${reset}.` : ''}`;
+}
+
+async function fetchBillingMe(timeoutMs = 0) {
+  const token = requireAccessToken();
+  const url = new URL('/api/v1/billing/me', resolveApiBaseUrl()).toString();
+  const response = await httpJson(url, 'GET', null, buildApiAuthHeaders(token), timeoutMs);
+  return response && response.data ? response.data : response;
+}
+
+async function runUsageCommand(args) {
+  let data;
+  try {
+    data = await fetchBillingMe();
+  } catch (error) {
+    printApiError(error);
+    process.exit(1);
+  }
+  if (args.includes('--json')) {
+    log(JSON.stringify({ memoryUsage: data.memoryUsage, blueprintUsage: data.blueprintUsage, empiricalTokenUsage: data.empiricalTokenUsage && data.empiricalTokenUsage.mode === 'enforce' ? data.empiricalTokenUsage : null }, null, 2));
+    return;
+  }
+  const memory = data.memoryUsage || {};
+  log(memory.unlimited ? `Memory: ${fmt(memory.used)} used (no plan cap).` : `Memory: ${fmt(memory.used)} of ${fmt(memory.limit)} used.`);
+  const installs = data.blueprintUsage || {};
+  const across = typeof installs.accountUsed === 'number' ? ` (${fmt(installs.accountUsed)} across all workspaces)` : '';
+  log(installs.unlimited ? `Blueprint installs this month: ${fmt(installs.used)}${across}.` : `Blueprint installs this month: ${fmt(installs.used)} of ${fmt(installs.limit)}${across}.`);
+  const line = empiricalTokensLine(data.empiricalTokenUsage);
+  if (line) log(line);
+}
+
+module.exports = { runUsageCommand, empiricalTokensLine, fetchBillingMe };

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@empirical-gauzza/cli",
-  "version": "1.0.36",
-  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
-  "keywords": [
-    "memory",
-    "mcp",
-    "agent memory",
-    "ai memory",
-    "claude",
-    "chatgpt",
-    "model context protocol",
-    "persistent memory",
-    "claude-code",
-    "codex",
-    "knowledge base"
-  ],
-  "type": "commonjs",
-  "license": "MIT",
-  "homepage": "https://empirical.gauzza.com/docs/cli-details",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "empirical": "bin/empirical.js"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "gray-matter": "^4.0.3"
-  }
-}
+{
+  "name": "@empirical-gauzza/cli",
+  "version": "1.0.37",
+  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
+  "keywords": [
+    "memory",
+    "mcp",
+    "agent memory",
+    "ai memory",
+    "claude",
+    "chatgpt",
+    "model context protocol",
+    "persistent memory",
+    "claude-code",
+    "codex",
+    "knowledge base"
+  ],
+  "type": "commonjs",
+  "license": "MIT",
+  "homepage": "https://empirical.gauzza.com/docs/cli-details",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "empirical": "bin/empirical.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  }
+}