@vibgrate/cli 2026.703.5 → 2026.704.1

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { resolveDsn, resolveIngestHost, dashHostForIngestHost, availableRegionIds, createWorkspaceDsn, writeStoredCredentials, credentialsPath, findGitRoot, ensureGitignored, gitignoreEntryForCredentials, clearStoredCredentials, inventory, uploadScanArtifact, dsnCommand, pushCommand, ExitCode, CliError, verifyDeterminism, refreshIfStale, driftCount, embeddingsCached, resolveEmbedModel, loadEmbedder, getNodeEmbeddings, queryGraphSemantic, queryGraph, unavailableMessage, countPending, resolveOne, GraphIndex, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, serveStdio, ASSISTANTS, usageError, loadGraph, detectServeLaunch, installAssistant, uninstallAssistant, buildGraph, serializeGraph, coveringTests, FREE_PACK, readScanArtifact, enrichOnline, ECOSYSTEMS, discoverModels, readSavings, exportGraph, catalogPath, libDir, stableStringify, writeArtifacts, writeSnapshot, UsageError, cacheDir, probeFreshness, discover, vibgrateDir, modelCacheInfo, clearModelCache, GraphSource, createServer, assistantById, loadCatalog, driftFor, addLibrary, parseDsn as parseDsn$1, publishPrivateLibrary, resolveLib, libId, resolveVersion, readDoc, localPackageDocs, localApiSurface, assessDocQuality, symbolsFromApi, fetchHostedDocs, selectForBudget, formatForExt, renderHtml, isModelReady } from './chunk-W2QP2YH6.js';
+import { resolveDsn, resolveIngestHost, dashHostForIngestHost, resolveCliInvocation, availableRegionIds, createWorkspaceDsn, writeStoredCredentials, credentialsPath, findGitRoot, ensureGitignored, gitignoreEntryForCredentials, clearStoredCredentials, inventory, uploadScanArtifact, dsnCommand, pushCommand, ExitCode, CliError, NPX_INVOCATION, verifyDeterminism, refreshIfStale, driftCount, embeddingsCached, resolveEmbedModel, loadEmbedder, getNodeEmbeddings, queryGraphSemantic, queryGraph, unavailableMessage, countPending, resolveOne, GraphIndex, shortestPath, renderReport, impactOf, testsToRun, detectRunner, defaultGraphPath, serveStdio, ASSISTANTS, usageError, loadGraph, detectServeLaunch, installAssistant, uninstallAssistant, coveringTests, FREE_PACK, readScanArtifact, enrichOnline, ECOSYSTEMS, discoverModels, readSavings, exportGraph, catalogPath, libDir, stableStringify, buildGraph, writeArtifacts, writeSnapshot, UsageError, ResourceLimitError, 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, renderHtml, isModelReady } from './chunk-YODVLV37.js';
 import { resolvedGrammarFiles, grammarSetVersion } from './chunk-X5YT263H.js';
-import { loadAdvancedScanHook, baselineCommand } from './chunk-6T3R7RF2.js';
-import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, prepareCompressedUpload, titleBox, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, brandProgressBar } from './chunk-L7YBNIBF.js';
+import { loadAdvancedScanHook, baselineCommand } from './chunk-W4ANUENJ.js';
+import { ensureDir, pathExists, writeDefaultConfig, parseDsn, detectVcs, computeRepoFingerprint, resolveRepositoryName, fetchScanPreflight, runCoreScan, VERSION, readJsonFile, writeTextFile, prepareCompressedUpload, titleBox, driftBar, gitHistoryAvailable, buildVersionTimelines, findPackageAnyEcosystem, normalizeConstraint, findVersionCrossings, versionSatisfies, brandProgressBar } from './chunk-RJHYTD62.js';
 import './chunk-RXP66R2E.js';
-import { pathExists as pathExists$1, parseExcludePatterns } from './chunk-4M2MUQRO.js';
+import { pathExists as pathExists$1, parseExcludePatterns } from './chunk-GI6W53LM.js';
 import * as fs4 from 'fs';
 import fs4__default, { realpathSync } from 'fs';
 import * as path9 from 'path';
