@vibgrate/cli 2026.708.1 → 2026.708.2

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/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, countPending, resolveOne, GraphIndex, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, serveStdio, ASSISTANTS, usageError, loadGraph, detectServeLaunch, installAssistant, writeNavigationConfig, uninstallAssistant, coveringTests, FREE_PACK, readScanArtifact, enrichOnline, ECOSYSTEMS, discoverModels, readSavings, 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, fetchHostedDocs, selectForBudget, formatForExt, verifyDeterminism, renderHtml, isModelReady } from './chunk-2J7DPIAL.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, countPending, resolveOne, GraphIndex, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, serveStdio, ASSISTANTS, 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, fetchHostedDocs, selectForBudget, formatForExt, verifyDeterminism, renderHtml, isModelReady } from './chunk-AWEAREOE.js';
 import { resolvedGrammarFiles, grammarSetVersion, canonicalize } from './chunk-X5YT263H.js';
-import { loadAdvancedScanHook, baselineCommand } from './chunk-FMCI3MXH.js';
-import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, prepareCompressedUpload, computeDriftScore, titleBox, projectTypeToVulnEcosystem, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, brandProgressBar, resolveHead, workingTreeDirty } from './chunk-SRWMZBLG.js';
+import { loadAdvancedScanHook, baselineCommand } from './chunk-GHLYQZWT.js';
+import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, prepareCompressedUpload, computeDriftScore, titleBox, projectTypeToVulnEcosystem, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, brandProgressBar, resolveHead, workingTreeDirty } from './chunk-ICBBG6U3.js';
 import './chunk-RXP66R2E.js';
 import { pathExists as pathExists$1, parseExcludePatterns } from './chunk-GI6W53LM.js';
 import * as fs5 from 'fs';
@@ -295,7 +295,7 @@ function logoLines(root) {
     `  ${ROBOT[1]}`,
     `  ${ROBOT[2]}`,
     `  ${ROBOT[3]}`,
-    `  ${c.bold.white("vibgrate")} ${teal("graph")}  ${c.dim(`\xB7 deterministic code graph \xB7 v${VERSION}`)}`,
+    `  ${c.bold.white("Vibgrate")} ${teal("Graph")}  ${c.dim(`\xB7 Code Intelligence Engine \xB7 v${VERSION}`)}`,
     ...root ? [`  ${c.dim(root)}`] : [],
     ""
   ];
