@vibgrate/cli 2026.708.1 → 2026.708.3

package/dist/baseline-AUC3HAXW.js

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

package/dist/{baseline-RRO4NNNF.js.map → baseline-AUC3HAXW.js.map}

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

package/dist/{chunk-2J7DPIAL.js → chunk-2DJ3UXG7.js}

@@ -1,5 +1,5 @@
 import { hashString, langById, shortId, canonicalize, grammarSetVersion, hashBytes, langForExtension, setGrammarsOverride, parseSource } from './chunk-X5YT263H.js';
-import { writeTextFile, pathExists, readJsonFile, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-SRWMZBLG.js';
+import { writeTextFile, pathExists, readJsonFile, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-QUELGOCR.js';
 import * as fs18 from 'fs';
 import { execFileSync } from 'child_process';
 import * as path18 from 'path';
@@ -3054,12 +3054,13 @@ function queryGraph(graph, question, options = {}) {
   const budget = options.budget ?? 2e3;
   const limit = options.limit ?? 12;
   const terms = tokenize(question);
+  const weightOf = termWeights(graph, terms);
   const index = new GraphIndex(graph);
   const scored = [];
   for (const node of graph.nodes) {
     if (node.kind === "file" || node.kind === "external") continue;
-    const { score, why } = scoreNode(node, terms);
-    if (score > 0) scored.push({ node, score: round2(score * (1 + node.importance)), why });
+    const { score, why } = scoreNode(node, terms, weightOf);
+    if (score > 0) scored.push({ node, score: round2(score * (1 + IMPORTANCE_WEIGHT * node.importance)), why });
   }
   scored.sort((a, b) => b.score - a.score || a.node.qualifiedName.localeCompare(b.node.qualifiedName));
   const seeds = scored.slice(0, limit);
@@ -3070,6 +3071,7 @@ async function queryGraphSemantic(graph, question, options) {
   const budget = options.budget ?? 2e3;
   const limit = options.limit ?? 12;
   const terms = tokenize(question);
+  const weightOf = termWeights(graph, terms);
   const index = new GraphIndex(graph);
   const queryVec = await options.embedder.embedQuery(question);
   const lexRaw = /* @__PURE__ */ new Map();
@@ -3077,7 +3079,7 @@ async function queryGraphSemantic(graph, question, options) {
   const whyById = /* @__PURE__ */ new Map();
   for (const node of graph.nodes) {
     if (node.kind === "file" || node.kind === "external") continue;
-    const { score, why } = scoreNode(node, terms);
+    const { score, why } = scoreNode(node, terms, weightOf);
     lexRaw.set(node.id, score);
     whyById.set(node.id, why);
     if (score > lexMax) lexMax = score;
@@ -3092,7 +3094,7 @@ async function queryGraphSemantic(graph, question, options) {
     if (hybrid <= 0) continue;
     const lexWhy = whyById.get(node.id);
     const why = lexWhy || (sem > 0.3 ? `semantic match (${sem.toFixed(2)})` : "weak match");
-    scored.push({ node, score: round2(hybrid * (1 + node.importance)), why });
+    scored.push({ node, score: round2(hybrid * (1 + IMPORTANCE_WEIGHT * node.importance)), why });
   }
   scored.sort((a, b) => b.score - a.score || a.node.qualifiedName.localeCompare(b.node.qualifiedName));
   const seeds = scored.slice(0, limit);
@@ -3106,7 +3108,7 @@ function tokenize(q2) {
     )
   ];
 }
-function scoreNode(node, terms) {
+function scoreNode(node, terms, weightOf = () => 1) {
   let score = 0;
   const hits = [];
   const name = node.name.toLowerCase();
@@ -3114,28 +3116,50 @@ function scoreNode(node, terms) {
   const file = node.file.toLowerCase();
   const nameParts = identifierParts(node.name);
   for (const t of terms) {
+    const w = weightOf(t);
     if (name === t) {
-      score += 10;
+      score += 10 * w;
       hits.push(t);
     } else if (nameParts.has(t)) {
-      score += 6;
+      score += 6 * w;
       hits.push(t);
     } else if (name.includes(t)) {
-      score += 4;
+      score += 4 * w;
       hits.push(t);
     } else if (qn.includes(t)) {
-      score += 3;
+      score += 3 * w;
       hits.push(t);
     } else if (fuzzyPartMatch(t, nameParts)) {
-      score += 2;
+      score += 2 * w;
       hits.push(`~${t}`);
     } else if (file.includes(t)) {
-      score += 1;
+      score += 1 * w;
       hits.push(t);
     }
   }
   return { score, why: hits.length ? `matched: ${hits.join(", ")}` : "" };
 }
+var IMPORTANCE_WEIGHT = 0.4;
+function termWeights(graph, terms) {
+  if (terms.length === 0) return () => 1;
+  const df = /* @__PURE__ */ new Map();
+  let n = 0;
+  for (const node of graph.nodes) {
+    if (node.kind === "file" || node.kind === "external") continue;
+    n++;
+    const name = node.name.toLowerCase();
+    const parts = identifierParts(node.name);
+    for (const t of terms) {
+      if (parts.has(t) || name.includes(t)) df.set(t, (df.get(t) ?? 0) + 1);
+    }
+  }
+  const w = /* @__PURE__ */ new Map();
+  for (const t of terms) {
+    const idf = Math.log((n + 1) / ((df.get(t) ?? 0) + 1)) + 1;
+    w.set(t, Math.max(0.5, Math.min(8, idf)));
+  }
+  return (t) => w.get(t) ?? 1;
+}
 function identifierParts(name) {
   return new Set(
     name.split(/[^a-zA-Z0-9]+|(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/).filter(Boolean).map((s) => s.toLowerCase())
@@ -5494,7 +5518,11 @@ var PREVIEW_CHARS = 120;
 function searchSymbols(graph, root, query, limit) {
   const q2 = query.trim();
   if (!q2) return { matches: [], moreAvailable: false, hint: "query is required" };
-  const nodes = findNodes(graph, q2).filter((n) => n.kind !== "file");
+  let nodes = findNodes(graph, q2).filter((n) => n.kind !== "file");
+  if (nodes.length === 0) {
+    const tokens = queryTokens(q2);
+    if (tokens.length >= 2) nodes = multiTokenNodes(graph, tokens);
+  }
   const symbolHits = nodes.slice(0, limit).map((n, i) => ({
     kind: n.kind,
     name: n.qualifiedName,
@@ -5519,6 +5547,21 @@ function searchSymbols(graph, root, query, limit) {
   }
   return { matches, moreAvailable: nodes.length > symbolHits.length || truncatedScan };
 }
+function queryTokens(q2) {
+  return [...new Set(q2.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 2))];
+}
+function multiTokenNodes(graph, tokens) {
+  const cov = /* @__PURE__ */ new Map();
+  for (const t of tokens) {
+    for (const n of findNodes(graph, t)) {
+      if (n.kind === "file") continue;
+      const e = cov.get(n.id);
+      if (e) e.hits++;
+      else cov.set(n.id, { node: n, hits: 1 });
+    }
+  }
+  return [...cov.values()].sort((a, b) => b.hits - a.hits || b.node.importance - a.node.importance).map((e) => e.node);
+}
 function scanFiles(root, needle, budget, seen, out) {
   const lower = needle.toLowerCase();
   let scanned = 0;
@@ -5630,17 +5673,20 @@ var TOOLS = [
   {
     name: "orient",
     description: "Start here: one call returns the map overview, ranked matches for your question, and the top hit\u2019s blast radius \u2014 replaces summary+query+impact round-trips.",
-    inputSchema: obj(
-      {
-        question: { type: "string", maxLength: 300 },
-        scope: { type: "string", description: "path prefix to orient within" },
-        budget: { type: "number", description: "token budget in detailed mode (default 1500)" },
-        response_format: RESPONSE_FORMAT
-      },
-      ["question"]
-    ),
+    // `query` is a no-description back-compat alias for `question`: the sibling
+    // discovery tools (search_symbols, resolve_library) take `query`, so an agent
+    // naturally reaches for it here too — accepting it turns what was a wasted
+    // "question is required" round-trip into a hit. Neither is `required` (either
+    // satisfies the in-handler check), matching library_docs/resolve_library.
+    inputSchema: obj({
+      question: { type: "string", maxLength: 300 },
+      query: { type: "string", maxLength: 300 },
+      scope: { type: "string", description: "path prefix to orient within" },
+      budget: { type: "number", description: "token budget in detailed mode (default 1500)" },
+      response_format: RESPONSE_FORMAT
+    }),
     handler: async (graph, args, ctx) => {
-      const question = String(args.question ?? "");
+      const question = String(args.question ?? args.query ?? "");
       if (!question) return { error: "bad_request", message: "question is required" };
       const budget = numOr(args.budget, 1500);
       const { q: q2, mode } = await retrieve(graph, question, budget, ctx);
@@ -5656,7 +5702,11 @@ var TOOLS = [
       }
       const shown = detailed ? scoped : scoped.slice(0, CONCISE_MATCHES);
       return {
-        summary: summarize(graph, detailed ? 10 : CONCISE_MATCHES),
+        // Concise "find X" calls need a one-line map (counts + languages), not the
+        // full topAreas/topHubs blocks — those were ~half of every orient
+        // response's tokens on the hot discovery path and the caller navigates by
+        // `matches`. Detailed keeps the full overview.
+        summary: detailed ? summarize(graph, 10) : conciseSummary(graph),
         mode,
         // The fact-annotated context block is detail: concise callers navigate
         // by the ranked matches and fetch nodes on demand (plan P2).
@@ -5688,18 +5738,19 @@ var TOOLS = [
   {
     name: "query_graph",
     description: "Find code by meaning when you don\u2019t know the name: symptoms, relationships, what-breaks-if. For a known name or literal string use search_symbols.",
-    inputSchema: obj(
-      {
-        question: { type: "string", maxLength: 300 },
-        limit: { type: "number", description: "ranked matches to return (default 5)" },
-        offset: { type: "number" },
-        budget: { type: "number", description: "context-block token budget in detailed mode (default 2000)" },
-        response_format: RESPONSE_FORMAT
-      },
-      ["question"]
-    ),
+    // `query` is a no-description back-compat alias for `question` (see orient):
+    // sibling tools take `query`, so accept it here rather than reject the call.
+    inputSchema: obj({
+      question: { type: "string", maxLength: 300 },
+      query: { type: "string", maxLength: 300 },
+      limit: { type: "number", description: "ranked matches to return (default 5)" },
+      offset: { type: "number" },
+      budget: { type: "number", description: "context-block token budget in detailed mode (default 2000)" },
+      response_format: RESPONSE_FORMAT
+    }),
     handler: async (graph, args, ctx) => {
-      const question = String(args.question ?? "");
+      const question = String(args.question ?? args.query ?? "");
+      if (!question) return { mode: "lexical", matches: [], hint: "question (or query) is required" };
       const budget = numOr(args.budget, 2e3);
       const { q: r, mode } = await retrieve(graph, question, budget, ctx);
       if (r.matches.length === 0) {
@@ -6167,6 +6218,9 @@ var TOOLS = [
   }
 ];
 var VERBOSITY_BUDGET = { concise: 1500, balanced: 4e3, exhaustive: 12e3 };
+function conciseSummary(graph) {
+  return { counts: graph.meta.counts, languages: graph.meta.languages };
+}
 function summarize(graph, top = 10) {
   return {
     counts: graph.meta.counts,
@@ -6221,6 +6275,7 @@ function navigationToolsetConfig(serverName = "vibgrate") {
 }
 var LEDGER = "savings.jsonl";
 var PER_FILE_TOKENS = 400;
+var SAVINGS_TOOLS = /* @__PURE__ */ new Set(["query_graph", "get_node"]);
 function ledgerPath(root) {
   return path18.join(cacheDir(root), LEDGER);
 }
@@ -6249,6 +6304,7 @@ function readSavings(root, days, now, ratePerM = DEFAULT_RATE_PER_M) {
       try {
         const e = JSON.parse(line);
         if (e.ts < cutoff) continue;
+        if (!SAVINGS_TOOLS.has(e.tool)) continue;
         queries++;
         vgTokens += e.vgTokens;
         baselineTokens += e.baselineTokens;
@@ -6274,6 +6330,47 @@ function readSavings(root, days, now, ratePerM = DEFAULT_RATE_PER_M) {
 function round22(x) {
   return Math.round(x * 100) / 100;
 }
+function readUsage(root, days, now) {
+  const file = ledgerPath(root);
+  const cutoff = now - days * 24 * 60 * 60 * 1e3;
+  const byTool = /* @__PURE__ */ new Map();
+  if (fs18.existsSync(file)) {
+    for (const line of fs18.readFileSync(file, "utf8").split("\n")) {
+      if (!line.trim()) continue;
+      try {
+        const e = JSON.parse(line);
+        if (e.ts < cutoff) continue;
+        const outcome = e.outcome ?? "complete";
+        const row = byTool.get(e.tool) ?? { complete: 0, partial: 0, miss: 0 };
+        row[outcome]++;
+        byTool.set(e.tool, row);
+      } catch {
+      }
+    }
+  }
+  const commands = [...byTool.entries()].map(([tool, r]) => {
+    const calls = r.complete + r.partial + r.miss;
+    return {
+      tool,
+      calls,
+      complete: r.complete,
+      partial: r.partial,
+      miss: r.miss,
+      successPct: calls ? Math.round((r.complete + r.partial) / calls * 100) : 0
+    };
+  }).sort((a, b) => b.calls - a.calls || a.tool.localeCompare(b.tool));
+  const totals = commands.reduce(
+    (t, c) => ({
+      calls: t.calls + c.calls,
+      complete: t.complete + c.complete,
+      partial: t.partial + c.partial,
+      miss: t.miss + c.miss
+    }),
+    { calls: 0, complete: 0, partial: 0, miss: 0 }
+  );
+  const avgSuccessPct = commands.length ? Math.round(commands.reduce((s, c) => s + c.successPct, 0) / commands.length) : 0;
+  return { enabled: savingsRecorded(root), days, commands, totals, avgSuccessPct };
+}
 var PROBE_INTERVAL_MS = 2e3;
 var MAX_PROBE_INTERVAL_MS = 3e4;
 var PROBE_DUTY_FACTOR = 20;
@@ -6373,9 +6470,7 @@ function createServer(source, opts = {}) {
     try {
       const args = request.params.arguments ?? {};
       const result = await tool.handler(graph, args, { root, local, dedup, seen });
-      if (savings && (tool.name === "query_graph" || tool.name === "get_node")) {
-        maybeRecordSaving(root, tool.name, result);
-      }
+      if (savings) recordUsage(root, tool.name, result);
       return renderToolResult(result);
     } catch (err) {
       return errorResult(`tool "${tool.name}" failed: ${err.message}`);
@@ -6395,14 +6490,57 @@ function sleep(ms) {
     timer.unref?.();
   });
 }
-function maybeRecordSaving(root, tool, result) {
-  if (!result || typeof result !== "object") return;
+function recordUsage(root, tool, result) {
+  const outcome = classifyOutcome(result);
+  let vgTokens = 0;
+  let baselineTokens = 0;
+  if (SAVINGS_TOOLS.has(tool) && result && typeof result === "object") {
+    vgTokens = countTokens(renderedText(renderToolResult(result)));
+    baselineTokens = referencedFiles(result).size * PER_FILE_TOKENS;
+  }
+  recordSaving(root, { tool, outcome, vgTokens, baselineTokens }, Date.now());
+}
+function classifyOutcome(result) {
+  if (Array.isArray(result)) return result.length === 0 ? "miss" : "complete";
+  if (!result || typeof result !== "object") return "miss";
   const r = result;
-  const vgTokens = typeof r.tokensEstimate === "number" ? r.tokensEstimate : 0;
-  if (vgTokens <= 0) return;
-  const files = new Set((r.matches ?? []).map((m) => m.file).filter(Boolean));
-  const baselineTokens = files.size * PER_FILE_TOKENS;
-  recordSaving(root, { tool, vgTokens, baselineTokens }, Date.now());
+  if (typeof r.error === "string" && r.error) return "miss";
+  if (r.connected === false) return "miss";
+  if (Array.isArray(r.matches) && r.matches.length === 0) return "miss";
+  return isPartial(r) ? "partial" : "complete";
+}
+function isPartial(r) {
+  if (r.moreAvailable === true) return true;
+  if (r._truncated && typeof r._truncated === "object") return true;
+  for (const [key, value] of Object.entries(r)) {
+    if (typeof value !== "number" || !key.endsWith("Total")) continue;
+    const base = key.slice(0, -"Total".length);
+    const shown = Array.isArray(r[base]) ? r[base].length : 0;
+    if (value > shown) return true;
+  }
+  return false;
+}
+function renderedText(rendered) {
+  const block = rendered.content?.find((b) => b.type === "text");
+  return block && "text" in block && typeof block.text === "string" ? block.text : "";
+}
+function referencedFiles(result) {
+  const r = result;
+  const files = /* @__PURE__ */ new Set();
+  if (typeof r.file === "string" && r.file) files.add(r.file);
+  for (const m of asArray(r.matches)) {
+    const f = m.file;
+    if (typeof f === "string" && f) files.add(f);
+  }
+  for (const name of [...asArray(r.calls), ...asArray(r.calledBy)]) {
+    if (typeof name !== "string") continue;
+    const i = name.indexOf(":");
+    if (i > 0) files.add(name.slice(0, i));
+  }
+  return files;
+}
+function asArray(v) {
+  return Array.isArray(v) ? v : [];
 }
 function errorResult(message) {
   return { content: [{ type: "text", text: message }], isError: true };
@@ -6901,6 +7039,6 @@ function spdx(ctx) {
   return JSON.stringify(doc, null, 2) + "\n";
 }
 
-export { ASSISTANTS, 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, coveringTests, createServer, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, defaultGraphPath, detectRunner, detectServeLaunch, discover, discoverModels, driftCount, driftFor, dsnCommand, embeddingsCached, enrichOnline, ensureGitignored, epistemicBreakdown, exportGraph, fetchHostedDocs, findGitRoot, findNodes, formatForExt, getNodeEmbeddings, gitignoreEntryForCredentials, groundGraph, hasDrift, identifierParts, impactOf, ingestHostForRegionId, installAssistant, inventory, isModelReady, isTestFile, libDir, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, localApiSurface, localPackageDocs, modelCacheInfo, nodeById, nodeEmbedText, parseDsn, parseGraph, parseJsonc, probeFreshness, publishPrivateLibrary, pushCommand, queryGraph, queryGraphSemantic, readDoc, readSavings, readScanArtifact, 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-2J7DPIAL.js.map
-//# sourceMappingURL=chunk-2J7DPIAL.js.map
+export { ASSISTANTS, 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, coveringTests, createServer, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, defaultGraphPath, detectRunner, detectServeLaunch, discover, discoverModels, driftCount, driftFor, dsnCommand, embeddingsCached, enrichOnline, ensureGitignored, epistemicBreakdown, exportGraph, fetchHostedDocs, findGitRoot, findNodes, formatForExt, getNodeEmbeddings, gitignoreEntryForCredentials, groundGraph, hasDrift, identifierParts, impactOf, ingestHostForRegionId, installAssistant, inventory, isModelReady, isTestFile, libDir, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, localApiSurface, localPackageDocs, modelCacheInfo, nodeById, nodeEmbedText, parseDsn, parseGraph, parseJsonc, probeFreshness, publishPrivateLibrary, pushCommand, queryGraph, queryGraphSemantic, readDoc, readSavings, readScanArtifact, readUsage, 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-2DJ3UXG7.js.map
+//# sourceMappingURL=chunk-2DJ3UXG7.js.map