@vibgrate/cli 2026.708.2 → 2026.709.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-CXnp1uGj.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
-declare const VERSION = "2026.708.2";
+declare const VERSION = "2026.709.1";
 
 /**
  * Analysis stage: importance, centrality, hubs, communities, and surprise.
@@ -592,6 +592,13 @@ declare const TOOLS: VgTool[];
 interface ServeOptions {
     /** Record local, counts-only usage savings (opt-in). */
     savings?: boolean;
+    /**
+     * Periodically upload the counts-only ledger to Vibgrate (opt-in; off by
+     * default). Implies recording. The upload itself is driven by the serve
+     * command (see commands/serve.ts + engine/stats-share.ts); here it just also
+     * turns recording on so there's something to send.
+     */
+    shareStats?: boolean;
     /** Air-gapped mode (no model downloads). */
     local?: boolean;
     /** Collapse repeat heavy relation lists within a session (opt-in). */
@@ -896,6 +903,17 @@ 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;
@@ -909,6 +927,8 @@ interface SavingEntry {
     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;

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-AWEAREOE.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-MPKMAERO.js';
 export { LANGUAGES, allLanguageIds, grammarsSourceDir, langById, langForExtension, parseSource } from './chunk-X5YT263H.js';
-export { VERSION } from './chunk-ICBBG6U3.js';
+export { VERSION } from './chunk-PXZ5KPVN.js';
 import { redactUrlCredentials, redactSecrets } from './chunk-RXP66R2E.js';
 import './chunk-GI6W53LM.js';
 import { execFileSync } from 'child_process';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibgrate/cli",
-  "version": "2026.708.2",
+  "version": "2026.709.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)",
   "type": "module",
   "license": "Apache-2.0",
@@ -99,6 +99,6 @@
     "vitest": "^4.0.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   }
 }

package/skills/vg/SKILL.md

@@ -8,13 +8,26 @@ description: Query the local code graph (vg) for structure, impact, and navigati
 This repo has a deterministic code graph built by `vg`. Prefer it over reading or
 grepping many files — it is smaller, more relevant context, and free.
 
-## When to use it
+## Prefer the MCP tools
 
-- **Understand code:** `vg "<question>"` returns a budget-bounded, fact-annotated
-  context block. Start here instead of opening files blindly.
-- **Find a symbol:** `vg show <name>` — what it is, what it calls, what calls it.
-- **Before changing something:** `vg impact <name>` — what breaks if you change it.
-- **Navigate:** `vg path <A> <B>`, `vg tree <name>`, `vg hubs`, `vg areas`.
+If the `vg` MCP server is registered (it is after `vg install`), call its
+read-only tools directly — they are the **fastest** path. The server keeps the
+map parsed, the relation index warm, and the embedding model loaded across calls,
+so each query is cheaper than spawning the CLI fresh. Use:
+`query_graph`, `get_node`, `impact_of`, `find_path`, `list_hubs`, `list_areas`,
+`get_graph_summary`, `search_symbols`. They are side-effect-free and
+auto-approvable, and the server records which client is calling automatically.
+
+## If you use the `vg` CLI instead
+
+When the MCP server isn't available, use the CLI — and **always pass
+`--client=<your-ai>`** so your calls are counted (that's how the CLI-vs-MCP split
+is measured and the tools improved):
+
+- **Understand code:** `vg "<question>" --client=<your-ai>` — a budget-bounded, fact-annotated context block.
+- **Find a symbol:** `vg show <name> --client=<your-ai>` — what it is, what it calls, what calls it.
+- **Before changing something:** `vg impact <name> --client=<your-ai>` — what breaks if you change it.
+- **Navigate:** `vg path <A> <B> --client=<your-ai>`, `vg tree <name> --client=<your-ai>`.
 
 ## Dependencies & library docs
 
@@ -24,19 +37,17 @@ grepping many files — it is smaller, more relevant context, and free.
 - **Version-correct docs:** `vg lib <name>` returns drift-annotated, version-
   specific usage docs for a library — inject these instead of guessing an API.
 
-## Via MCP
-
-If the `vg` MCP server is registered, call its read-only tools directly:
-`query_graph`, `get_node`, `impact_of`, `find_path`, `list_hubs`, `list_areas`,
-`get_graph_summary`. They are side-effect-free and auto-approvable.
-
 ## Keep it fresh
 
-Run `vg` after pulling or making structural changes. The map lives at
-`.vibgrate/graph.json` and is deterministic (byte-identical across machines).
+The map keeps itself fresh: `vg ask` and the MCP tools detect changed files
+and rebuild it incrementally before answering — you can edit code and query
+immediately. Running `vg` after a large pull still warms everything in one go.
+The map lives at `.vibgrate/graph.json` and is deterministic (byte-identical
+across machines).
 
 ---
 
 > This is the canonical reference copy. `vg install <assistant>` writes this skill
-> into each assistant's expected location and registers the local MCP server. The
+> into each assistant's expected location (substituting the assistant's own name
+> for `<your-ai>` in the `--client` flag) and registers the local MCP server. The
 > source of truth is `src/install/content.ts`.

package/dist/baseline-AMQ7VEB5.js

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