@@ -2034,23 +2034,29 @@ function registerSavings(program) {
   const cmd = program.command("savings").description("local, privacy-safe report of tokens/$ saved vs a grep baseline (estimates)").option("--days <n>", "window in days", "30").action(function() {
     const global = readGlobal(this);
     const days = Number(this.opts().days) || 30;
-    const report = readSavings(rootOf(global), days, Date.now());
+    const root = rootOf(global);
+    const now2 = Date.now();
+    const report = readSavings(root, days, now2);
+    const usage = readUsage(root, days, now2);
     if (global.json) {
-      json(report);
+      json({ ...report, usage });
       return;
     }
     info(`${c.cyan("vg savings")} \xB7 last ${days} days ${c.dim("(local, nothing left your machine)")}`);
-    if (!report.enabled && report.queries === 0) {
-      info(c.dim("  recording is off. Enable with `vg serve --savings`, then query via MCP."));
+    if (usage.totals.calls === 0) {
+      info(
+        c.dim(
+          report.enabled ? "  no calls recorded yet in this window" : "  recording is off. Enable with `vg serve --savings`, then query via MCP."
+        )
+      );
       return;
     }
-    if (report.queries === 0) {
-      info(c.dim("  no queries recorded yet in this window"));
-      return;
+    if (report.queries > 0) {
+      info(`  queries ${report.queries} \xB7 context tokens ${fmt(report.vgTokens)}  (grep/read baseline \u2248 ${fmt(report.baselineTokens)})  \u2192 ${report.ratio}\xD7 fewer`);
+      info(`  est. cost (${report.rateLabel}): $${report.estCostVg} vs $${report.estCostBaseline}  \u2192 saved \u2248 $${report.saved}`);
+      info(c.dim("  estimates with stated assumptions (~4 chars/token; ~400 tokens/file baseline); scales with repo size."));
     }
-    info(`  queries ${report.queries} \xB7 context tokens ${fmt(report.vgTokens)}  (grep/read baseline \u2248 ${fmt(report.baselineTokens)})  \u2192 ${report.ratio}\xD7 fewer`);
-    info(`  est. cost (${report.rateLabel}): $${report.estCostVg} vs $${report.estCostBaseline}  \u2192 saved \u2248 $${report.saved}`);
-    info(c.dim("  estimates with stated assumptions (~4 chars/token; ~400 tokens/file baseline); scales with repo size."));
+    printBreakdown(usage);
   });
   applyGlobalOptions(cmd);
 }
@@ -2059,6 +2065,24 @@ function fmt(n) {
   if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
   return String(n);
 }
+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("");
+  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)
+    );
+  }
+  const t = usage.totals;
+  info(c.dim("    " + "\u2500".repeat(nameW + 45)));
+  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)
+  );
+  info(c.dim(`    avg success across commands: ${usage.avgSuccessPct}%`));
+}
 function registerLib(program) {
   const cmd = program.command("lib").description("library currency: version-correct, drift-annotated usage docs").argument("[args...]", "a library name, or: add <source> | publish <name> | resolve <name> | refresh").option("--name <name>", "library name for `add`").option("--version <v>", "pin the doc version for `add`/`publish`").option("--online", "(deprecated; network is on by default) allow network for add/refresh URL sources").option("-b, --budget <n>", "trim docs to ~N tokens").option("--readme <path>", "README path for `publish` (default ./README.md)").option("--dts <path>", "TypeScript declaration (.d.ts) path for `publish`").option("--language <lang>", "primary language for `publish`").option("--region <region>", "data-residency region for the hosted catalog (same as scans; default us)").option("--ingest <url>", "hosted catalog/ingest URL override (host extracted; wins over --region)").action(async function(args, opts) {
     const global = readGlobal(this);
@@ -2343,7 +2367,7 @@ var initCommand = new Command("init").description("Initialize vibgrate in a proj
     console.log(chalk7.green("\u2714") + ` Created ${chalk7.bold("vibgrate.config.ts")}`);
   }
   if (opts.baseline) {
-    const { runBaseline } = await import('./baseline-RRO4NNNF.js');
+    const { runBaseline } = await import('./baseline-AMQ7VEB5.js');
     await runBaseline(rootDir);
   }
   console.log("");
@@ -3559,7 +3583,7 @@ function formatText(artifact) {
   lines.push("");
   lines.push("   " + teal2("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u256E") + mint2("\u279C"));
   lines.push("  " + chalk7.dim("\u2524") + teal2("\u2502") + " " + mint2("\u25FC") + "  " + mint2("\u25FC") + " " + teal2("\u2502") + chalk7.dim("\u251C") + "  " + chalk7.bold.white("vibgrate"));
-  lines.push("  " + chalk7.dim("\u2524") + teal2("\u2502") + "  " + chalk7.dim("\u2581\u2581") + "  " + teal2("\u2502") + chalk7.dim("\u251C") + "  " + chalk7.dim(`Drift Intelligence Engine v${VERSION}`));
+  lines.push("  " + chalk7.dim("\u2524") + teal2("\u2502") + "  " + chalk7.dim("\u2581\u2581") + "  " + teal2("\u2502") + chalk7.dim("\u251C") + "  " + chalk7.dim(`Code Intelligence Engine v${VERSION}`));
   lines.push("   " + teal2("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u256F"));
   lines.push("");
   lines.push(...titleBox("Vibgrate Drift Report", teal2));
@@ -4532,11 +4556,23 @@ async function detectPackageManager(cwd) {
   if (await pathExists(path.join(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
-function getInstallCommand(pm, pkg, version, isDev) {
+async function detectWorkspaceRoot(cwd) {
+  if (await pathExists(path.join(cwd, "pnpm-workspace.yaml"))) return true;
+  try {
+    const pkgPath = path.join(cwd, "package.json");
+    const raw = await (await import('fs/promises')).readFile(pkgPath, "utf-8");
+    const pkg = JSON.parse(raw);
+    return pkg.workspaces != null;
+  } catch {
+    return false;
+  }
+}
+function getInstallCommand(pm, pkg, version, isDev, opts = {}) {
   const spec = `${pkg}@${version}`;
+  const ws = opts.workspaceRoot && pm === "pnpm" ? " -w" : "";
   switch (pm) {
     case "pnpm":
-      return isDev ? `pnpm add -D ${spec}` : `pnpm add ${spec}`;
+      return isDev ? `pnpm add${ws} -D ${spec}` : `pnpm add${ws} ${spec}`;
     case "yarn":
       return isDev ? `yarn add --dev ${spec}` : `yarn add ${spec}`;
     case "bun":
@@ -4556,45 +4592,72 @@ async function isDevDependency(cwd) {
     return true;
   }
 }
-var updateCommand = new Command("update").description("Update vibgrate to the latest version").option("--check", "Only check for updates, do not install").option("--pm <manager>", "Package manager to use (npm, pnpm, yarn, bun)").option("--global", "Update global installation").action(async (opts) => {
-  console.log(chalk7.dim(`Current version: ${VERSION}`));
-  console.log(chalk7.dim("Checking npm registry..."));
-  const latest = await fetchLatestVersion();
-  if (!latest) {
-    console.error(chalk7.red("Could not reach the npm registry. Check your network connection."));
-    process.exit(1);
-  }
-  const semver2 = await import('semver');
-  if (!semver2.gt(latest, VERSION)) {
-    console.log(chalk7.green("\u2714") + ` You are on the latest version (${VERSION}).`);
-    return;
-  }
-  console.log(chalk7.yellow(`Update available: ${VERSION} \u2192 ${latest}`));
-  if (opts.check) {
-    console.log(chalk7.dim('Run "vibgrate update" to install.'));
-    return;
-  }
-  const cwd = process.cwd();
-  const globalPm = detectGlobalInstall();
-  const isGlobal = opts.global || globalPm !== null;
-  const pm = opts.pm || (globalPm ?? await detectPackageManager(cwd));
-  let cmd;
-  if (isGlobal) {
-    cmd = getGlobalUpdateCommand(pm, "@vibgrate/cli", latest);
-    console.log(chalk7.dim(`Updating global installation with ${pm}: ${cmd}`));
-  } else {
-    const isDev = await isDevDependency(cwd);
-    cmd = getInstallCommand(pm, "@vibgrate/cli", latest, isDev);
-    console.log(chalk7.dim(`Using ${pm}: ${cmd}`));
-  }
-  try {
-    execSync(cmd, { cwd, stdio: "inherit" });
-    console.log(chalk7.green("\u2714") + ` Updated to @vibgrate/cli@${latest}`);
-  } catch {
-    console.error(chalk7.red(`Update failed. Run manually: ${cmd}`));
-    process.exit(1);
+async function confirmWorkspaceRoot(pm) {
+  if (!(process.stdin.isTTY && process.stdout.isTTY)) return false;
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve16) => {
+    rl.question(chalk7.yellow(`Update the ${pm} workspace root with -w? [y/N]: `), (ans) => {
+      rl.close();
+      const t = ans.trim().toLowerCase();
+      resolve16(t === "y" || t === "yes");
+    });
+  });
+}
+var updateCommand = new Command("update").description("Update vibgrate to the latest version").option("--check", "Only check for updates, do not install").option("--pm <manager>", "Package manager to use (npm, pnpm, yarn, bun)").option("--global", "Update global installation").option("-y, --yes", "Skip confirmation prompts (e.g. installing at a workspace root)").option("-w, --workspace-root", "Allow updating the pnpm workspace root (implies --yes for that prompt)").action(
+  async (opts) => {
+    console.log(chalk7.dim(`Current version: ${VERSION}`));
+    console.log(chalk7.dim("Checking npm registry..."));
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+      console.error(chalk7.red("Could not reach the npm registry. Check your network connection."));
+      process.exit(1);
+    }
+    const semver2 = await import('semver');
+    if (!semver2.gt(latest, VERSION)) {
+      console.log(chalk7.green("\u2714") + ` You are on the latest version (${VERSION}).`);
+      return;
+    }
+    console.log(chalk7.yellow(`Update available: ${VERSION} \u2192 ${latest}`));
+    if (opts.check) {
+      console.log(chalk7.dim('Run "vg update" to install.'));
+      return;
+    }
+    const cwd = process.cwd();
+    const globalPm = detectGlobalInstall();
+    const isGlobal = opts.global || globalPm !== null;
+    const pm = opts.pm || (globalPm ?? await detectPackageManager(cwd));
+    let cmd;
+    if (isGlobal) {
+      cmd = getGlobalUpdateCommand(pm, "@vibgrate/cli", latest);
+      console.log(chalk7.dim(`Updating global installation with ${pm}: ${cmd}`));
+    } else {
+      const isDev = await isDevDependency(cwd);
+      let workspaceRoot = false;
+      if (pm === "pnpm" && await detectWorkspaceRoot(cwd)) {
+        console.log(
+          chalk7.yellow("Detected a pnpm workspace root.") + chalk7.dim(" Installing here needs the -w flag and updates the root package.json.")
+        );
+        const proceed = opts.yes || opts.workspaceRoot || await confirmWorkspaceRoot(pm);
+        if (!proceed) {
+          const rootCmd = getInstallCommand(pm, "@vibgrate/cli", latest, isDev, { workspaceRoot: true });
+          console.log(chalk7.dim(`Skipped. To update the workspace root, run: ${rootCmd}`));
+          console.log(chalk7.dim('or re-run "vg update --yes" (or --workspace-root) to let vg do it.'));
+          return;
+        }
+        workspaceRoot = true;
+      }
+      cmd = getInstallCommand(pm, "@vibgrate/cli", latest, isDev, { workspaceRoot });
+      console.log(chalk7.dim(`Using ${pm}: ${cmd}`));
+    }
+    try {
+      execSync(cmd, { cwd, stdio: "inherit" });
+      console.log(chalk7.green("\u2714") + ` Updated to @vibgrate/cli@${latest}`);
+    } catch {
+      console.error(chalk7.red(`Update failed. Run manually: ${cmd}`));
+      process.exit(1);
+    }
   }
-});
+);
 var OPENVEX_CONTEXT = "https://openvex.dev/ns/v0.2.0";
 var VEX_STATUSES = ["not_affected", "affected", "fixed", "under_investigation"];
 var VEX_JUSTIFICATIONS = [