mcp-context-cost 0.3.0 → 0.4.0

package/dist/sweep/dashboard.js

@@ -7,6 +7,38 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { parse } from 'yaml';
 import { bandColor, BAND_META } from '../core/bands.js';
+import { parseHistory } from './history.js';
+/** Longest series a sparkline plots — a stat-tile trend, not a full chart. */
+const SPARK_MAX_POINTS = 12;
+/**
+ * A 12-point-max inline trend line, oldest to newest. Muted stroke (this is
+ * texture, not a headline number) with the current value picked out as an
+ * accent dot, per the sparkline spec: de-emphasis hue for the line, accent
+ * for "now". Flat series still draw a level line rather than faking a zero
+ * baseline. Returns '' when there's nothing to trend (0-1 points).
+ */
+export function renderSparkline(tokens) {
+    const points = tokens.slice(-SPARK_MAX_POINTS);
+    if (points.length < 2)
+        return '';
+    const w = 56;
+    const h = 18;
+    const pad = 3;
+    const min = Math.min(...points);
+    const max = Math.max(...points);
+    const range = max - min;
+    const stepX = (w - pad * 2) / (points.length - 1);
+    const coords = points.map((v, i) => {
+        const x = pad + i * stepX;
+        const y = range === 0 ? h / 2 : pad + (h - pad * 2) * (1 - (v - min) / range);
+        return `${x.toFixed(1)},${y.toFixed(1)}`;
+    });
+    const [lastX, lastY] = coords[coords.length - 1].split(',');
+    return `<svg class="spark" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}" aria-hidden="true" focusable="false">
+    <polyline points="${coords.join(' ')}" fill="none" stroke="var(--muted)" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
+    <circle cx="${lastX}" cy="${lastY}" r="2.2" fill="var(--accent)" stroke="var(--surface)" stroke-width="1"/>
+  </svg>`;
+}
 const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 export function generateDashboard(root = process.cwd()) {
     const doc = parse(readFileSync(join(root, 'servers.yaml'), 'utf8'));
@@ -15,6 +47,12 @@ export function generateDashboard(root = process.cwd()) {
         ? JSON.parse(readFileSync(divergencePath, 'utf8'))
         : {};
     const dSrv = divergence.servers ?? {};
+    const historyPath = join(root, 'results', 'history.csv');
+    const history = existsSync(historyPath) ? parseHistory(readFileSync(historyPath, 'utf8')) : [];
+    const seriesFor = (name) => history
+        .filter((h) => h.server === name)
+        .sort((a, b) => a.date.localeCompare(b.date))
+        .map((h) => h.tokens);
     const rows = doc.servers.map((entry) => {
         const p = join(root, 'results', entry.name, 'measurement.json');
         return { entry, m: existsSync(p) ? JSON.parse(readFileSync(p, 'utf8')) : null };
@@ -39,11 +77,15 @@ export function generateDashboard(root = process.cwd()) {
         const pct = Math.max(1.2, (t / max) * 100);
         const div = dSrv[r.entry.name];
         const claudeTip = div ? ` · in a Claude request: ${fmt(div.claudeDelta)} tok` : '';
+        const series = seriesFor(r.entry.name);
+        const spark = renderSparkline(series);
+        const trendTip = series.length > 1 ? ` · ${series.length}-sweep trend: ${series[0].toLocaleString('en-US')} → ${series[series.length - 1].toLocaleString('en-US')}` : '';
         // The whole row is the link to the server's detail page (docs/servers/).
-        return `<a class="row" href="servers/${encodeURIComponent(r.entry.name)}.html" data-tip="${esc(m.toolCount)} tools · largest: ${esc(largest?.name)} (${fmt(largest?.tokens ?? 0)} tok)${claudeTip} · ${esc(r.entry.category)} · ${esc(m.status)}${m.serverVersion ? ' · v' + esc(String(m.serverVersion).replace(/^v/, '')) : ''}">
+        return `<a class="row" href="servers/${encodeURIComponent(r.entry.name)}.html" data-tip="${esc(m.toolCount)} tools · largest: ${esc(largest?.name)} (${fmt(largest?.tokens ?? 0)} tok)${claudeTip}${trendTip} · ${esc(r.entry.category)} · ${esc(m.status)}${m.serverVersion ? ' · v' + esc(String(m.serverVersion).replace(/^v/, '')) : ''}">
   <span class="rank">${i + 1}</span>
   <span class="name">${esc(r.entry.name)}</span>
   <span class="track"><span class="bar" style="width:${pct.toFixed(1)}%"></span></span>
+  <span class="spark-cell">${spark}</span>
   <span class="val"><span class="dot dot-${band}" aria-hidden="true"></span>${fmt(t)}<span class="bandname">${meta.label}</span></span>
 </a>`;
     })
@@ -59,7 +101,11 @@ export function generateDashboard(root = process.cwd()) {
         .map((r, i) => {
         const m = r.m;
         const div = dSrv[r.entry.name];
-        return `<tr><td>${i + 1}</td><td>${esc(r.entry.name)}</td><td class="num">${fmt(m.totalTokens)}</td><td class="num">${div ? fmt(div.claudeDelta) : '—'}</td><td class="num">${esc(m.toolCount)}</td><td>${esc(BAND_META[bandColor(m.totalTokens)].label)}</td><td>${esc(r.entry.category)}</td></tr>`;
+        const series = seriesFor(r.entry.name);
+        const trend = series.length > 1
+            ? `${series[series.length - 1] - series[0] >= 0 ? '+' : ''}${fmt(series[series.length - 1] - series[0])} / ${series.length}d`
+            : '—';
+        return `<tr><td>${i + 1}</td><td>${esc(r.entry.name)}</td><td class="num">${fmt(m.totalTokens)}</td><td class="num">${div ? fmt(div.claudeDelta) : '—'}</td><td class="num">${esc(m.toolCount)}</td><td>${esc(BAND_META[bandColor(m.totalTokens)].label)}</td><td>${esc(r.entry.category)}</td><td class="num">${trend}</td></tr>`;
     })
         .join('\n');
     const specimens = [measured[measured.length - 1], measured[0]]
@@ -117,13 +163,15 @@ export function generateDashboard(root = process.cwd()) {
   .stat .l { font-size: 11px; letter-spacing: 0.08em; text-transform: uppercase; color: var(--muted); }
 
   .board { background: var(--surface); border: 1px solid var(--line); border-radius: 8px; padding: 14px 16px; }
-  .row { display: grid; grid-template-columns: 2ch minmax(120px, 190px) 1fr max-content; gap: 10px; align-items: center; padding: 3px 4px; border-radius: 4px; outline: none; color: inherit; text-decoration: none; }
+  .row { display: grid; grid-template-columns: 2ch minmax(120px, 190px) 1fr 56px max-content; gap: 10px; align-items: center; padding: 3px 4px; border-radius: 4px; outline: none; color: inherit; text-decoration: none; }
   .row:hover, .row:focus-visible { background: var(--accent-soft); }
   .row:hover .name, .row:focus-visible .name { text-decoration: underline; }
   .rank { font-family: ui-monospace, Menlo, monospace; font-size: 11px; color: var(--muted); text-align: right; font-variant-numeric: tabular-nums; }
   .name { font-size: 0.86rem; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   .track { background: var(--track); border-radius: 3px; height: 12px; overflow: hidden; }
   .bar { display: block; height: 100%; background: var(--accent); border-radius: 3px 3px 3px 3px; min-width: 3px; }
+  .spark-cell { display: flex; align-items: center; justify-content: center; height: 18px; }
+  .spark-cell:empty { visibility: hidden; }
   .val { font-family: ui-monospace, Menlo, monospace; font-variant-numeric: tabular-nums; font-size: 0.82rem; display: flex; align-items: center; gap: 6px; }
   .dot { width: 8px; height: 8px; border-radius: 50%; display: inline-block; box-shadow: 0 0 0 2px var(--surface); }
   .dot-brightgreen { background: var(--b-brightgreen); } .dot-green { background: var(--b-green); }
@@ -172,7 +220,7 @@ export function generateDashboard(root = process.cwd()) {
   </div>
 
   <h2>Leaderboard</h2>
-  <p class="h2sub">Tokens = o200k_base count of the canonical <code>tools/list</code> bytes — the wire payload. What a <em>Claude request</em> actually carries can differ sharply (github: 54,422 on the wire, ${dSrv['github'] ? fmt(dSrv['github'].claudeDelta) : '…'} in a request — 80% of its schema bytes are fields no Anthropic request sends). Hover a row for both numbers; <a href="METHODOLOGY.html#claude-divergence">method</a>.</p>
+  <p class="h2sub">Tokens = o200k_base count of the canonical <code>tools/list</code> bytes — the wire payload. What a <em>Claude request</em> actually carries can differ sharply (github: 54,422 on the wire, ${dSrv['github'] ? fmt(dSrv['github'].claudeDelta) : '…'} in a request — 80% of its schema bytes are fields no Anthropic request sends). The trend line plots tokens across every sweep date on record (oldest→newest, dot = current); servers with one sweep so far show no line yet. Hover a row for exact numbers; <a href="METHODOLOGY.html#claude-divergence">method</a>.</p>
   <div class="board">
 ${barRows || '<p class="h2sub">Sweep in progress — first results land shortly.</p>'}
   </div>
@@ -198,7 +246,7 @@ ${barRows || '<p class="h2sub">Sweep in progress — first results land shortly.
 
   <details><summary>Full data table</summary>
   <div class="tablewrap" style="margin-top:10px"><table>
-    <thead><tr><th>#</th><th>server</th><th>tokens (o200k)</th><th>claude req</th><th>tools</th><th>band</th><th>category</th></tr></thead>
+    <thead><tr><th>#</th><th>server</th><th>tokens (o200k)</th><th>claude req</th><th>tools</th><th>band</th><th>category</th><th>trend</th></tr></thead>
     <tbody>${tableRows}</tbody>
   </table></div>
   </details>

package/dist/sweep/docker.d.ts

@@ -12,6 +12,14 @@ export interface DockerOptions {
     dummyEnv?: string[];
     /** Container name, so a timed-out container can be force-removed. */
     containerName?: string;
+    /**
+     * Install `git` inside the container before launch. The slim base images
+     * carry no VCS, so `uvx --from git+...` installs fail with "Git executable
+     * not found" — this only prefixes the containerized invocation, never the
+     * recorded `launchCommand`, so the published command stays what a user with
+     * git already on PATH would actually run.
+     */
+    needsGit?: boolean;
 }
 export declare const DEFAULT_NODE_IMAGE = "public.ecr.aws/docker/library/node:22-slim";
 export declare const DEFAULT_PYTHON_IMAGE = "ghcr.io/astral-sh/uv:python3.12-bookworm-slim";

package/dist/sweep/docker.js

@@ -35,7 +35,10 @@ export function dockerize(commandLine, opts = {}) {
     for (const name of opts.dummyEnv ?? []) {
         argv.push('-e', `${name}=dummy`);
     }
-    argv.push(image, 'sh', '-lc', commandLine);
+    const gitPrefix = opts.needsGit
+        ? 'command -v git >/dev/null 2>&1 || (apt-get update -qq && apt-get install -y -qq --no-install-recommends git >/dev/null 2>&1); '
+        : '';
+    argv.push(image, 'sh', '-lc', gitPrefix + commandLine);
     return {
         command: 'docker',
         argv,
@@ -43,7 +46,9 @@ export function dockerize(commandLine, opts = {}) {
             docker: true,
             image,
             network: 'bridge',
-            note: 'network enabled for package fetch; clean FS, no host credentials',
+            note: opts.needsGit
+                ? 'network enabled for package fetch; clean FS, no host credentials, git installed'
+                : 'network enabled for package fetch; clean FS, no host credentials',
         },
     };
 }

package/dist/sweep/report.d.ts

@@ -11,6 +11,8 @@ export interface ServerEntry {
     remote?: boolean;
     dockerImage?: string;
     timeoutSeconds?: number;
+    /** Launch needs the `git` binary (e.g. `uvx --from git+...`) — absent from the slim isolation images. */
+    needsGit?: boolean;
 }
 /** Neutralize markdown/table syntax in third-party strings (tool names, notes). */
 export declare function mdCell(s: unknown): string;

package/dist/sweep/run.d.ts

@@ -7,6 +7,8 @@ export interface MeasureOptions {
     dockerImage?: string;
     /** env var NAMES to provide as dummy values (docker mode). */
     dummyEnv?: string[];
+    /** Install `git` in the container before launch (docker mode) — see docker.ts. */
+    needsGit?: boolean;
     /**
      * Exact argv, when the caller already has it (client configs store command and
      * args separately). Avoids re-splitting a joined string on spaces, which would

package/dist/sweep/run.js

@@ -32,7 +32,12 @@ export async function measureServer(name, command, opts = {}) {
     }
     else if (opts.docker) {
         containerName = `mcp-ctx-${name}-${process.pid}-${Math.floor(Math.random() * 1e6)}`;
-        const d = dockerize(command, { image: opts.dockerImage, dummyEnv: opts.dummyEnv, containerName });
+        const d = dockerize(command, {
+            image: opts.dockerImage,
+            dummyEnv: opts.dummyEnv,
+            containerName,
+            needsGit: opts.needsGit,
+        });
         spec = { command: d.command, argv: d.argv };
         isolation = d.isolation;
     }

package/dist/sweep/sweep-all.js

@@ -36,6 +36,7 @@ async function worker() {
             docker,
             dockerImage: e.dockerImage,
             dummyEnv: e.env ?? [],
+            needsGit: e.needsGit,
         });
         const secs = ((Date.now() - started) / 1000).toFixed(0);
         summary[e.name] =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-context-cost",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Measure what your MCP servers cost in context tokens — audit your own config, or badge the server you publish",
   "type": "module",
   "license": "MIT",