@vibgrate/cli 2026.718.2 → 2026.720.2

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { resolveDsn, resolveIngestHost, dashHostForIngestHost, resolveCliInvocation, availableRegionIds, createWorkspaceDsn, writeStoredCredentials, credentialsPath, findGitRoot, ensureGitignored, gitignoreEntryForCredentials, clearStoredCredentials, inventory, uploadScanArtifact, ingestHostForRegionId, dsnCommand, pushCommand, CliError, ExitCode, NPX_INVOCATION, refreshIfStale, driftCount, embeddingsCached, resolveEmbedModel, loadEmbedder, getNodeEmbeddings, queryGraphSemantic, queryGraph, unavailableMessage, recordCliCall, CLI_TOOL_ALIASES, countPending, resolveOne, indexFor, countTokens, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, serveStdio, ASSISTANTS, detectAssistants, usageError, loadGraph, detectServeLaunch, installAssistant, writeNavigationConfig, uninstallAssistant, coveringTests, FREE_PACK, readScanArtifact, enrichOnline, ECOSYSTEMS, discoverModels, readSavings, readUsage, exportGraph, catalogPath, libDir, stableStringify, buildGraph, writeArtifacts, writeSnapshot, UsageError, ResourceLimitError, epistemicBreakdown, cacheDir, probeFreshness, discover, vibgrateDir, modelCacheInfo, clearModelCache, GraphSource, createServer, assistantById, serializeGraph, resolveLimits, loadCatalog, driftFor, addLibrary, parseDsn as parseDsn$1, publishPrivateLibrary, resolveLib, libId, resolveVersion, readDoc, localPackageDocs, localApiSurface, assessDocQuality, symbolsFromApi, fetchHostedDocsCached, selectForBudget, formatForExt, hostedBase, verifyDeterminism, renderHtml, isModelReady, readStoredCredentials, projectCredentialsPath, homeCredentialsPath, SKIP_DIRS, SKIP_FILES } from './chunk-H5M7CXE6.js';
-import { resolvedGrammarFiles, grammarSetVersion, hashString, canonicalize, hashBytes } from './chunk-VFO5UDAT.js';
-import { loadAdvancedScanHook, baselineCommand } from './chunk-BFXDF6ZE.js';
-import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, loadConfig, prepareCompressedUpload, computeDriftScore, titleBox, projectTypeToVulnEcosystem, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, PROJECT_TYPE_TO_OSV_ECOSYSTEM, fetchRiskySymbols, brandProgressBar, resolveHead, workingTreeDirty } from './chunk-RME7BFMU.js';
+import { resolveDsn, resolveIngestHost, dashHostForIngestHost, resolveCliInvocation, availableRegionIds, createWorkspaceDsn, writeStoredCredentials, credentialsPath, findGitRoot, ensureGitignored, gitignoreEntryForCredentials, clearStoredCredentials, inventory, uploadScanArtifact, ingestHostForRegionId, dsnCommand, pushCommand, CliError, ExitCode, NPX_INVOCATION, refreshIfStale, driftCount, embeddingsCached, resolveEmbedModel, loadEmbedder, getNodeEmbeddings, queryGraphSemantic, queryGraph, unavailableMessage, recordCliCall, CLI_TOOL_ALIASES, countPending, resolveOne, indexFor, countTokens, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, savingsLedgerPath, serveStdio, ASSISTANTS, detectAssistants, usageError, loadGraph, detectServeLaunch, installAssistant, writeNavigationConfig, uninstallAssistant, coveringTests, FREE_PACK, readScanArtifact, enrichOnline, ECOSYSTEMS, discoverModels, readSavings, readUsage, exportGraph, catalogPath, libDir, stableStringify, buildGraph, writeArtifacts, writeSnapshot, UsageError, ResourceLimitError, epistemicBreakdown, cacheDir, probeFreshness, discover, vibgrateDir, modelCacheInfo, clearModelCache, GraphSource, createServer, assistantById, serializeGraph, resolveLimits, loadCatalog, driftFor, addLibrary, parseDsn as parseDsn$1, publishPrivateLibrary, resolveLib, libId, resolveVersion, readDoc, localPackageDocs, localApiSurface, assessDocQuality, symbolsFromApi, fetchHostedDocsCached, selectForBudget, formatForExt, hostedBase, verifyDeterminism, renderHtml, isModelReady, SAVINGS_TOOLS, sanitizeClient, readStoredCredentials, projectCredentialsPath, homeCredentialsPath, SKIP_DIRS, SKIP_FILES } from './chunk-7R4O5CZD.js';
+import { resolvedGrammarFiles, grammarSetVersion, hashString, canonicalize, hashBytes } from './chunk-BHA7QIPD.js';
+import { loadAdvancedScanHook, baselineCommand } from './chunk-DDQ5JGBV.js';
+import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, loadConfig, prepareCompressedUpload, computeDriftScore, titleBox, projectTypeToVulnEcosystem, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, PROJECT_TYPE_TO_OSV_ECOSYSTEM, fetchRiskySymbols, brandProgressBar, resolveHead, workingTreeDirty } from './chunk-OD5654VF.js';
 import './chunk-RXP66R2E.js';
 import { pathExists as pathExists$1, parseExcludePatterns } from './chunk-GI6W53LM.js';
-import * as fs8 from 'fs';
-import fs8__default, { realpathSync } from 'fs';
+import * as fs9 from 'fs';
+import fs9__default, { realpathSync } from 'fs';
 import * as path from 'path';
 import path__default from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
@@ -16,7 +16,7 @@ import * as crypto from 'crypto';
 import { randomUUID } from 'crypto';
 import chalk8 from 'chalk';
 import * as os from 'os';
-import * as fs15 from 'fs/promises';
+import * as fs16 from 'fs/promises';
 import * as readline from 'readline';
 import semver from 'semver';
 
