@vibgrate/cli 2026.718.2 → 2026.720.2

package/DOCS.md

@@ -874,6 +874,8 @@ vg serve
 
 Via stdio (default), your AI assistant spawns the server. Via `--http`, it runs as a local HTTP endpoint for browser or shared access.
 
+**A live status display shows what the server is doing for you.** While `vg serve` runs in a terminal, a status block on stderr updates in place: uptime, which AI clients are connected (detected from the MCP handshake), calls and average response time per tool, and — for the navigation tools with a grep/read baseline — the context tokens served vs the estimated tokens a grep-and-read agent would have burned instead, with the estimated saving labelled as such. Outside a terminal (when your assistant spawns the server) it degrades to a quiet one-line heartbeat in the server logs every 15 minutes, and only when there has been activity. The display is in-memory only and always on — nothing is written to disk or uploaded (recording and sharing below stay opt-in) — and `--quiet` turns it off.
+
 **Usage stats — local by default, sharing is opt-in.** `--savings` records a *counts-only* ledger under `.vibgrate/` — per navigation call: which tool, how it resolved (complete/partial/miss), the vg-vs-grep token figures, whether it came over the MCP (`mcp`) or the `vg` CLI (`cli`), and a coarse client label (which AI). `vg savings` reports it locally; nothing leaves your machine. `--share-stats` additionally uploads that same counts-only ledger to Vibgrate periodically, so we can see how the local MCP is used and improve it. It **never** sends code, file paths, question text, repo identity, or any credential — only counts, outcomes, token figures, the vg version, your OS/arch, and a random per-install id. It's off unless you pass the flag, is disabled entirely under `--local`, and the endpoint can be overridden with `VIBGRATE_STATS_ENDPOINT`.
 
 **Attributing CLI calls.** The MCP path detects the calling client automatically from the connection handshake. For CLI calls, pass `--client=<ai>` (e.g. `vg "how does auth work" --client=claude`) so the call is attributed in `vg savings` and any shared stats — this is what `vg install` writes into each assistant's skill. Without `--client`, a bare `vg ask` records nothing.

package/dist/baseline-WIZAFIJS.js

@@ -0,0 +1,6 @@
+export { baselineCommand, runBaseline } from './chunk-DDQ5JGBV.js';
+import './chunk-OD5654VF.js';
+import './chunk-RXP66R2E.js';
+import './chunk-GI6W53LM.js';
+//# sourceMappingURL=baseline-WIZAFIJS.js.map
+//# sourceMappingURL=baseline-WIZAFIJS.js.map

