@vibgrate/cli 2026.717.1 → 2026.720.1

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { G as GraphNode, a as GraphEdge, A as Area, R as ResolverKind, V as VgGr
 export { C as Centrality, D as DerivedBy, e as EpistemicTier, f as FactConfidence, g as FactKind, h as GraphMeta, N as NodeKind, P as Provenance, S as SCHEMA_VERSION, i as Span, T as Toolchain, U as Unknown } from './types-BgNa-FZQ.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
-declare const VERSION = "2026.717.1";
+declare const VERSION = "2026.720.1";
 
 /**
  * Analysis stage: importance, centrality, hubs, communities, and surprise.
@@ -603,6 +603,114 @@ interface VgTool {
 }
 declare const TOOLS: VgTool[];
 
+/**
+ * How a navigation call reached the map:
+ *  - `mcp` — a tool call over the local `vg serve` MCP server;
+ *  - `cli` — a `vg <subcommand>` invocation that identified itself with `--client`.
+ * Both are recorded into one ledger under a shared tool vocabulary (CLI
+ * subcommands are normalised to their MCP tool names via CLI_TOOL_ALIASES), so
+ * `(tool, source)` is the command-vs-MCP split and the token math stays unified.
+ * Absent on ledger lines written before sources existed → read as `mcp` (the
+ * only path that recorded then).
+ */
+type Source = 'mcp' | 'cli';
+/**
+ * Outcome of a recorded navigation call:
+ *  - `complete` — returned results, with nothing capped or paginated;
+ *  - `partial`  — returned results, but more were available/truncated;
+ *  - `miss`     — returned no result (no match, not-found, not-connected).
+ */
+type Outcome = 'complete' | 'partial' | 'miss';
+interface SavingEntry {
+    ts: number;
+    tool: string;
+    outcome?: Outcome;
+    vgTokens: number;
+    baselineTokens: number;
+    source?: Source;
+    client?: string;
+    ms?: number;
+}
+/** Whether a savings ledger exists for this repo (i.e. `vg serve --savings` has recorded). */
+declare function savingsRecorded(root: string): boolean;
+declare function recordSaving(root: string, entry: Omit<SavingEntry, 'ts'>, now: number): void;
+interface SavingsReport {
+    enabled: boolean;
+    days: number;
+    queries: number;
+    vgTokens: number;
+    baselineTokens: number;
+    ratio: number;
+    estCostVg: number;
+    estCostBaseline: number;
+    saved: number;
+    rateLabel: string;
+}
+declare function readSavings(root: string, days: number, now: number, ratePerM?: number): SavingsReport;
+
+/**
+ * Live, in-memory session stats for `vg serve` — the "is it earning its keep?"
+ * display. While the MCP server runs, every tool call is aggregated per tool
+ * and per client (which AI is calling, how many calls, how long they take, and
+ * the context tokens served vs the grep/read baseline they replaced), and a
+ * status block on stderr keeps the operator posted.
+ *
+ * Privacy: everything here lives and dies with the process — nothing is
+ * persisted or uploaded, so the display is always on (GUARDRAILS §3.4 applies
+ * to the opt-in ledger/upload, which remain separate and off by default).
+ * Counts only — never code, paths beyond what the operator already sees, or
+ * question text.
+ *
+ * Output discipline: stderr only. Under stdio transport, stdout IS the MCP
+ * protocol stream and carries nothing else.
+ */
+interface CallSample {
+    tool: string;
+    /** Coarse, sanitized client label ('claude', 'cursor', … or 'unknown'). */
+    client: string;
+    outcome: Outcome;
+    /** Wall time of the tool call, ms. */
+    ms: number;
+    /** Context tokens vg actually returned (savings tools only; else 0). */
+    vgTokens: number;
+    /** Grep/read baseline estimate those tokens replaced (savings tools only; else 0). */
+    baselineTokens: number;
+}
+interface RollupRow {
+    key: string;
+    calls: number;
+    complete: number;
+    partial: number;
+    miss: number;
+    totalMs: number;
+    vgTokens: number;
+    baselineTokens: number;
+}
+interface SessionSnapshot {
+    startedAt: number;
+    /** Bumped on every recorded call — cheap dirty check for renderers. */
+    revision: number;
+    /** Epoch ms of the most recent call, or null when none yet (never 0). */
+    lastCallAt: number | null;
+    totals: RollupRow;
+    /** Sorted by calls desc, then key — deterministic display order. */
+    clients: RollupRow[];
+    tools: RollupRow[];
+}
+/** Aggregates tool calls for the lifetime of one serve process. */
+declare class SessionStats {
+    readonly startedAt: number;
+    private revision;
+    private lastCallAt;
+    private readonly totals;
+    private readonly byClient;
+    private readonly byTool;
+    constructor(now?: number);
+    record(sample: CallSample, now?: number): void;
+    snapshot(): SessionSnapshot;
+    private rowFor;
+}
+
 interface ServeOptions {
     /** Record local, counts-only usage savings (opt-in). */
     savings?: boolean;
@@ -619,6 +727,12 @@ interface ServeOptions {
     dedup?: boolean;
     /** Auto-refresh the map when the working tree drifts (default true). */
     refresh?: boolean;
+    /**
+     * In-memory session stats behind the live `vg serve` status display. Always
+     * safe to pass: nothing recorded here is persisted or uploaded — it dies with
+     * the process (the opt-in ledger above is a separate concern).
+     */
+    stats?: SessionStats;
 }
 declare class GraphSource {
     readonly graphPath: string;
@@ -917,50 +1031,6 @@ interface LocalModel {
 }
 declare function discoverModels(home?: string): LocalModel[];
 
-/**
- * How a navigation call reached the map:
- *  - `mcp` — a tool call over the local `vg serve` MCP server;
- *  - `cli` — a `vg <subcommand>` invocation that identified itself with `--client`.
- * Both are recorded into one ledger under a shared tool vocabulary (CLI
- * subcommands are normalised to their MCP tool names via CLI_TOOL_ALIASES), so
- * `(tool, source)` is the command-vs-MCP split and the token math stays unified.
- * Absent on ledger lines written before sources existed → read as `mcp` (the
- * only path that recorded then).
- */
-type Source = 'mcp' | 'cli';
-/**
- * Outcome of a recorded navigation call:
- *  - `complete` — returned results, with nothing capped or paginated;
- *  - `partial`  — returned results, but more were available/truncated;
- *  - `miss`     — returned no result (no match, not-found, not-connected).
- */
-type Outcome = 'complete' | 'partial' | 'miss';
-interface SavingEntry {
-    ts: number;
-    tool: string;
-    outcome?: Outcome;
-    vgTokens: number;
-    baselineTokens: number;
-    source?: Source;
-    client?: string;
-}
-/** Whether a savings ledger exists for this repo (i.e. `vg serve --savings` has recorded). */
-declare function savingsRecorded(root: string): boolean;
-declare function recordSaving(root: string, entry: Omit<SavingEntry, 'ts'>, now: number): void;
-interface SavingsReport {
-    enabled: boolean;
-    days: number;
-    queries: number;
-    vgTokens: number;
-    baselineTokens: number;
-    ratio: number;
-    estCostVg: number;
-    estCostBaseline: number;
-    saved: number;
-    rateLabel: string;
-}
-declare function readSavings(root: string, days: number, now: number, ratePerM?: number): SavingsReport;
-
 /**
  * `vg lib` — a deterministic, on-disk library-currency catalog: version-correct
  * usage docs for the **exact version in your lockfile**, drift-annotated, from

package/dist/index.js

@@ -1,6 +1,6 @@
-export { ASSISTANTS, FREE_PACK, GraphIndex, GraphSource, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assistantById, buildFacts, buildGraph, buildModuleResolver, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, nodeById, nodeEmbedText, parseGraph, parseJsonc, probeFreshness, queryGraph, queryGraphSemantic, readDoc, readSavings, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, serializeGraph, serveStdio, shortestPath, stableStringify, testsToRun, uninstallAssistant, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot } from './chunk-L42NVMD6.js';
+export { ASSISTANTS, FREE_PACK, GraphIndex, GraphSource, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assistantById, buildFacts, buildGraph, buildModuleResolver, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, nodeById, nodeEmbedText, parseGraph, parseJsonc, probeFreshness, queryGraph, queryGraphSemantic, readDoc, readSavings, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, serializeGraph, serveStdio, shortestPath, stableStringify, testsToRun, uninstallAssistant, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot } from './chunk-VQLOVQZP.js';
 export { LANGUAGES, allLanguageIds, grammarsSourceDir, langById, langForExtension, parseSource } from './chunk-VFO5UDAT.js';
-export { VERSION } from './chunk-M62BGJMK.js';
+export { VERSION } from './chunk-AJDUMRVI.js';
 import { redactUrlCredentials, redactSecrets } from './chunk-RXP66R2E.js';
 import './chunk-GI6W53LM.js';
 import { execFileSync } from 'child_process';

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "@vibgrate/cli",
-  "version": "2026.717.1",
+  "version": "2026.720.1",
   "description": "vg — local codebase intelligence CLI + MCP server for AI coding agents: deterministic code graph, drift reporting, and version-correct library docs (Apache-2.0)",
+  "//mcpName": "Official MCP registry ownership proof: the registry fetches the published npm package and requires this field to match the com.vibgrate/ai-context server entry (see docs/marketing/mcp-registry/README.md). Must ship in the published @vibgrate/cli package.json.",
+  "mcpName": "com.vibgrate/ai-context",
   "type": "module",
   "license": "Apache-2.0",
   "packageManager": "pnpm@9.0.0",

package/dist/baseline-YWGSHCKW.js

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