@@ -178,14 +178,14 @@ async function signGraphAttestation(root, graph, opts) {
   const explicitKey = opts.key ?? process.env.VG_ATTEST_KEY;
   const keyPath = explicitKey ? path.resolve(explicitKey) : path.join(root, ".vibgrate", DEFAULT_KEY);
   let keyGeneratedAt;
-  if (!fs8.existsSync(keyPath)) {
+  if (!fs9.existsSync(keyPath)) {
     if (explicitKey) {
       throw new CliError(`signing key not found: ${explicitKey}`, ExitCode.USAGE_ERROR);
     }
     const kp = generateKeypair();
-    fs8.mkdirSync(path.dirname(keyPath), { recursive: true });
-    fs8.writeFileSync(keyPath, kp.privatePem, { mode: 384 });
-    fs8.writeFileSync(`${keyPath}.pub`, kp.publicPem);
+    fs9.mkdirSync(path.dirname(keyPath), { recursive: true });
+    fs9.writeFileSync(keyPath, kp.privatePem, { mode: 384 });
+    fs9.writeFileSync(`${keyPath}.pub`, kp.publicPem);
     keyGeneratedAt = keyPath;
     notices.push(
       `minted a new Ed25519 signing key at ${rel(root, keyPath)} (keyid ${kp.keyid}) \u2014 keep it, add it to .gitignore, and reuse it to re-sign reproducibly`
@@ -193,7 +193,7 @@ async function signGraphAttestation(root, graph, opts) {
   }
   let privateKey;
   try {
-    privateKey = crypto.createPrivateKey(fs8.readFileSync(keyPath, "utf8"));
+    privateKey = crypto.createPrivateKey(fs9.readFileSync(keyPath, "utf8"));
   } catch {
     throw new CliError(`could not read an Ed25519 private key from ${rel(root, keyPath)}`, ExitCode.USAGE_ERROR);
   }
@@ -207,8 +207,8 @@ async function signGraphAttestation(root, graph, opts) {
   const statement = buildStatement(graph, { commit });
   const envelope = signStatement(statement, privateKey);
   const outPath = opts.attestation ? path.resolve(opts.attestation) : path.join(root, ".vibgrate", DEFAULT_ATTESTATION);
-  fs8.mkdirSync(path.dirname(outPath), { recursive: true });
-  fs8.writeFileSync(outPath, serializeEnvelope(envelope));
+  fs9.mkdirSync(path.dirname(outPath), { recursive: true });
+  fs9.writeFileSync(outPath, serializeEnvelope(envelope));
   return {
     summary: {
       keyid: envelope.signatures[0]?.keyid ?? "",
@@ -223,7 +223,7 @@ async function signGraphAttestation(root, graph, opts) {
 }
 function verifyGraphAttestation(root, opts) {
   const bundlePath = opts.attestation ? path.resolve(opts.attestation) : path.join(root, ".vibgrate", DEFAULT_ATTESTATION);
-  if (!fs8.existsSync(bundlePath)) {
+  if (!fs9.existsSync(bundlePath)) {
     if (opts.attestation || opts.pub) {
       throw new CliError(
         `no attestation at ${rel(root, bundlePath)} \u2014 sign one with \`vg build --attest\``,
@@ -232,8 +232,8 @@ function verifyGraphAttestation(root, opts) {
     }
     return { bundlePath, missing: true };
   }
-  const envelope = parseEnvelope(fs8.readFileSync(bundlePath, "utf8"));
-  const publicKeyPem = opts.pub ? fs8.readFileSync(path.resolve(opts.pub), "utf8") : void 0;
+  const envelope = parseEnvelope(fs9.readFileSync(bundlePath, "utf8"));
+  const publicKeyPem = opts.pub ? fs9.readFileSync(path.resolve(opts.pub), "utf8") : void 0;
   const graph = loadGraph(root) ?? void 0;
   return { bundlePath, missing: false, result: verifyEnvelope(envelope, { publicKeyPem, graph }) };
 }
@@ -288,21 +288,23 @@ var ROBOT = [
   "  " + c.dim("\u2524") + teal("\u2502") + "  " + c.dim("\u2581\u2581") + "  " + teal("\u2502") + c.dim("\u251C"),
   "   " + teal("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u256F")
 ];
-function logoLines(root) {
+function logoLines(root, opts = {}) {
+  const product = opts.product ?? "Graph";
+  const tagline = opts.tagline ?? "Code Intelligence Engine";
   return [
     "",
     `  ${ROBOT[0]}`,
     `  ${ROBOT[1]}`,
     `  ${ROBOT[2]}`,
     `  ${ROBOT[3]}`,
-    `  ${c.bold.white("Vibgrate")} ${teal("Graph")}  ${c.dim(`\xB7 Code Intelligence Engine \xB7 v${VERSION}`)}`,
+    `  ${c.bold.white("Vibgrate")} ${teal(product)}  ${c.dim(`\xB7 ${tagline} \xB7 v${VERSION}`)}`,
     ...root ? [`  ${c.dim(root)}`] : [],
     ""
   ];
 }
-function printLogo(root) {
+function printLogo(root, opts = {}) {
   if (!process.stderr.isTTY) return;
-  process.stderr.write(`${logoLines(root).join("\n")}
+  process.stderr.write(`${logoLines(root, opts).join("\n")}
 `);
 }
 
@@ -584,8 +586,8 @@ function writeExport(graph, target) {
         ExitCode.USAGE_ERROR
       );
   }
-  fs8.mkdirSync(path.dirname(path.resolve(target)), { recursive: true });
-  fs8.writeFileSync(target, content);
+  fs9.mkdirSync(path.dirname(path.resolve(target)), { recursive: true });
+  fs9.writeFileSync(target, content);
 }
 function collect(value, prev) {
   return [...prev, value];
@@ -604,7 +606,7 @@ async function runStatus(global) {
   const root = path.resolve(global.cwd ?? ".");
   const graphPath = global.graph ?? defaultGraphPath(root);
   const graph = loadGraph(root, graphPath);
-  const hasCache = fs8.existsSync(path.join(cacheDir(root), "parse-cache.json"));
+  const hasCache = fs9.existsSync(path.join(cacheDir(root), "parse-cache.json"));
   let stale = null;
   let staleExact = false;
   if (graph) {
@@ -1313,14 +1315,14 @@ function isCI(env = process.env) {
 function installId(env = process.env) {
   if (telemetryOptOut(env) !== null || isCI(env)) return randomUuid();
   try {
-    const existing = fs8.readFileSync(INSTALL_ID_FILE, "utf8").trim();
+    const existing = fs9.readFileSync(INSTALL_ID_FILE, "utf8").trim();
     if (isUuid(existing)) return existing;
   } catch {
   }
   const id = randomUuid();
   try {
-    fs8.mkdirSync(INSTALL_ID_DIR, { recursive: true });
-    fs8.writeFileSync(INSTALL_ID_FILE, id + "\n", { mode: 384 });
+    fs9.mkdirSync(INSTALL_ID_DIR, { recursive: true });
+    fs9.writeFileSync(INSTALL_ID_FILE, id + "\n", { mode: 384 });
   } catch {
   }
   return id;
@@ -1344,7 +1346,7 @@ function ledgerFilePath(root) {
 }
 function readOffset(root) {
   try {
-    const raw = JSON.parse(fs8.readFileSync(offsetPath(root), "utf8"));
+    const raw = JSON.parse(fs9.readFileSync(offsetPath(root), "utf8"));
     return typeof raw.offset === "number" && raw.offset >= 0 ? raw.offset : 0;
   } catch {
     return 0;
@@ -1352,8 +1354,8 @@ function readOffset(root) {
 }
 function writeOffset(root, offset) {
   try {
-    fs8.mkdirSync(cacheDir(root), { recursive: true });
-    fs8.writeFileSync(offsetPath(root), JSON.stringify({ offset }) + "\n");
+    fs9.mkdirSync(cacheDir(root), { recursive: true });
+    fs9.writeFileSync(offsetPath(root), JSON.stringify({ offset }) + "\n");
   } catch {
   }
 }
@@ -1361,7 +1363,7 @@ function buildBatch(root, fromOffset, id = installId()) {
   const file = ledgerFilePath(root);
   let size = 0;
   try {
-    size = fs8.statSync(file).size;
+    size = fs9.statSync(file).size;
   } catch {
     return { batch: null, newOffset: 0 };
   }
@@ -1369,13 +1371,13 @@ function buildBatch(root, fromOffset, id = installId()) {
   if (start >= size) return { batch: null, newOffset: size };
   let text = "";
   try {
-    const fd = fs8.openSync(file, "r");
+    const fd = fs9.openSync(file, "r");
     try {
       const buf = Buffer.alloc(size - start);
-      fs8.readSync(fd, buf, 0, buf.length, start);
+      fs9.readSync(fd, buf, 0, buf.length, start);
       text = buf.toString("utf8");
     } finally {
-      fs8.closeSync(fd);
+      fs9.closeSync(fd);
     }
   } catch {
     return { batch: null, newOffset: fromOffset };
@@ -1508,6 +1510,317 @@ function isLoopbackOrigin(origin) {
   return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(host);
 }
 
+// src/mcp/serve-stats.ts
+function zeroRow(key2) {
+  return { key: key2, calls: 0, complete: 0, partial: 0, miss: 0, timed: 0, totalMs: 0, vgTokens: 0, baselineTokens: 0 };
+}
+var SessionStats = class {
+  startedAt;
+  revision = 0;
+  lastCallAt = null;
+  totals = zeroRow("total");
+  byClient = /* @__PURE__ */ new Map();
+  byTool = /* @__PURE__ */ new Map();
+  bySource = /* @__PURE__ */ new Map();
+  constructor(now2 = Date.now()) {
+    this.startedAt = now2;
+  }
+  record(sample, now2 = Date.now()) {
+    this.revision++;
+    this.lastCallAt = now2;
+    const rows = [
+      this.totals,
+      this.rowFor(this.byClient, sample.client),
+      this.rowFor(this.byTool, sample.tool),
+      this.rowFor(this.bySource, sample.source ?? "mcp")
+    ];
+    for (const row of rows) {
+      row.calls++;
+      row[sample.outcome]++;
+      if (typeof sample.ms === "number") {
+        row.timed++;
+        row.totalMs += sample.ms;
+      }
+      row.vgTokens += sample.vgTokens;
+      row.baselineTokens += sample.baselineTokens;
+    }
+  }
+  snapshot() {
+    const sorted = (m) => [...m.values()].map((r) => ({ ...r })).sort((a, b) => b.calls - a.calls || a.key.localeCompare(b.key));
+    return {
+      startedAt: this.startedAt,
+      revision: this.revision,
+      lastCallAt: this.lastCallAt,
+      totals: { ...this.totals },
+      clients: sorted(this.byClient),
+      tools: sorted(this.byTool),
+      sources: sorted(this.bySource)
+    };
+  }
+  rowFor(m, key2) {
+    let row = m.get(key2);
+    if (!row) {
+      row = zeroRow(key2);
+      m.set(key2, row);
+    }
+    return row;
+  }
+};
+function fmtUptime(ms) {
+  const s = Math.max(0, Math.floor(ms / 1e3));
+  if (s < 60) return `${s}s`;
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m}m ${String(s % 60).padStart(2, "0")}s`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h}h ${String(m % 60).padStart(2, "0")}m`;
+  const d = Math.floor(h / 24);
+  return `${d}d ${String(h % 24).padStart(2, "0")}h`;
+}
+function fmtTokens(n) {
+  if (n >= 1e6) return `${(n / 1e6).toFixed(2)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
+  return String(n);
+}
+function fmtAvgMs(row) {
+  if (row.timed === 0) return "\u2014";
+  const avg = row.totalMs / row.timed;
+  return avg >= 1e3 ? `${(avg / 1e3).toFixed(1)}s` : `${Math.round(avg)}ms`;
+}
+var teal2 = (s) => c.hex("#3FB0A4")(s);
+var mint2 = (s) => c.hex("#4FE3C1")(s);
+var SPINNER = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var MAX_TOOL_ROWS = 8;
+function serveStatusLines(snap, now2, tick = 0) {
+  const spinner = mint2(SPINNER[tick % SPINNER.length]);
+  const up = fmtUptime(now2 - snap.startedAt);
+  const lines = [];
+  if (snap.totals.calls === 0) {
+    lines.push(
+      `  ${spinner} ${c.bold.white("vg serve")} ${c.dim("\xB7")} up ${teal2(up)} ${c.dim("\xB7 waiting for your assistant\u2019s first call (MCP tool call, or `vg \u2026 --client=<ai>` CLI)\u2026")}`
+    );
+    return lines;
+  }
+  const t = snap.totals;
+  const answered = Math.round((t.complete + t.partial) / t.calls * 100);
+  const cli = snap.sources.find((s) => s.key === "cli");
+  const via = cli ? c.dim(" \xB7 via ") + snap.sources.map((s) => `${c.white(s.key)} ${teal2(String(s.calls))}`).join(c.dim(" \xB7 ")) : "";
+  const ago = snap.lastCallAt === null ? "" : c.dim(` \xB7 last call ${fmtUptime(now2 - snap.lastCallAt)} ago`);
+  lines.push(
+    `  ${spinner} ${c.bold.white("vg serve")} ${c.dim("\xB7")} up ${teal2(up)} ${c.dim("\xB7")} ${c.bold.white(String(t.calls))} call${t.calls === 1 ? "" : "s"} ${c.dim("\xB7")} ${mint2(`${answered}%`)} answered${via}${ago}`
+  );
+  lines.push(
+    `    ${c.dim("clients")}  ` + snap.clients.map((cl) => `${c.white(cl.key)} ${teal2(String(cl.calls))}${c.dim(` (avg ${fmtAvgMs(cl)})`)}`).join(c.dim(" \xB7 "))
+  );
+  const shown = snap.tools.slice(0, MAX_TOOL_ROWS);
+  const nameW = Math.max(...shown.map((r) => r.key.length));
+  for (const row of shown) {
+    let line = `    ${c.white(row.key.padEnd(nameW))}  ${teal2(String(row.calls).padStart(4))} ${c.dim("\xB7")} ` + c.dim(`avg ${fmtAvgMs(row)}`);
+    if (SAVINGS_TOOLS.has(row.key) && row.baselineTokens > 0) {
+      line += c.dim(" \xB7 ctx ") + c.white(fmtTokens(row.vgTokens)) + c.dim(` vs \u2248${fmtTokens(row.baselineTokens)} grep/read`);
+    }
+    if (row.miss > 0) line += c.dim(" \xB7 ") + c.yellow(`${row.miss} miss`);
+    lines.push(line);
+  }
+  if (snap.tools.length > shown.length) {
+    lines.push(`    ${c.dim(`\u2026 +${snap.tools.length - shown.length} more tools`)}`);
+  }
+  if (t.baselineTokens > 0) {
+    const savedTokens = Math.max(0, t.baselineTokens - t.vgTokens);
+    const ratio = t.vgTokens > 0 ? (t.baselineTokens / t.vgTokens).toFixed(1) : "\u2014";
+    lines.push(
+      `    ${c.dim("session")}  ctx ${c.bold.white(fmtTokens(t.vgTokens))} ` + c.dim(`vs grep/read \u2248${fmtTokens(t.baselineTokens)} \u2192 `) + mint2(`${ratio}\xD7 fewer`)
+    );
+    lines.push(
+      `    ${c.dim("est. saved \u2248")} ${mint2(`${fmtTokens(savedTokens)} context tokens`)} ${c.dim("(estimate)")}`
+    );
+  }
+  return lines;
+}
+function serveHeartbeatLine(snap, now2) {
+  const up = fmtUptime(now2 - snap.startedAt);
+  const t = snap.totals;
+  if (t.calls === 0) return c.dim(`vg \xB7 serving for ${up} \u2014 no tool calls yet`);
+  const clients = snap.clients.map((cl) => `${cl.key} ${cl.calls}`).join(", ");
+  const cli = snap.sources.find((s) => s.key === "cli");
+  let line = `vg \xB7 serving for ${up} \u2014 ${t.calls} call${t.calls === 1 ? "" : "s"} (${clients})`;
+  if (cli) line += ` \xB7 ${cli.calls} via CLI`;
+  if (t.baselineTokens > 0) {
+    const savedTokens = Math.max(0, t.baselineTokens - t.vgTokens);
+    line += ` \xB7 ctx ${fmtTokens(t.vgTokens)} vs \u2248${fmtTokens(t.baselineTokens)} grep/read \xB7 est. saved \u2248 ${fmtTokens(savedTokens)} tokens`;
+  }
+  return c.dim(line);
+}
+var TTY_INTERVAL_MS = 1e3;
+var HEARTBEAT_INTERVAL_MS = 15 * 60 * 1e3;
+var ServeStatusDisplay = class {
+  constructor(stats, stream = process.stderr) {
+    this.stats = stats;
+    this.stream = stream;
+    this.isTTY = (stream.isTTY ?? false) && process.env.VIBGRATE_PROGRESS_MODE !== "plain";
+  }
+  stats;
+  stream;
+  timer = null;
+  tick = 0;
+  lastRowCount = 0;
+  lastFrame = "";
+  lastHeartbeatRevision = -1;
+  cursorHidden = false;
+  isTTY;
+  start() {
+    if (this.timer) return;
+    if (this.isTTY) {
+      this.hideCursor();
+      process.on("exit", this.restoreCursor);
+      process.once("SIGINT", () => {
+        this.restoreCursor();
+        process.exit(130);
+      });
+      process.once("SIGTERM", () => {
+        this.restoreCursor();
+        process.exit(143);
+      });
+      this.timer = setInterval(() => this.renderTTY(), TTY_INTERVAL_MS);
+      this.renderTTY();
+    } else {
+      this.timer = setInterval(() => this.renderHeartbeat(), HEARTBEAT_INTERVAL_MS);
+    }
+    this.timer.unref?.();
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    if (this.isTTY) {
+      let buf = "";
+      if (this.lastRowCount > 0) buf += `\x1B[${this.lastRowCount}A\x1B[J`;
+      this.stream.write(buf);
+      this.lastRowCount = 0;
+      this.restoreCursor();
+    }
+  }
+  renderTTY() {
+    this.tick++;
+    const lines = serveStatusLines(this.stats.snapshot(), Date.now(), this.tick);
+    const content = lines.join("\n") + "\n";
+    if (content === this.lastFrame) return;
+    this.lastFrame = content;
+    let buf = "";
+    if (this.lastRowCount > 0) buf += `\x1B[${this.lastRowCount}A\x1B[J`;
+    buf += content;
+    this.stream.write(buf);
+    this.lastRowCount = this.countRows(lines);
+  }
+  renderHeartbeat() {
+    const snap = this.stats.snapshot();
+    if (snap.revision === this.lastHeartbeatRevision) return;
+    this.lastHeartbeatRevision = snap.revision;
+    this.stream.write(serveHeartbeatLine(snap, Date.now()) + "\n");
+  }
+  /** Terminal rows the frame occupies, accounting for line wrap. */
+  countRows(lines) {
+    const columns = Math.max(this.stream.columns ?? 80, 20);
+    return lines.reduce((total, line) => {
+      const visible = line.replace(/\x1b\[[0-9;]*m/g, "").length;
+      return total + Math.max(1, Math.ceil(visible / columns));
+    }, 0);
+  }
+  hideCursor() {
+    if (this.cursorHidden) return;
+    this.stream.write("\x1B[?25l");
+    this.cursorHidden = true;
+  }
+  restoreCursor = () => {
+    if (!this.cursorHidden) return;
+    this.stream.write("\x1B[?25h");
+    this.cursorHidden = false;
+  };
+};
+var POLL_INTERVAL_MS = 2e3;
+var LedgerTail = class {
+  constructor(file, stats, intervalMs = POLL_INTERVAL_MS) {
+    this.file = file;
+    this.stats = stats;
+    this.intervalMs = intervalMs;
+  }
+  file;
+  stats;
+  intervalMs;
+  timer = null;
+  /** Byte offset of the next unread ledger byte (always at a line boundary). */
+  offset = 0;
+  start() {
+    if (this.timer) return;
+    this.offset = this.sizeOf();
+    this.timer = setInterval(() => this.poll(), this.intervalMs);
+    this.timer.unref?.();
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+  /** One poll cycle — exposed for tests (deterministic, no timers needed). */
+  poll(now2 = Date.now()) {
+    let size;
+    try {
+      size = this.sizeOf();
+    } catch {
+      return;
+    }
+    if (size < this.offset) this.offset = 0;
+    if (size === this.offset) return;
+    let chunk;
+    try {
+      const fd = fs9.openSync(this.file, "r");
+      try {
+        chunk = Buffer.alloc(size - this.offset);
+        fs9.readSync(fd, chunk, 0, chunk.length, this.offset);
+      } finally {
+        fs9.closeSync(fd);
+      }
+    } catch {
+      return;
+    }
+    const lastNewline = chunk.lastIndexOf(10);
+    if (lastNewline < 0) return;
+    const text = chunk.subarray(0, lastNewline).toString("utf8");
+    this.offset += lastNewline + 1;
+    for (const line of text.split("\n")) ingestLedgerLine(this.stats, line, now2);
+  }
+  sizeOf() {
+    try {
+      return fs9.statSync(this.file).size;
+    } catch {
+      return 0;
+    }
+  }
+};
+function ingestLedgerLine(stats, line, now2) {
+  if (!line.trim()) return;
+  let e;
+  try {
+    e = JSON.parse(line);
+  } catch {
+    return;
+  }
+  if (e.source !== "cli" || typeof e.tool !== "string") return;
+  stats.record(
+    {
+      tool: e.tool,
+      client: sanitizeClient(e.client),
+      outcome: e.outcome ?? "complete",
+      source: "cli",
+      // CLI lines carry no wall time — leave ms absent ("not measured").
+      vgTokens: e.vgTokens ?? 0,
+      baselineTokens: e.baselineTokens ?? 0
+    },
+    now2
+  );
+}
+
 // src/commands/serve.ts
 var SHARE_FLUSH_INTERVAL_MS = 5 * 60 * 1e3;
 function registerServe(program) {
@@ -1519,6 +1832,11 @@ function registerServe(program) {
     const local = global.local === true;
     const optOut = telemetryOptOut();
     const shareStats = opts.shareStats === true && !local && optOut === null;
+    const quiet = global.quiet === true;
+    const stats = quiet ? void 0 : new SessionStats();
+    if (!quiet) {
+      printLogo(root, { product: "AI Context", tagline: "Local-first MCP for your AI" });
+    }
     const serveOpts = {
       // A *requested* --share-stats always implies local recording, even when
       // the upload itself is suppressed (--local / env opt-out) — the local
@@ -1528,7 +1846,8 @@ function registerServe(program) {
       shareStats,
       local,
       dedup: opts.dedup === true,
-      refresh
+      refresh,
+      stats
     };
     await ensureServableGraph(root, graphPath, global, refresh);
     if (opts.shareStats === true && local) {
@@ -1537,19 +1856,22 @@ function registerServe(program) {
       info(c.dim(`vg \xB7 --share-stats disabled by ${optOut}: recording locally, not uploading.`));
     }
     if (shareStats) startSharing(root);
+    const display = stats ? new ServeStatusDisplay(stats) : void 0;
+    if (stats) new LedgerTail(savingsLedgerPath(root), stats).start();
     const freshness = refresh ? "auto-refresh" : "as built";
     if (opts.http) {
-      await serveHttp(graphPath, opts.host ?? "127.0.0.1", Number(opts.port) || 7437, serveOpts, freshness);
+      await serveHttp(graphPath, opts.host ?? "127.0.0.1", Number(opts.port) || 7437, serveOpts, freshness, () => display?.start());
     } else {
       info(c.dim(`vg \xB7 MCP server on stdio (read-only, ${freshness}). Connect your assistant to this process.`));
       await serveStdio(graphPath, serveOpts);
+      display?.start();
     }
   });
   applyGlobalOptions(cmd);
 }
 async function ensureServableGraph(root, graphPath, global, refresh, opts = {}) {
   if (refresh) {
-    if (!fs8.existsSync(graphPath)) {
+    if (!fs9.existsSync(graphPath)) {
       info(c.dim("vg \xB7 no map found \u2014 building it before serving\u2026"));
       await runBuild(
         [],
@@ -1566,7 +1888,7 @@ async function ensureServableGraph(root, graphPath, global, refresh, opts = {})
       }
     }
   }
-  if (!fs8.existsSync(graphPath)) {
+  if (!fs9.existsSync(graphPath)) {
     throw new CliError(
       `no map found at ${graphPath} \u2014 run \`vg\` to build one first`,
       ExitCode.NOT_FOUND
@@ -1598,7 +1920,7 @@ function startSharing(root) {
   });
   process.once("beforeExit", finalFlush);
 }
-async function serveHttp(graphPath, host, port, opts, freshness) {
+async function serveHttp(graphPath, host, port, opts, freshness, onReady) {
   const { createServer: createHttp } = await import('http');
   const { StreamableHTTPServerTransport } = await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
   const source = new GraphSource(graphPath, opts.refresh !== false);
@@ -1630,6 +1952,7 @@ async function serveHttp(graphPath, host, port, opts, freshness) {
   });
   await new Promise((resolve17) => httpServer.listen(port, host, resolve17));
   info(c.dim(`vg \xB7 MCP server on http://${host}:${port}/mcp (read-only, local, ${freshness})`));
+  onReady?.();
   await new Promise(() => {
   });
 }
@@ -1848,7 +2171,7 @@ function manifestHash(root) {
   const walk2 = (dir) => {
     let entries;
     try {
-      entries = fs8.readdirSync(dir, { withFileTypes: true });
+      entries = fs9.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -1864,7 +2187,7 @@ function manifestHash(root) {
       if (!isManifest(abs) && !SKIP_FILES.has(base)) continue;
       try {
         const rel3 = path.relative(root, abs).split(path.sep).join("/");
-        files.push({ rel: rel3, hash: hashBytes(fs8.readFileSync(abs)) });
+        files.push({ rel: rel3, hash: hashBytes(fs9.readFileSync(abs)) });
       } catch {
       }
     }
@@ -1875,7 +2198,7 @@ function manifestHash(root) {
 }
 function loadScanCache(root, key2) {
   try {
-    const raw = JSON.parse(fs8.readFileSync(cachePath(root), "utf8"));
+    const raw = JSON.parse(fs9.readFileSync(cachePath(root), "utf8"));
     if (raw.version === CACHE_VERSION && raw.manifestHash === key2.manifestHash && raw.toolVersion === key2.toolVersion && raw.offline === key2.offline && raw.artifact) {
       return { manifestHash: raw.manifestHash, artifact: raw.artifact };
     }
@@ -1885,8 +2208,8 @@ function loadScanCache(root, key2) {
 }
 function writeScanCache(root, key2, artifact) {
   try {
-    fs8.mkdirSync(cacheDir(root), { recursive: true });
-    fs8.writeFileSync(
+    fs9.mkdirSync(cacheDir(root), { recursive: true });
+    fs9.writeFileSync(
       cachePath(root),
       stableStringify(
         { version: CACHE_VERSION, manifestHash: key2.manifestHash, toolVersion: key2.toolVersion, offline: key2.offline, artifact },
@@ -2710,7 +3033,7 @@ function hoverMarkdown(dep, contribution) {
   return lines.join("\n");
 }
 function startLanguageServer(opts) {
-  if (!fs8.existsSync(opts.root)) {
+  if (!fs9.existsSync(opts.root)) {
     process.stderr.write(`vg lsp: root does not exist: ${opts.root}
 `);
     process.exit(1);
@@ -2849,7 +3172,7 @@ function registerShare(program) {
     const global = readGlobal(this);
     const root = rootOf(global);
     const gitDir = path.join(root, ".git");
-    if (!fs8.existsSync(gitDir)) {
+    if (!fs9.existsSync(gitDir)) {
       throw new CliError("not a git repository \u2014 run `vg share` inside a git repo", ExitCode.USAGE_ERROR);
     }
     if (opts.undo) {
@@ -2871,22 +3194,22 @@ function registerShare(program) {
 }
 function writeVibgrateGitignore(root, reports) {
   const dir = path.join(root, ".vibgrate");
-  fs8.mkdirSync(dir, { recursive: true });
+  fs9.mkdirSync(dir, { recursive: true });
   const lines = ["# Managed by `vg share` \u2014 keep graph.json committed, ignore the rest", "cache/", "facts.jsonl"];
   if (!reports) lines.push("graph.html", "GRAPH_REPORT.md");
-  fs8.writeFileSync(path.join(dir, ".gitignore"), `${lines.join("\n")}
+  fs9.writeFileSync(path.join(dir, ".gitignore"), `${lines.join("\n")}
 `);
 }
 function writeGitAttributes(root) {
   const file = path.join(root, ".gitattributes");
   const line = ".vibgrate/graph.json merge=vg";
-  let content = fs8.existsSync(file) ? fs8.readFileSync(file, "utf8") : "";
+  let content = fs9.existsSync(file) ? fs9.readFileSync(file, "utf8") : "";
   if (!content.split("\n").some((l) => l.trim() === line)) {
     content = content.length ? `${content.replace(/\s*$/, "")}
 ${line}
 ` : `${line}
 `;
-    fs8.writeFileSync(file, content);
+    fs9.writeFileSync(file, content);
   }
 }
 function configureMergeDriver(root) {
@@ -2895,7 +3218,7 @@ function configureMergeDriver(root) {
 }
 function installPreCommitHook(root) {
   const hooksDir = hookDir(root);
-  fs8.mkdirSync(hooksDir, { recursive: true });
+  fs9.mkdirSync(hooksDir, { recursive: true });
   const file = path.join(hooksDir, "pre-commit");
   const block = [
     HOOK_BEGIN,
@@ -2905,7 +3228,7 @@ function installPreCommitHook(root) {
     "fi",
     HOOK_END
   ].join("\n");
-  let content = fs8.existsSync(file) ? fs8.readFileSync(file, "utf8") : "#!/bin/sh\n";
+  let content = fs9.existsSync(file) ? fs9.readFileSync(file, "utf8") : "#!/bin/sh\n";
   const re = new RegExp(`${escapeRe(HOOK_BEGIN)}[\\s\\S]*?${escapeRe(HOOK_END)}`);
   if (re.test(content)) content = content.replace(re, block);
   else content = `${content.replace(/\s*$/, "")}
@@ -2914,21 +3237,21 @@ ${block}
 `;
   if (!content.startsWith("#!")) content = `#!/bin/sh
 ${content}`;
-  fs8.writeFileSync(file, content);
-  fs8.chmodSync(file, 493);
+  fs9.writeFileSync(file, content);
+  fs9.chmodSync(file, 493);
 }
 function undo(root) {
   const hookFile = path.join(hookDir(root), "pre-commit");
-  if (fs8.existsSync(hookFile)) {
+  if (fs9.existsSync(hookFile)) {
     const re = new RegExp(`\\n*${escapeRe(HOOK_BEGIN)}[\\s\\S]*?${escapeRe(HOOK_END)}\\n*`);
-    const next2 = fs8.readFileSync(hookFile, "utf8").replace(re, "\n");
-    if (next2.trim() === "#!/bin/sh") fs8.rmSync(hookFile);
-    else fs8.writeFileSync(hookFile, next2);
+    const next2 = fs9.readFileSync(hookFile, "utf8").replace(re, "\n");
+    if (next2.trim() === "#!/bin/sh") fs9.rmSync(hookFile);
+    else fs9.writeFileSync(hookFile, next2);
   }
   const attr = path.join(root, ".gitattributes");
-  if (fs8.existsSync(attr)) {
-    const next2 = fs8.readFileSync(attr, "utf8").split("\n").filter((l) => l.trim() !== ".vibgrate/graph.json merge=vg").join("\n");
-    fs8.writeFileSync(attr, next2);
+  if (fs9.existsSync(attr)) {
+    const next2 = fs9.readFileSync(attr, "utf8").split("\n").filter((l) => l.trim() !== ".vibgrate/graph.json merge=vg").join("\n");
+    fs9.writeFileSync(attr, next2);
   }
   try {
     git(root, ["config", "--remove-section", "merge.vg"]);
@@ -3061,7 +3384,7 @@ function grepBaselineTokens(term, files) {
     if (f.size > 512 * 1024) continue;
     let content = "";
     try {
-      content = fs8.readFileSync(f.abs, "utf8");
+      content = fs9.readFileSync(f.abs, "utf8");
     } catch {
       continue;
     }
@@ -3071,7 +3394,7 @@ function grepBaselineTokens(term, files) {
 }
 function safeSize(abs) {
   try {
-    return fs8.statSync(abs).size;
+    return fs9.statSync(abs).size;
   } catch {
     return 0;
   }
@@ -3405,7 +3728,7 @@ function loadStandards(root) {
     const p = path__default.join(root, rel3);
     let text;
     try {
-      text = fs8__default.readFileSync(p, "utf8");
+      text = fs9__default.readFileSync(p, "utf8");
     } catch {
       continue;
     }
@@ -3558,17 +3881,18 @@ function printBreakdown(usage) {
   info("");
   info(c.bold("  by command") + c.dim("  (complete = full result \xB7 partial = capped/paginated \xB7 miss = no result)"));
   const nameW = Math.max(7, ...usage.commands.map((cmd) => cmd.tool.length));
-  const header = "    " + "command".padEnd(nameW) + ["calls", "complete", "partial", "miss", "success%"].map((h) => h.padStart(9)).join("");
+  const header = "    " + "command".padEnd(nameW) + ["calls", "complete", "partial", "miss", "success%", "avg ms"].map((h) => h.padStart(9)).join("");
   info(c.dim(header));
   for (const cmd of usage.commands) {
     info(
-      "    " + cmd.tool.padEnd(nameW) + String(cmd.calls).padStart(9) + String(cmd.complete).padStart(9) + String(cmd.partial).padStart(9) + String(cmd.miss).padStart(9) + `${cmd.successPct}%`.padStart(9)
+      "    " + cmd.tool.padEnd(nameW) + String(cmd.calls).padStart(9) + String(cmd.complete).padStart(9) + String(cmd.partial).padStart(9) + String(cmd.miss).padStart(9) + `${cmd.successPct}%`.padStart(9) + // Absent ≠ zero: calls recorded before timing existed show '—'.
+      (cmd.avgMs === null ? "\u2014" : String(cmd.avgMs)).padStart(9)
     );
   }
   const t = usage.totals;
-  info(c.dim("    " + "\u2500".repeat(nameW + 45)));
+  info(c.dim("    " + "\u2500".repeat(nameW + 54)));
   info(
-    "    " + c.bold("total".padEnd(nameW)) + String(t.calls).padStart(9) + String(t.complete).padStart(9) + String(t.partial).padStart(9) + String(t.miss).padStart(9) + "".padStart(9)
+    "    " + c.bold("total".padEnd(nameW)) + String(t.calls).padStart(9) + String(t.complete).padStart(9) + String(t.partial).padStart(9) + String(t.miss).padStart(9) + "".padStart(9) + "".padStart(9)
   );
   info(c.dim(`    avg success across commands: ${usage.avgSuccessPct}%`));
 }
@@ -3643,7 +3967,7 @@ async function addCmd(root, rest, opts, asJson) {
 }
 function readPackageVersion(root) {
   try {
-    const pkg = JSON.parse(fs8__default.readFileSync(path__default.join(root, "package.json"), "utf8"));
+    const pkg = JSON.parse(fs9__default.readFileSync(path__default.join(root, "package.json"), "utf8"));
     return typeof pkg.version === "string" ? pkg.version : void 0;
   } catch {
     return void 0;
@@ -3651,7 +3975,7 @@ function readPackageVersion(root) {
 }
 function readOptionalFile(p) {
   try {
-    const t = fs8__default.readFileSync(p, "utf8");
+    const t = fs9__default.readFileSync(p, "utf8");
     return t.trim() ? t : void 0;
   } catch {
     return void 0;
@@ -3797,8 +4121,8 @@ function registerExport(program) {
       out(content.trimEnd());
       return;
     }
-    fs8.mkdirSync(path.dirname(path.resolve(file)), { recursive: true });
-    fs8.writeFileSync(file, content);
+    fs9.mkdirSync(path.dirname(path.resolve(file)), { recursive: true });
+    fs9.writeFileSync(file, content);
     info(`${c.green("\u2714")} wrote ${file} ${c.dim(`(${format})`)}`);
   });
   applyGlobalOptions(cmd);
@@ -3821,24 +4145,24 @@ function registerBundle(program) {
     } catch {
       throw new CliError("no grammars found to bundle (run a build first)", ExitCode.ERROR);
     }
-    fs8.mkdirSync(path.join(outDir, "grammars"), { recursive: true });
+    fs9.mkdirSync(path.join(outDir, "grammars"), { recursive: true });
     let grammarCount = 0;
     for (const { fileName, absPath } of grammarFiles) {
-      fs8.copyFileSync(absPath, path.join(outDir, "grammars", fileName));
+      fs9.copyFileSync(absPath, path.join(outDir, "grammars", fileName));
       grammarCount++;
     }
     const included = [`grammars/ (${grammarCount} .wasm)`];
     const graphSrc = global.graph ?? defaultGraphPath(root);
-    if (fs8.existsSync(graphSrc)) {
-      fs8.copyFileSync(graphSrc, path.join(outDir, "graph.json"));
+    if (fs9.existsSync(graphSrc)) {
+      fs9.copyFileSync(graphSrc, path.join(outDir, "graph.json"));
       included.push("graph.json");
     }
     const cat = catalogPath(root);
-    if (fs8.existsSync(cat)) {
-      fs8.copyFileSync(cat, path.join(outDir, "vibgrate.lib.json"));
+    if (fs9.existsSync(cat)) {
+      fs9.copyFileSync(cat, path.join(outDir, "vibgrate.lib.json"));
       included.push("vibgrate.lib.json");
-      if (fs8.existsSync(libDir(root))) {
-        fs8.cpSync(libDir(root), path.join(outDir, "lib"), { recursive: true });
+      if (fs9.existsSync(libDir(root))) {
+        fs9.cpSync(libDir(root), path.join(outDir, "lib"), { recursive: true });
         included.push("lib/");
       }
     }
@@ -3850,7 +4174,7 @@ function registerBundle(program) {
       included,
       usage: "Run `vg build --grammars <this dir>/grammars` to build fully offline."
     };
-    fs8.writeFileSync(path.join(outDir, "MANIFEST.json"), `${stableStringify(manifest, 2)}
+    fs9.writeFileSync(path.join(outDir, "MANIFEST.json"), `${stableStringify(manifest, 2)}
 `);
     if (global.json) {
       json({ out: path.relative(root, outDir), ...manifest });
@@ -3874,7 +4198,7 @@ async function runDoctor(global) {
   const root = rootOf(global);
   const local = global.local === true;
   const graphPath = global.graph ?? defaultGraphPath(root);
-  const configFile = CONFIG_BASENAMES.find((f) => fs8.existsSync(path.join(root, f))) ?? null;
+  const configFile = CONFIG_BASENAMES.find((f) => fs9.existsSync(path.join(root, f))) ?? null;
   const graph = loadGraph(root, graphPath);
   let staleFiles = null;
   if (graph) {
@@ -3902,7 +4226,7 @@ async function runDoctor(global) {
     },
     libCatalog: {
       path: path.relative(root, catalogPath(root)),
-      present: fs8.existsSync(catalogPath(root)),
+      present: fs9.existsSync(catalogPath(root)),
       libraries: libCount
     },
     credentials: creds,
@@ -3994,7 +4318,7 @@ var initCommand = new Command("init").description("Initialize vibgrate in a proj
     console.log(chalk8.green("\u2714") + ` Created ${chalk8.bold("vibgrate.config.ts")}`);
   }
   if (opts.baseline) {
-    const { runBaseline } = await import('./baseline-DKPQWOQ6.js');
+    const { runBaseline } = await import('./baseline-WIZAFIJS.js');
     await runBaseline(rootDir);
   }
   console.log("");
@@ -4104,9 +4428,9 @@ async function fileReferencesIdentifier(rootDir, relFile, identifier, readFile3)
 }
 async function defaultReadFile(absPath) {
   try {
-    const stat2 = await fs15.stat(absPath);
+    const stat2 = await fs16.stat(absPath);
     if (!stat2.isFile() || stat2.size > MAX_FILE_BYTES) return null;
-    return await fs15.readFile(absPath, "utf8");
+    return await fs16.readFile(absPath, "utf8");
   } catch {
     return null;
   }
@@ -4299,22 +4623,22 @@ async function detectAiAssistant(rootDir) {
   return null;
 }
 function printAiContextPrompt(detectedAssistant) {
-  const teal2 = chalk8.hex("#3FB0A4");
-  const mint2 = chalk8.hex("#4FE3C1");
+  const teal3 = chalk8.hex("#3FB0A4");
+  const mint3 = chalk8.hex("#4FE3C1");
   const cli = resolveCliInvocation();
   const installArgs = detectedAssistant ? `install ${detectedAssistant}` : "install --all";
   const installCmd = `${cli} ${installArgs}`;
   const detectedNote = detectedAssistant ? chalk8.dim(`  (${detectedAssistant} config detected)`) : "";
   console.log("");
-  console.log(teal2("  \u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"));
-  console.log(teal2("  \u2502") + "  " + mint2("\u25C6") + "  " + chalk8.bold.white("Get AI-aware answers in your editor") + "          " + teal2("\u2502"));
-  console.log(teal2("  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
+  console.log(teal3("  \u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"));
+  console.log(teal3("  \u2502") + "  " + mint3("\u25C6") + "  " + chalk8.bold.white("Get AI-aware answers in your editor") + "          " + teal3("\u2502"));
+  console.log(teal3("  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
   console.log("");
   console.log("  " + chalk8.bold.white(installCmd) + detectedNote);
   console.log("");
-  console.log("  " + teal2("\xB7") + " " + chalk8.white("Code map in your assistant") + chalk8.dim(" \u2014 call trees, impact surfaces, import paths"));
-  console.log("  " + teal2("\xB7") + " " + chalk8.white("Offline drift") + chalk8.dim(" \u2014 DriftScore and upgrade priorities, right inside your editor"));
-  console.log("  " + teal2("\xB7") + " " + chalk8.white("Version-correct library docs") + chalk8.dim(" \u2014 pinned to your lockfile, no hallucinated APIs"));
+  console.log("  " + teal3("\xB7") + " " + chalk8.white("Code map in your assistant") + chalk8.dim(" \u2014 call trees, impact surfaces, import paths"));
+  console.log("  " + teal3("\xB7") + " " + chalk8.white("Offline drift") + chalk8.dim(" \u2014 DriftScore and upgrade priorities, right inside your editor"));
+  console.log("  " + teal3("\xB7") + " " + chalk8.white("Version-correct library docs") + chalk8.dim(" \u2014 pinned to your lockfile, no hallucinated APIs"));
   console.log("");
 }
 
@@ -4751,7 +5075,7 @@ var SKIP_DIRS2 = /* @__PURE__ */ new Set([
 function scanStaleness(rootDir, artifactPath) {
   let ref;
   try {
-    ref = fs8.statSync(artifactPath).mtimeMs;
+    ref = fs9.statSync(artifactPath).mtimeMs;
   } catch {
     return { stale: false };
   }
@@ -4763,7 +5087,7 @@ function scanStaleness(rootDir, artifactPath) {
     if (depth > 8 || scanned > MAX_ENTRIES) return;
     let entries;
     try {
-      entries = fs8.readdirSync(dir, { withFileTypes: true });
+      entries = fs9.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -4778,7 +5102,7 @@ function scanStaleness(rootDir, artifactPath) {
       const abs = path.join(dir, e.name);
       let mtimeMs;
       try {
-        mtimeMs = fs8.statSync(abs).mtimeMs;
+        mtimeMs = fs9.statSync(abs).mtimeMs;
       } catch {
         continue;
       }
@@ -4912,7 +5236,7 @@ function analyzeTree(root, packages) {
     if (depth > MAX_DEPTH || filesSeen >= MAX_FILES) return;
     let entries;
     try {
-      entries = fs8.readdirSync(dir, { withFileTypes: true });
+      entries = fs9.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -4930,8 +5254,8 @@ function analyzeTree(root, packages) {
       const full = path.join(dir, entry.name);
       let content;
       try {
-        if (fs8.statSync(full).size > MAX_FILE_BYTES2) continue;
-        content = fs8.readFileSync(full, "utf8");
+        if (fs9.statSync(full).size > MAX_FILE_BYTES2) continue;
+        content = fs9.readFileSync(full, "utf8");
       } catch {
         continue;
       }
@@ -5299,8 +5623,8 @@ async function fetchLatestVersion() {
 }
 async function writeCache(data) {
   try {
-    await fs15.mkdir(CACHE_DIR, { recursive: true });
-    await fs15.writeFile(CACHE_FILE, JSON.stringify(data), "utf-8");
+    await fs16.mkdir(CACHE_DIR, { recursive: true });
+    await fs16.writeFile(CACHE_FILE, JSON.stringify(data), "utf-8");
   } catch {
   }
 }
@@ -5311,7 +5635,7 @@ function detectGlobalInstall(execPath = process.argv[1] || "", cwd = process.cwd
   if (!execPath) return null;
   let resolved = execPath;
   try {
-    resolved = fs8.realpathSync(execPath);
+    resolved = fs9.realpathSync(execPath);
   } catch {
   }
   const p = resolved.replace(/\\/g, "/");
@@ -5840,15 +6164,15 @@ Applied the ${chosen.label} plan:`));
 }
 function formatText(artifact) {
   const lines = [];
-  const teal2 = chalk8.hex("#3FB0A4");
-  const mint2 = chalk8.hex("#4FE3C1");
+  const teal3 = chalk8.hex("#3FB0A4");
+  const mint3 = chalk8.hex("#4FE3C1");
   lines.push("");
-  lines.push("   " + teal2("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u256E") + mint2("\u279C"));
-  lines.push("  " + chalk8.dim("\u2524") + teal2("\u2502") + " " + mint2("\u25FC") + "  " + mint2("\u25FC") + " " + teal2("\u2502") + chalk8.dim("\u251C") + "  " + chalk8.bold.white("vibgrate"));
-  lines.push("  " + chalk8.dim("\u2524") + teal2("\u2502") + "  " + chalk8.dim("\u2581\u2581") + "  " + teal2("\u2502") + chalk8.dim("\u251C") + "  " + chalk8.dim(`Code Intelligence Engine v${VERSION}`));
-  lines.push("   " + teal2("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
+  lines.push("   " + teal3("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u256E") + mint3("\u279C"));
+  lines.push("  " + chalk8.dim("\u2524") + teal3("\u2502") + " " + mint3("\u25FC") + "  " + mint3("\u25FC") + " " + teal3("\u2502") + chalk8.dim("\u251C") + "  " + chalk8.bold.white("vibgrate"));
+  lines.push("  " + chalk8.dim("\u2524") + teal3("\u2502") + "  " + chalk8.dim("\u2581\u2581") + "  " + teal3("\u2502") + chalk8.dim("\u251C") + "  " + chalk8.dim(`Code Intelligence Engine v${VERSION}`));
+  lines.push("   " + teal3("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
   lines.push("");
-  lines.push(...titleBox("Vibgrate Drift Report", teal2));
+  lines.push(...titleBox("Vibgrate Drift Report", teal3));
   lines.push("");
   for (const project of artifact.projects) {
     lines.push(chalk8.bold(`  \u2500\u2500 ${project.name} `) + chalk8.dim(`(${project.type}) ${project.path}`));
@@ -7251,7 +7575,7 @@ function dispatch(argv, cwd) {
   }
   const looksLikeQuestion = /\s/.test(first) || first.endsWith("?");
   if (looksLikeQuestion) return ["ask", ...args];
-  if (fs8.existsSync(path.resolve(cwd, first))) {
+  if (fs9.existsSync(path.resolve(cwd, first))) {
     return [hasBuildOnlyFlag(args) ? "build" : "scan", ...args];
   }
   const moved = MOVED_COMMANDS[first];