@@ -156,6 +156,7 @@ async function runBuild(paths, opts, global) {
   } catch (err) {
     bar?.done();
     if (err instanceof UsageError) throw usageError(err.message);
+    if (err instanceof ResourceLimitError) throw new CliError(err.message, ExitCode.ERROR);
     throw err;
   }
   bar?.done();
@@ -192,7 +193,8 @@ async function runBuild(paths, opts, global) {
       scip: result.scip,
       artifacts: written,
       corpusHash: result.graph.provenance.corpusHash,
-      timingMs: result.timing.totalMs
+      timingMs: result.timing.totalMs,
+      warnings: result.warnings
     });
     return;
   }
@@ -1059,52 +1061,103 @@ function escapeRe(s) {
 }
 var PIN = "2020-01-01T00:00:00.000Z";
 function registerBenchmark(program) {
-  const cmd = program.command("benchmark").description("reproducible build + token-reduction benchmark (honest estimates)").option("--budget <n>", "token budget for vg answers", "2000").action(async function(opts) {
+  const cmd = program.command("benchmark").description("reproducible build + memory + token-reduction benchmark (honest estimates)").option("--budget <n>", "token budget for vg answers", "2000").action(async function(opts) {
     const global = readGlobal(this);
     const root = rootOf(global);
     const budget = Number(opts.budget) || 2e3;
-    const t0 = now();
-    const cold = await buildGraph({ root, generatedAt: PIN, noCache: true });
-    const coldMs = now() - t0;
-    const t1 = now();
-    const warm = await buildGraph({ root, generatedAt: PIN });
-    const warmMs = now() - t1;
-    const a = serializeGraph(cold.graph);
-    const b = serializeGraph((await buildGraph({ root, generatedAt: PIN, noCache: true })).graph);
-    const deterministic = a === b;
-    const questions = deriveQuestions(cold.graph);
-    const fileSizes = fileSizeIndex(root);
-    const perQuestion = questions.map((q) => {
-      const vgTokens = queryGraph(cold.graph, q, { budget }).tokensEstimate;
-      const baseTokens = grepBaselineTokens(q, fileSizes);
-      return { question: q, vgTokens, baselineTokens: baseTokens, ratio: baseTokens > 0 ? round(baseTokens / Math.max(vgTokens, 1)) : 1 };
-    });
-    const totalVg = perQuestion.reduce((s, x) => s + x.vgTokens, 0);
-    const totalBase = perQuestion.reduce((s, x) => s + x.baselineTokens, 0);
-    const aggregateRatio = totalVg > 0 ? round(totalBase / totalVg) : 0;
-    const result = {
-      repo: { files: cold.totalFiles, nodes: cold.graph.meta.counts.nodes, edges: cold.graph.meta.counts.edges },
-      build: { coldMs: round(coldMs), incrementalMs: round(warmMs), reusedOnWarm: warm.reused },
-      determinism: { byteIdentical: deterministic },
-      tokenReduction: { questions: perQuestion, aggregateRatio, note: "estimates (~4 chars/token); scales with repo size" }
-    };
+    const result = await runBenchmarkSuite(root, budget);
     if (global.json) {
       json(result);
       return;
     }
-    info(`${c.cyan("vg benchmark")} \xB7 ${result.repo.files} files \xB7 ${result.repo.nodes} nodes`);
-    info(`  build   cold ${result.build.coldMs.toFixed(0)}ms \xB7 incremental ${result.build.incrementalMs.toFixed(0)}ms (reused ${warm.reused})`);
-    info(`  determinism  ${deterministic ? c.green("byte-identical \u2713") : c.red("NON-DETERMINISTIC \u2717")}`);
-    if (perQuestion.length) {
+    const { repo, build, throughput, memory, determinism, tokenReduction } = result;
+    info(`${c.cyan("vg benchmark")} \xB7 ${repo.files} files \xB7 ${repo.nodes} nodes`);
+    info(`  build   cold ${build.coldMs.toFixed(0)}ms \xB7 incremental ${build.incrementalMs.toFixed(0)}ms (reused ${build.reusedOnWarm})`);
+    info(`  speed   ${throughput.filesPerSec.toFixed(0)} files/s \xB7 ${throughput.mbPerSec.toFixed(1)} MB/s (cold, ${mb2(throughput.corpusBytes).toFixed(1)} MB corpus)`);
+    info(
+      `  memory  peak rss ${memory.peakRssMb.toFixed(0)} MB (baseline ${memory.baselineRssMb.toFixed(0)} MB) \xB7 peak heap ${memory.peakHeapMb.toFixed(0)} MB \xB7 graph retains ~${memory.retainedHeapMb.toFixed(0)} MB ${c.dim("(approximate)")}`
+    );
+    info(`  graph   ${mb2(memory.graphJsonBytes).toFixed(1)} MB serialized \xB7 ${memory.bytesPerNode.toFixed(0)} B/node`);
+    info(`  determinism  ${determinism.byteIdentical ? c.green("byte-identical \u2713") : c.red("NON-DETERMINISTIC \u2717")}`);
+    if (tokenReduction.questions.length) {
       info(`  token reduction vs grep/read baseline (${c.dim("estimates")}):`);
-      for (const q of perQuestion) {
+      for (const q of tokenReduction.questions) {
         info(`    ${pad2(`${q.ratio.toFixed(1)}\xD7`, 6)} ${c.dim(`vg ${q.vgTokens} vs ~${q.baselineTokens}`)}  "${q.question}"`);
       }
-      info(`  ${c.bold(`aggregate \u2248 ${aggregateRatio.toFixed(1)}\xD7 fewer tokens`)} ${c.dim("(honest estimate, scales with repo size)")}`);
+      info(`  ${c.bold(`aggregate \u2248 ${tokenReduction.aggregateRatio.toFixed(1)}\xD7 fewer tokens`)} ${c.dim("(honest estimate, scales with repo size)")}`);
     }
   });
   applyGlobalOptions(cmd);
 }
+async function runBenchmarkSuite(root, budget) {
+  const baseline = process.memoryUsage();
+  const sampler = startMemorySampler();
+  const t0 = now();
+  const cold = await buildGraph({ root, generatedAt: PIN, noCache: true });
+  const coldMs = now() - t0;
+  const t1 = now();
+  const warm = await buildGraph({ root, generatedAt: PIN });
+  const warmMs = now() - t1;
+  const a = serializeGraph(cold.graph);
+  const b = serializeGraph((await buildGraph({ root, generatedAt: PIN, noCache: true })).graph);
+  const peak = sampler.stop();
+  const deterministic = a === b;
+  const after = process.memoryUsage();
+  const corpusBytes = cold.fileStats.reduce((s, f) => s + f.size, 0);
+  const graphJsonBytes = Buffer.byteLength(a, "utf8");
+  const nodes = cold.graph.meta.counts.nodes;
+  const questions = deriveQuestions(cold.graph);
+  const fileSizes = fileSizeIndex(root);
+  const perQuestion = questions.map((q) => {
+    const vgTokens = queryGraph(cold.graph, q, { budget }).tokensEstimate;
+    const baseTokens = grepBaselineTokens(q, fileSizes);
+    return { question: q, vgTokens, baselineTokens: baseTokens, ratio: baseTokens > 0 ? round(baseTokens / Math.max(vgTokens, 1)) : 1 };
+  });
+  const totalVg = perQuestion.reduce((s, x) => s + x.vgTokens, 0);
+  const totalBase = perQuestion.reduce((s, x) => s + x.baselineTokens, 0);
+  const aggregateRatio = totalVg > 0 ? round(totalBase / totalVg) : 0;
+  return {
+    repo: { files: cold.totalFiles, nodes, edges: cold.graph.meta.counts.edges },
+    build: { coldMs: round(coldMs), incrementalMs: round(warmMs), reusedOnWarm: warm.reused },
+    throughput: {
+      corpusBytes,
+      filesPerSec: coldMs > 0 ? round(cold.totalFiles / coldMs * 1e3) : 0,
+      // 6-decimal precision: a small corpus at 3 decimals would round to 0.
+      mbPerSec: coldMs > 0 ? round6(mb2(corpusBytes) / coldMs * 1e3) : 0
+    },
+    memory: {
+      baselineRssMb: round(mb2(baseline.rss)),
+      peakRssMb: round(mb2(Math.max(peak.rss, baseline.rss))),
+      peakHeapMb: round(mb2(Math.max(peak.heapUsed, baseline.heapUsed))),
+      // Heap growth across the run ≈ what the loaded graphs + caches retain.
+      retainedHeapMb: round(Math.max(0, mb2(after.heapUsed - baseline.heapUsed))),
+      graphJsonBytes,
+      bytesPerNode: nodes > 0 ? round(graphJsonBytes / nodes) : 0,
+      note: "sampled at 25ms + phase boundaries; GC timing makes these approximate"
+    },
+    limits: resolveLimits(),
+    determinism: { byteIdentical: deterministic },
+    tokenReduction: { questions: perQuestion, aggregateRatio, note: "estimates (~4 chars/token); scales with repo size" }
+  };
+}
+function startMemorySampler() {
+  let rss = 0;
+  let heapUsed = 0;
+  const sample = () => {
+    const m = process.memoryUsage();
+    if (m.rss > rss) rss = m.rss;
+    if (m.heapUsed > heapUsed) heapUsed = m.heapUsed;
+  };
+  const timer = setInterval(sample, 25);
+  timer.unref?.();
+  return {
+    stop: () => {
+      clearInterval(timer);
+      sample();
+      return { rss, heapUsed };
+    }
+  };
+}
 function deriveQuestions(graph) {
   return graph.nodes.filter((n) => n.kind !== "file" && n.kind !== "external").sort((a, b) => b.importance - a.importance || a.qualifiedName.localeCompare(b.qualifiedName)).slice(0, 5).map((n) => n.name);
 }
@@ -1133,12 +1186,18 @@ function safeSize(abs) {
     return 0;
   }
 }
+function mb2(bytes) {
+  return bytes / (1024 * 1024);
+}
 function now() {
   return Number(process.hrtime.bigint() / 1000n) / 1e3;
 }
 function round(x) {
   return Math.round(x * 1e3) / 1e3;
 }
+function round6(x) {
+  return Math.round(x * 1e6) / 1e6;
+}
 function pad2(s, n) {
   return s.padStart(n, " ");
 }
@@ -1882,7 +1941,7 @@ var initCommand = new Command("init").description("Initialize vibgrate in a proj
     console.log(chalk5.green("\u2714") + ` Created ${chalk5.bold("vibgrate.config.ts")}`);
   }
   if (opts.baseline) {
-    const { runBaseline } = await import('./baseline-AQKQEA2O.js');
+    const { runBaseline } = await import('./baseline-FESLZK5O.js');
     await runBaseline(rootDir);
   }
   console.log("");
@@ -1925,7 +1984,9 @@ async function detectAiAssistant(rootDir) {
 function printAiContextPrompt(detectedAssistant) {
   const teal2 = chalk5.hex("#3FB0A4");
   const mint2 = chalk5.hex("#4FE3C1");
-  const installCmd = detectedAssistant ? `vg install ${detectedAssistant}` : "vg install --all";
+  const cli = resolveCliInvocation();
+  const installArgs = detectedAssistant ? `install ${detectedAssistant}` : "install --all";
+  const installCmd = `${cli} ${installArgs}`;
   const detectedNote = detectedAssistant ? chalk5.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"));
@@ -2172,7 +2233,10 @@ var scanCommand = new Command("scan").description("Scan a project for upgrade dr
     projectScanTimeout: opts.projectScanTimeout ? parseInt(opts.projectScanTimeout, 10) || void 0 : void 0,
     repositoryName: opts.repositoryName?.trim() || void 0,
     force: opts.force,
-    quiet: opts.quiet
+    quiet: opts.quiet,
+    // Prefix for the upsell panel's `login → push` hint — `vg` when installed,
+    // `npx @vibgrate/cli` when the user ran via npx (where bare `vg` fails).
+    invocation: resolveCliInvocation()
   };
   const wantGraph = shouldBuildCodeMap({ graph: opts.graph, maxPrivacy: opts.maxPrivacy, noLocalArtifacts });
   if (wantGraph) {
@@ -2984,7 +3048,14 @@ function openUrl(url) {
 
 // src/reporting/commands/login.ts
 var delay = (ms) => new Promise((resolve15) => setTimeout(resolve15, ms));
-var loginCommand = new Command("login").description("Authenticate the CLI with your Vibgrate workspace via the browser").option("--ingest <url>", "Ingest API URL (overrides --region)").option("--region <region>", `Data residency region (${availableRegionIds().join(", ")})`, "us").option("--no-browser", "Do not attempt to open a browser automatically").action(async (opts) => {
+function isInside(dir, file) {
+  const rel2 = path9.relative(dir, file);
+  return !!rel2 && !rel2.startsWith("..") && !path9.isAbsolute(rel2);
+}
+var loginCommand = new Command("login").description("Authenticate the CLI with your Vibgrate workspace via the browser").option("--ingest <url>", "Ingest API URL (overrides --region)").option("--region <region>", `Data residency region (${availableRegionIds().join(", ")})`, "us").option("--no-browser", "Do not attempt to open a browser automatically").option(
+  "--local",
+  "Store credentials in this project (.vibgrate/credentials.json) instead of ~/.vibgrate"
+).action(async (opts) => {
   let ingestHost;
   try {
     ingestHost = resolveIngestHost(opts.region, opts.ingest);
@@ -3073,17 +3144,19 @@ var loginCommand = new Command("login").description("Authenticate the CLI with y
           process.exit(1);
         }
       }
-      writeStoredCredentials(creds);
+      const storeOpts = { local: opts.local === true };
+      writeStoredCredentials(creds, storeOpts);
+      const credsFile = credentialsPath(storeOpts);
       console.log("");
       console.log(chalk5.green("\u2714") + " Logged in.");
       if (creds.workspaceId) {
         console.log("  Workspace: " + chalk5.bold(creds.workspaceId));
       }
-      console.log(chalk5.dim(`  Credentials saved to ${credentialsPath()}`));
+      console.log(chalk5.dim(`  Credentials saved to ${credsFile}`));
       try {
         const root = findGitRoot();
-        if (root) {
-          const res = ensureGitignored(gitignoreEntryForCredentials(root), root);
+        if (root && isInside(root, credsFile)) {
+          const res = ensureGitignored(gitignoreEntryForCredentials(root, credsFile), root);
           if (res.status === "created") {
             console.log(chalk5.dim(`  Created .gitignore and ignored ${res.entry}`));
           } else if (res.status === "added") {
@@ -3092,7 +3165,7 @@ var loginCommand = new Command("login").description("Authenticate the CLI with y
         }
       } catch {
       }
-      console.log(chalk5.dim('  You can now run "vibgrate scan --push".'));
+      console.log(chalk5.dim(`  You can now run "${resolveCliInvocation()} scan --push".`));
       return;
     }
     if (token.status === "access_denied") {
@@ -3650,10 +3723,14 @@ function buildProgram() {
   const program = new Command();
   program.name("vg").description(
     "vg \u2014 local codebase intelligence for AI coding agents: a deterministic, no-API-key code graph + MCP server, drift reporting, and version-correct library docs"
-  ).version(VERSION, "--version", "output the version number").showSuggestionAfterError(true).addHelpText(
-    "after",
-    '\nRun `vg` to scan + map the current folder, `vg "<question>"` to ask, `vg status`/`vg verify` for state.\nDrift: `vg scan` / `vg report`. Wire into your AI agent: `vg install`.\nThe `vibgrate` command is an alias for `vg`.\nDocs: https://vibgrate.com/help'
-  );
+  ).version(VERSION, "--version", "output the version number").showSuggestionAfterError(true).addHelpText("after", () => {
+    const cli = resolveCliInvocation();
+    const aliasNote = cli === "vg" ? "The `vibgrate` command is an alias for `vg`.\n" : cli === NPX_INVOCATION ? "Install globally (`npm i -g @vibgrate/cli`) to use the shorter `vg` command.\n" : "";
+    return `
+Run \`${cli}\` to scan + map the current folder, \`${cli} "<question>"\` to ask, \`${cli} status\`/\`${cli} verify\` for state.
+Drift: \`${cli} scan\` / \`${cli} report\`. Wire into your AI agent: \`${cli} install\`.
+${aliasNote}Docs: https://vibgrate.com/help`;
+  });
   registerBuild(program);
   registerStatus(program);
   registerVerify(program);