package/dist/{baseline-DKPQWOQ6.js.map → baseline-WIZAFIJS.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-DKPQWOQ6.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-WIZAFIJS.js"}

package/dist/{chunk-H5M7CXE6.js → chunk-7R4O5CZD.js}

@@ -1,5 +1,5 @@
-import { hashString, langById, shortId, canonicalize, grammarSetVersion, hashBytes, langForExtension, setGrammarsOverride, parseSource } from './chunk-VFO5UDAT.js';
-import { writeTextFile, pathExists, readJsonFile, loadConfig, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-RME7BFMU.js';
+import { hashString, langById, shortId, canonicalize, grammarSetVersion, hashBytes, langForExtension, setGrammarsOverride, parseSource } from './chunk-BHA7QIPD.js';
+import { writeTextFile, pathExists, readJsonFile, loadConfig, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-OD5654VF.js';
 import * as fs19 from 'fs';
 import { spawnSync, execFileSync } from 'child_process';
 import * as path19 from 'path';
@@ -336,7 +336,7 @@ function formatBytes(n) {
   if (n >= 1024) return `${(n / 1024).toFixed(1)} KiB`;
   return `${n} B`;
 }
-var JS_TS_EXT = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+var JS_TS_EXT = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs", ".vue", ".svelte", ".astro"];
 var OTHER_EXT = [
   ".py",
   ".pyi",
@@ -365,7 +365,13 @@ var OTHER_EXT = [
   ".hpp",
   ".hh",
   ".hxx",
-  ".h"
+  ".h",
+  ".m",
+  ".mm",
+  ".ml",
+  ".mli",
+  ".res",
+  ".sol"
 ];
 var EXT_GROUPS = {
   ".py": [".py", ".pyi"],
@@ -399,7 +405,19 @@ Object.assign(EXT_GROUPS, {
   ".hpp": CPP_EXT,
   ".hh": CPP_EXT,
   ".hxx": CPP_EXT,
-  ".h": [...CPP_EXT, ".c"]
+  ".h": [...CPP_EXT, ".c"],
+  // ObjC #imports headers; ObjC++ additionally reaches C++ headers.
+  ".m": [".h", ".m", ".mm"],
+  ".mm": [".h", ".m", ".mm", ...CPP_EXT],
+  ".ml": [".ml", ".mli"],
+  ".mli": [".ml", ".mli"],
+  ".res": [".res"],
+  ".sol": [".sol"],
+  // Template containers: ERB fragments are Ruby; HTML/EJS script is JS.
+  ".erb": [".rb", ".erb"],
+  ".html": JS_TS_EXT,
+  ".htm": JS_TS_EXT,
+  ".ejs": JS_TS_EXT
 });
 function buildModuleResolver(root, relSet) {
   const probe = makeProbe(relSet);
@@ -3372,9 +3390,12 @@ function recordCliCall(root, entry, now) {
     now
   );
 }
-function ledgerPath(root) {
+function savingsLedgerPath(root) {
   return path19.join(cacheDir(root), LEDGER);
 }
+function ledgerPath(root) {
+  return savingsLedgerPath(root);
+}
 function savingsRecorded(root) {
   return fs19.existsSync(ledgerPath(root));
 }
@@ -3445,6 +3466,7 @@ function readUsage(root, days, now) {
   const byTool = /* @__PURE__ */ new Map();
   const bySource = /* @__PURE__ */ new Map();
   const byClient = /* @__PURE__ */ new Map();
+  const msByTool = /* @__PURE__ */ new Map();
   const bump2 = (m, key, outcome) => {
     const row = m.get(key) ?? { complete: 0, partial: 0, miss: 0 };
     row[outcome]++;
@@ -3460,18 +3482,28 @@ function readUsage(root, days, now) {
         bump2(byTool, e.tool, outcome);
         bump2(bySource, e.source ?? "mcp", outcome);
         bump2(byClient, e.client ?? "unknown", outcome);
+        if (typeof e.ms === "number" && e.ms >= 0) {
+          const timing = msByTool.get(e.tool) ?? { sum: 0, n: 0 };
+          timing.sum += e.ms;
+          timing.n++;
+          msByTool.set(e.tool, timing);
+        }
       } catch {
       }
     }
   }
-  const commands = toDimensionStats(byTool).map((d) => ({
-    tool: d.key,
-    calls: d.calls,
-    complete: d.complete,
-    partial: d.partial,
-    miss: d.miss,
-    successPct: d.successPct
-  }));
+  const commands = toDimensionStats(byTool).map((d) => {
+    const timing = msByTool.get(d.key);
+    return {
+      tool: d.key,
+      calls: d.calls,
+      complete: d.complete,
+      partial: d.partial,
+      miss: d.miss,
+      successPct: d.successPct,
+      avgMs: timing && timing.n > 0 ? Math.round(timing.sum / timing.n) : null
+    };
+  });
   const totals = commands.reduce(
     (t, c) => ({
       calls: t.calls + c.calls,
@@ -6878,7 +6910,7 @@ var GraphSource = class {
   }
 };
 function createServer(source, opts = {}) {
-  const { savings = false, shareStats = false, local = false, dedup = false } = opts;
+  const { savings = false, shareStats = false, local = false, dedup = false, stats } = opts;
   const record = savings || shareStats;
   const root = path19.dirname(path19.dirname(source.graphPath));
   const seen = /* @__PURE__ */ new Set();
@@ -6913,12 +6945,23 @@ function createServer(source, opts = {}) {
         "no code map found. Run `vg` in the project to build .vibgrate/graph.json, then retry."
       );
     }
+    const startedAt = Date.now();
     try {
       const args = request.params.arguments ?? {};
       const result = await tool.handler(graph, args, { root, local, dedup, seen });
-      if (record) recordUsage(root, tool.name, result, detectClient(server));
+      const ms = Date.now() - startedAt;
+      stats?.record({ ...measureCall(tool.name, result), client: sanitizeClient(detectClient(server)), ms });
+      if (record) recordUsage(root, tool.name, result, detectClient(server), ms);
       return renderToolResult(result);
     } catch (err) {
+      stats?.record({
+        tool: tool.name,
+        client: sanitizeClient(detectClient(server)),
+        outcome: "miss",
+        ms: Date.now() - startedAt,
+        vgTokens: 0,
+        baselineTokens: 0
+      });
       return errorResult(`tool "${tool.name}" failed: ${err.message}`);
     }
   });
@@ -6936,7 +6979,14 @@ function sleep(ms) {
     timer.unref?.();
   });
 }
-function recordUsage(root, tool, result, client) {
+function recordUsage(root, tool, result, client, ms) {
+  recordSaving(
+    root,
+    { ...measureCall(tool, result), source: "mcp", client: sanitizeClient(client), ...ms !== void 0 ? { ms } : {} },
+    Date.now()
+  );
+}
+function measureCall(tool, result) {
   const outcome = classifyOutcome(result);
   let vgTokens = 0;
   let baselineTokens = 0;
@@ -6944,11 +6994,7 @@ function recordUsage(root, tool, result, client) {
     vgTokens = countTokens(renderedText(renderToolResult(result)));
     baselineTokens = referencedFiles(result).size * PER_FILE_TOKENS;
   }
-  recordSaving(
-    root,
-    { tool, outcome, vgTokens, baselineTokens, source: "mcp", client: sanitizeClient(client) },
-    Date.now()
-  );
+  return { tool, outcome, vgTokens, baselineTokens };
 }
 function detectClient(server) {
   try {
@@ -7564,6 +7610,6 @@ function spdx(ctx) {
   return JSON.stringify(doc, null, 2) + "\n";
 }
 
-export { ASSISTANTS, CLI_TOOL_ALIASES, CliError, ECOSYSTEMS, ExitCode, FREE_PACK, GraphIndex, GraphSource, NPX_INVOCATION, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assessDocQuality, assistantById, availableRegionIds, buildFacts, buildGraph, buildModuleResolver, cacheDir, catalogPath, clearModelCache, clearStoredCredentials, cosine, countPending, countTokens, coveringTests, createServer, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, defaultGraphPath, detectAssistants, detectRunner, detectServeLaunch, discover, discoverModels, driftCount, driftFor, dsnCommand, embeddingsCached, enrichOnline, ensureGitignored, epistemicBreakdown, exportGraph, fetchHostedDocsCached, findGitRoot, findNodes, formatForExt, getNodeEmbeddings, gitignoreEntryForCredentials, groundGraph, hasDrift, homeCredentialsPath, hostedBase, identifierParts, impactOf, indexFor, ingestHostForRegionId, installAssistant, inventory, isModelReady, isTestFile, libDir, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, localApiSurface, localPackageDocs, modelCacheInfo, nodeById, nodeEmbedText, parseDsn, parseGraph, parseJsonc, probeFreshness, projectCredentialsPath, publishPrivateLibrary, pushCommand, queryGraph, queryGraphSemantic, readDoc, readSavings, readScanArtifact, readStoredCredentials, readUsage, recordCliCall, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveCliInvocation, resolveDsn, resolveEmbedModel, resolveIngestHost, resolveLib, resolveLimits, resolveOne, resolveVersion, saveCatalog, savingsRecorded, scipEdges, selectForBudget, serializeGraph, serveStdio, shortestPath, stableStringify, symbolsFromApi, testsToRun, unavailableMessage, uninstallAssistant, uploadScanArtifact, usageError, verifyDeterminism, vibgrateDir, writeArtifacts, writeNavigationConfig, writeSnapshot, writeStoredCredentials };
-//# sourceMappingURL=chunk-H5M7CXE6.js.map
-//# sourceMappingURL=chunk-H5M7CXE6.js.map
+export { ASSISTANTS, CLI_TOOL_ALIASES, CliError, ECOSYSTEMS, ExitCode, FREE_PACK, GraphIndex, GraphSource, NPX_INVOCATION, ResourceLimitError, SAVINGS_TOOLS, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assessDocQuality, assistantById, availableRegionIds, buildFacts, buildGraph, buildModuleResolver, cacheDir, catalogPath, clearModelCache, clearStoredCredentials, cosine, countPending, countTokens, coveringTests, createServer, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, defaultGraphPath, detectAssistants, detectRunner, detectServeLaunch, discover, discoverModels, driftCount, driftFor, dsnCommand, embeddingsCached, enrichOnline, ensureGitignored, epistemicBreakdown, exportGraph, fetchHostedDocsCached, findGitRoot, findNodes, formatForExt, getNodeEmbeddings, gitignoreEntryForCredentials, groundGraph, hasDrift, homeCredentialsPath, hostedBase, identifierParts, impactOf, indexFor, ingestHostForRegionId, installAssistant, inventory, isModelReady, isTestFile, libDir, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, localApiSurface, localPackageDocs, modelCacheInfo, nodeById, nodeEmbedText, parseDsn, parseGraph, parseJsonc, probeFreshness, projectCredentialsPath, publishPrivateLibrary, pushCommand, queryGraph, queryGraphSemantic, readDoc, readSavings, readScanArtifact, readStoredCredentials, readUsage, recordCliCall, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveCliInvocation, resolveDsn, resolveEmbedModel, resolveIngestHost, resolveLib, resolveLimits, resolveOne, resolveVersion, sanitizeClient, saveCatalog, savingsLedgerPath, savingsRecorded, scipEdges, selectForBudget, serializeGraph, serveStdio, shortestPath, stableStringify, symbolsFromApi, testsToRun, unavailableMessage, uninstallAssistant, uploadScanArtifact, usageError, verifyDeterminism, vibgrateDir, writeArtifacts, writeNavigationConfig, writeSnapshot, writeStoredCredentials };
+//# sourceMappingURL=chunk-7R4O5CZD.js.map
+//# sourceMappingURL=chunk-7R4O5CZD.js.map